API de WhatsApp
API de WhatsApp oficial, simples de verdade
Uma chamada para enviar, um webhook para receber. A Omniplug fica entre o seu sistema e a Meta: cuida da conexão, dos tokens, das filas e das novas tentativas de entrega. A tarifa da Meta vai direto para a Meta, sem acréscimo nosso.
Uma mensagem, uma chamada
Com a chave do seu app e o token do cliente dono do número, o envio é um POST. A resposta volta na hora e a entrega segue em fila, com até 5 tentativas.
curl -X POST https://api.omniplug.com.br/v1/messages \
-H "x-api-key: omp_..." \
-H "x-customer-token: ..." \
-H "content-type: application/json" \
-d '{
"channelAccountId": "b7e1...",
"to": "5511999999999",
"type": "text",
"text": { "body": "Olá, Maria! Seu pedido saiu para entrega." }
}'
Imagem, áudio, vídeo e documento usam a mesma rota, trocando só o type:
{ "type": "image", "image": { "link": "https://sua-loja.com/nota.png", "caption": "Sua nota fiscal" } }
Como funciona a conexão
O seu cliente conecta o próprio número em três passos, sem sair do seu produto e sem configurar nada na Meta.
O cliente abre a página de conexão com o nome e a cara do seu sistema.
Entra com o Facebook da empresa e escolhe qual número conectar.
O número fica ativo e as mensagens começam a chegar no seu webhook.
Oficial da Meta
Conexão pela WhatsApp Business Platform. Sem QR Code, sem celular ligado e sem risco de banimento por API não oficial.
Conexão em uma página
O seu cliente conecta o próprio número numa página com a sua marca. Você troca o code pelo token e pronto: nada de configurar app na Meta para cada cliente.
Webhooks assinados
Mensagens recebidas e status de entrega chegam no seu servidor com assinatura HMAC-SHA256. Também dá para acompanhar em tempo real por SSE.
Templates sem erro de aprovação
A API sincroniza os templates aprovados da conta e confere nome, idioma e parâmetros antes de mandar para a Meta.
Nenhuma mensagem perdida
Se o seu servidor cair, o webhook é reenviado 8 vezes ao longo de cerca de uma hora, e depois ainda dá para reenviar pela API. O envio para a Meta tenta até 5 vezes.
Payloads guardados, se você quiser
Ligue a guarda de dados e conversas, mensagens e contatos ficam consultáveis na API. Desligada, a Omniplug só repassa e guarda um rastro técnico por 7 dias.
Um token por cliente
Uma chave para o seu sistema e um token para cada cliente final. Cada um só enxerga os números e as conversas dele.
Do cadastro à primeira mensagem
- Crie a conta e o app no painel e gere a chave de API
- Crie a sessão de conexão:
POST /v1/connect/sessions - O cliente conecta o WhatsApp na página com a sua marca
- Troque o
codepelo token:POST /v1/connect/exchange - Envie com
POST /v1/messagese receba no seu webhook
Quanto custa
Omniplug
Você paga só pelo uso da nossa infraestrutura: conexão, filas, novas tentativas de entrega e guarda dos dados, se você ligar.
Meta
A tarifa das mensagens é paga direto à Meta, na conta do WhatsApp Business, sem acréscimo nosso. Como a Meta muda a forma de cobrar com frequência, a referência é sempre a tabela oficial.
Ver a tabela de preços da MetaPerguntas sobre a API de WhatsApp
A API é oficial?
Sim. A Omniplug usa a WhatsApp Business Platform, a API oficial da Meta. Nada de QR Code nem de WhatsApp Web por trás, então o número não corre risco de banimento por usar uma conexão não oficial.
Preciso configurar algo na Meta?
O número precisa de uma conta do WhatsApp Business ligada ao Facebook da empresa. A configuração técnica fica com a Omniplug: o seu cliente abre a página de conexão, entra com a conta do Facebook e escolhe o número.
A API do WhatsApp é paga?
A Meta cobra pelas mensagens conforme as regras e a tabela dela, que mudam com frequência. Essa tarifa é paga direto à Meta, na conta do WhatsApp Business. A Omniplug não acrescenta nada a ela: cobra só pelo uso da própria infraestrutura.
Que tipos de mensagem posso enviar?
Texto, imagem, áudio, vídeo, documento e templates aprovados pela Meta, todos pela mesma rota: POST /v1/messages.
Como recebo as mensagens dos clientes?
Por webhook assinado com HMAC-SHA256: cada mensagem recebida chega no seu servidor como message.received e cada mudança de entrega como message.status. Também dá para acompanhar em tempo real por SSE.
E se o meu servidor estiver fora do ar?
A mensagem não se perde. A Omniplug tenta entregar o webhook 8 vezes ao longo de cerca de uma hora e, se ainda falhar, você reenvia a entrega pela API. No envio para a Meta são até 5 tentativas. Com a guarda de dados ligada, os payloads ficam disponíveis para consulta.
Atendo vários clientes com uma integração só?
Sim. O seu sistema usa uma chave de API e cada cliente final recebe um token próprio, que só enxerga os números e as conversas dele.
Pronto para testar? Crie a conta e siga a documentação de conexão. Assistentes de código leem o resumo da API no llms.txt.