API
1MSG API: Uma Nova Base para Integrações com WhatsApp
Concluímos uma das maiores mudanças de backend da história da 1MSG. A 1MSG API agora está em funcionamento em toda a nossa frota de produção — um serviço moderno e tipado, construído com NestJS e TypeScript.
Nikita L ·
Se você já está integrado com 1MSG, nada quebra. Seus endpoints, URLs, tokens e formatos de resposta continuam funcionando como antes. O que mudou está quase totalmente por trás das cenas — e esse é exatamente o ponto.
Por que reconstruímos o backend
Nossa API atendeu bem os clientes, mas a infraestrutura por trás dela estava envelhecendo: JavaScript, contrato e implementação fracamente acoplados, aumentando a complexidade a cada novo tipo de mensagem e caso de borda na produção.
A 1MSG API não é um novo lançamento de produto. É um release da plataforma: a mesma API pública na qual você confia hoje, reconstruída sobre uma base projetada para escalar, evoluir e ser entregue de forma segura.
o que mudou nos bastidores
1. Um substituição completa do núcleo de produção
Nós não corrigimos o serviço antigo — nós o substituímos.
Todo o conjunto de servidores de canal agora opera com imagens de contêiner versionadas, implantadas por meio de rollouts controlados e repetíveis em nosso pipeline de CI/CD.
Trocamos o runtime e o processo de deploy — não é uma refatoração cosmética.
2. Arquitetura orientada a contrato: OpenAPI como a fonte da verdade
A nova pilha é construída com foco no OpenAPI. A especificação da API não é mais uma documentação que persegue o código — ela é o gerador de código.
De um único contrato, geramos:
- Controladores de servidor
- Um SDK TypeScript tipado
- Um servidor MCP para integrações de agente e IDE
A camada de transporte gerada (roteamento, validação, tipos) é claramente separada da lógica de negócios. Um pipeline de geração mantém o servidor, SDK e ferramentas sincronizados quando a API evolui.
3. Migração sem interrupções, mantendo as integrações existentes intactas
A parte mais difícil de uma reescrita de backend não é escrever um novo código — é preservar anos de comportamento no mundo real.
Nós portamos e validamos tudo que os clientes existentes dependem:
- Fluxos de mensagens: texto, mídia, modelos, botões, listas, contatos, localização, reações, carrossel, produtos e WhatsApp Flows
- Webhooks de entrada, atualizações de status, confirmações e encaminhamento de webhook de cliente
- API de Grupos, comportamento de proxy WABA e mais
- Resolução de token a partir de parâmetros de consulta, corpo da solicitação e cabeçalhos Authorization
- Formato de URL original:
https://api.1msg.io/{instanceId}/...?token=... - Paridade da resposta HTTP: códigos de status, corpos de erro, aliases de endpoint e comportamento quando a assinatura está bloqueada
- Tratamento do preflight CORS antes da autenticação
Antes da primeira implantação em produção voltada para o usuário (19 de junho de 2026), realizamos implantações canárias, testes de fumaça e verificações de paridade. O rollout completo da frota foi concluído em 2 de julho de 2026.
O resultado final
Construímos uma nova plataforma, transferimos toda a frota de produção para ela e preservamos total retrocompatibilidade com as integrações existentes.
A 1MSG API é a base para tudo que vem a seguir: mudanças de API mais seguras, melhores ferramentas para desenvolvedores e um backend que podemos evoluir com confiança.