Synergy Connect
Assinar
Como funcionaPreçoPerguntasDocumentaçãoEntrarAssinar o Developer

API oficial do WhatsApp · plano Developer

Você escreve a integração. A infraestrutura do WhatsApp oficial já está no ar.

O mesmo contrato da Cloud API da Meta, com webhooks assinados e com fila, cadastro hospedado dos números dos seus clientes, MCP para agentes de IA e o volume que cresce por número.

Assinar o Developer Ler a documentação

por número/mês + mensagens da Meta (tabela da Meta + tributos), pagas direto na conta da Meta.

Chamada de exemplo, no formato do portal. O número e a conversa são de exemplo.

Antes da primeira mensagem

O WhatsApp oficial cabe numa chamada. O trabalho está em volta dela.

É isso que costuma ir para o backlog antes de o primeiro cliente receber uma mensagem.

Backlog da integração5 de 5 prontas na Synergy

  1. Subir a Cloud API, guardar os tokens e acompanhar as versões da Graph API.

    pronto na Synergy

  2. Montar a fila dos webhooks: responder rápido, tentar de novo, guardar para reprocessar.

    pronto na Synergy

  3. Assinar e conferir cada entrega, com proteção contra reenvio.

    pronto na Synergy

  4. Passar pelas etapas da Meta para operar a API.

    pronto na Synergy

  5. Fazer o onboarding de cada cliente: Embedded Signup, conta do WhatsApp Business, número.

    pronto na Synergy

Na Synergy, as cinco já estão no ar. Você começa pela linha 1 do seu código.

O que a Synergy faz

A API oficial do WhatsApp, com a infraestrutura incluída

Ajudamos quem desenvolve a colocar o WhatsApp oficial no próprio produto e no dos clientes, com o contrato que você já conhece da Meta e a operação em volta pronta.

  • Contrato da Cloud API
  • Webhooks com fila e replay
  • Cadastro hospedado
  • MCP para agentes de IA
  • Preço por número

Na prática

Cada tarefa do backlog, pronta em código

Contrato da Meta

Troque o host e o token

Caminhos, corpos, respostas e códigos de erro de envio e mídia são os da Cloud API da Meta. Texto, mídia, modelos, botões, listas, localização e reações: o corpo da Graph API passa como está. Os modelos também se criam e se aprovam pela API.

Ver no guia
curl
curl -X POST 'https://api.synergyconnect.com.br/v25.0/106540352242922/messages' \
  -H "Authorization: Bearer $SYNERGY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"messaging_product":"whatsapp","to":"5511999999999","type":"text","text":{"body":"Seu pedido saiu para entrega."}}'
A resposta 200 traz o wamid, como na Meta.
Webhooks

Cada evento chega, mesmo quando o seu servidor cai

Os eventos saem no envelope da Meta. Se o seu endpoint falha, o evento entra na fila do número e volta em 10 s, 30 s, 1 min, 5 min, 15 min e depois a cada 30 min, por até 24 h. Com o replay, você reprocessa os eventos guardados: 30 dias de mensagens e 7 dias de status. Saúde e métricas de entrega numa chamada.

Ver no guia
curl
curl -X POST 'https://api.synergyconnect.com.br/v1/webhooks' \
  -H "Authorization: Bearer $SYNERGY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://hooks.example.com/synergy","fields":["messages","statuses"],"instanceIds":null}'
instanceIds: null cobre todos os números, inclusive os que você conectar depois.
Assinatura

Confira a origem de cada entrega

Toda entrega vem com duas assinaturas: X-Hub-Signature-256, a mesma da Meta, para a biblioteca que você já usa, e X-Synergy-Signature, com carimbo de tempo e tolerância de 300 s contra reenvio. O X-Synergy-Delivery-Id é o mesmo em toda retentativa, para você descartar repetidos.

Ver no guia
JavaScript
import { createHmac, timingSafeEqual } from 'node:crypto';

// rawBody: os bytes EXATOS do corpo recebido, antes de qualquer JSON.parse
export function isValidSignature(rawBody, signatureHeader, secret) {
  const expected = 'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex');
  const a = Buffer.from(expected);
  const b = Buffer.from(signatureHeader ?? '');
  return a.length === b.length && timingSafeEqual(a, b);
}
O guia traz a versão com carimbo de tempo, em Node e Python, e um vetor de teste.
Cadastro hospedado

Seu cliente conecta o WhatsApp dele numa página pronta

Você cria uma sessão e manda o cliente para o link. A página mostra o nome da sua plataforma, conduz o cadastro com a Meta, aceita número novo ou o número que ele já usa no app WhatsApp Business, e devolve o cliente para a sua URL. O resultado chega por webhook, com o phone_number_id pronto para enviar. Peça a liberação em Configurações → Desenvolvedor.

Ver no guia
curl
curl -X POST 'https://api.synergyconnect.com.br/v1/onboarding-sessions' \
  -H "Authorization: Bearer $SYNERGY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"redirect_url":"https://app.minha-plataforma.com/whatsapp/ok","state":"e7f2c0d4-9b1e-4c52-8d0a-3f6a1b2c4d5e","mode":"choice","display_name":"Minha Plataforma","external_ref":"tenant_8841"}'
A resposta traz a url da página. O seu external_ref volta no evento synergy_onboarding.
Idempotência e limites

Repita a chamada com segurança

