1MSG API: Uma Nova Base para Integrações com WhatsApp

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.