API
1MSG API: Una nueva base para integraciones de WhatsApp
Hemos completado uno de los cambios de backend más grandes en la historia de 1MSG. La API de 1MSG ahora está funcionando en toda nuestra flota de producción — un servicio moderno y tipado construido sobre NestJS y TypeScript.
Nikita L ·
Si ya estás integrado con 1MSG, nada se rompe. Tus endpoints, URLs, tokens y formatos de respuesta funcionan como antes. Lo que cambió está casi completamente bajo el capó — y ese es exactamente el punto.
Por qué reconstruimos el backend
Nuestra API sirvió bien a los clientes, pero la pila detrás de ella estaba envejeciendo: JavaScript, contrato y implementación débilmente acoplados, y una creciente complejidad con cada nuevo tipo de mensaje y caso extremo de producción.
1MSG API no es un lanzamiento de un nuevo producto. Es un lanzamiento de plataforma: la misma API pública en la que confías hoy, reconstruida sobre una base diseñada para escalar, evolucionar y entregar de manera segura.
¿Qué cambió bajo el capó?
1. Un reemplazo completo del núcleo de producción
No parcheamos el antiguo servicio — lo reemplazamos.
Toda la flota de servidor de canal ahora funciona con imágenes de contenedor versionadas, desplegadas a través de implementaciones controladas y repetibles en nuestro pipeline de CI/CD.
Este es un cambio completo en el tiempo de ejecución y el despliegue — no es una refactorización cosmética.
2. Arquitectura impulsada por contratos: OpenAPI como la fuente de verdad
La nueva pila está construida primero con OpenAPI. La especificación de la API ya no es documentación que persigue al código — es el generador de código.
De un solo contrato generamos:
- Controladores de servidor
- Un SDK de TypeScript tipado
- Un servidor MCP para integraciones de agentes e IDE
La capa de transporte generada (enrutamiento, validación, tipos) está claramente separada de la lógica empresarial. Un pipeline de generación mantiene el servidor, SDK y herramientas en sincronía cuando la API evoluciona.
3. Migración sin inconvenientes sin romper integraciones existentes
La parte más difícil de una reescritura de backend no es escribir nuevo código, sino preservar años de comportamiento en el mundo real.
Portamos y validamos todo lo que los clientes existentes dependen:
- Flujos de mensajes: texto, medios, plantillas, botones, listas, contactos, ubicación, reacciones, carrusel, productos y Flujos de WhatsApp
- Webhook entrantes, actualizaciones de estado, acuses de recibo y reenvío de webhook de cliente
- Grupos API, comportamiento del proxy WABA y más
- Resolución de token desde parámetros de consulta, cuerpo de la solicitud y encabezados de Autorización
- URL original forma:
https://api.1msg.io/{instanceId}/...?token=... - Paridad de respuesta HTTP: códigos de estado, cuerpos de error, alias de puntos finales y comportamiento de suscripción bloqueada
- Manejo de preflight CORS antes de la autenticación
Antes del primer despliegue en producción visible para los usuarios (19 de junio de 2026), realizamos despliegues canarios, pruebas de humo y verificaciones de paridad. El despliegue completo de la flota se completó el 2 de julio de 2026.
La conclusión
Construimos una nueva plataforma, movimos toda la flota de producción a ella y preservamos la compatibilidad total hacia atrás con las integraciones existentes.
1MSG API es la base para todo lo que viene a continuación: cambios de API más seguros, mejores herramientas para desarrolladores y un backend que podemos evolucionar con confianza.