Com o Idempotency-Key, a mesma requisição devolve o mesmo wamid, e a Meta recebe a mensagem uma vez. Cada número envia até 64 mensagens automatizadas por segundo, e todo limite responde 429 com Retry-After. Os erros da Meta voltam como ela mandou.

Ver no guia
curl
curl -X POST 'https://api.synergyconnect.com.br/v25.0/106540352242922/messages' \
  -H "Authorization: Bearer $SYNERGY_API_KEY" \
  -H 'Idempotency-Key: pedido-8841' \
  -H 'Content-Type: application/json' \
  -d '{"messaging_product":"whatsapp","to":"5511999999999","type":"text","text":{"body":"Seu pedido #8841 saiu para entrega."}}'
O id do seu pedido serve de chave. Outra tentativa com a mesma chave devolve o mesmo envio.
Agentes de IA, SDK e n8n

Ligue um agente de IA ao WhatsApp com um endereço

O servidor MCP da Synergy conecta o Claude, o ChatGPT e outros clientes MCP aos seus números. O agente lista os modelos aprovados e envia texto, modelo e mídia, com prévia (dry_run) antes do envio e limites por hora e por dia que você escolhe na autorização. Para o seu código, o SDK em TypeScript; para os seus fluxos, o node do n8n.

  • SDK JavaScript e TypeScriptEm breve
  • Node do n8nEm breve
Ver no guia
MCP · servidor remoto
https://mcp.synergyconnect.com.br/mcp
Servidor remoto: você informa o endereço no cliente e autoriza.

Preço

Você paga pelos números que usa

Developer

Só API
por número/mês

Total da Synergy: Volume da conta:

  • Cada número soma mensagens ao volume da conta
  • API, webhooks, cadastro hospedado e MCP
  • para configurar · suporte por e-mail
  • Histórico guardado por dias
  • Mais volume: pacote recorrente de mensagens por /mês, ou recarga de por no ciclo

Não deu para carregar o preço agora. Você também o vê no checkout, antes de pagar.

Assinar o Developer

Plano mensal. Você ajusta a quantidade de números quando quiser.

Como começar

Da assinatura à primeira chamada

  1. Assine o Developer

    Crie a conta, escolha quantos números quer e pague no checkout.

  2. Conecte o número e gere a chave

    Conecte o seu número pela Meta, ou mande o link do cadastro hospedado para o seu cliente. Cadastre o cartão na Meta para as mensagens. Depois, em Configurações → API e webhooks, crie a chave com os escopos e os números que ela alcança.

  3. Faça a primeira chamada

    Envie a mensagem com o curl do início rápido e cadastre o webhook para receber as respostas.

A gente conecta o número com você pelo WhatsApp (44) 9157-8985, de segunda a sexta, das 8h às 18h.

Assinar o Developer

Perguntas

Perguntas de quem vai integrar

Preciso reescrever a integração que já fiz para a Cloud API da Meta?

Para envio e mídia, troque o host para api.synergyconnect.com.br e o token pela chave syn_…. Caminhos, corpos, respostas e códigos de erro seguem os da Meta. As rotas /v1/… são extras da Synergy: webhooks, cadastro hospedado e token de Flow.

Quem cobra as mensagens?

A Meta, pela tabela dela + tributos, direto na conta da Meta de quem é dono do número. O cartão fica cadastrado na Meta. A Synergy cobra o plano: por número/mês, com mensagens por número no volume da conta. A Meta dá 1.000 mensagens de serviço grátis por mês em cada número; modelos são cobrados pela categoria desde a primeira.

O que conta no volume da Synergy?

As mensagens enviadas e recebidas no ciclo, somadas na conta. Perto do fim, o app avisa. Para mais volume, há o pacote recorrente e a recarga do ciclo; ao passar do volume, a API responde 429 com o código 1390006 e o link da recarga.

Como meus clientes conectam os números deles?

Pelo cadastro hospedado: o seu backend cria a sessão, o cliente conclui o cadastro com a Meta numa página que mostra o nome da sua plataforma, e o resultado chega por webhook. Cada número conectado ocupa uma vaga do seu plano. O recurso é liberado por organização: peça em Configurações → Desenvolvedor.

O número que o cliente já usa no app WhatsApp Business serve?

Serve. O cadastro hospedado tem o modo de coexistência, e o cliente escolhe na página entre um número novo e o que já usa no app. Trazer o histórico de conversas é uma escolha dele, separada.

Onde fica a tela de atendimento?

No seu produto. O Developer é o plano de API: as mensagens recebidas chegam por webhook, e a interface é a sua. Para uma equipe atender pela Synergy, com Inbox, Flows e leitura de conversas pela API, veja os planos Profissional e Escala.

Quais linguagens e ferramentas eu uso?

Qualquer uma que faça HTTPS: o portal traz exemplos em curl, JavaScript e Python, e a referência OpenAPI 3.1 completa. O SDK em TypeScript (Node, Bun, Deno e Cloudflare Workers) e o node do n8n estão chegando; enquanto isso, o node HTTP Request do n8n chama a mesma API.

Como o agente de IA fica sob controle?

Você escolhe na autorização os números, a permissão de envio e os limites por hora e por dia. O agente mostra a prévia antes de enviar, o modo "só responder" vem ligado, e você revoga a conexão em Configurações → Desenvolvedor, com os últimos 20 envios à vista.

Sua próxima integração começa pela primeira chamada

O contrato da Meta, a fila dos webhooks e o cadastro dos clientes já estão no ar. por número/mês + mensagens da Meta (tabela da Meta + tributos).

Assinar o Developer Ler a documentação