omniplug

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.

Fluxo de conexão em três passos: a página de conexão da Omniplug com a marca do seu sistema e o botão Continuar com o Facebook, o cadastro incorporado da Meta e o celular com o WhatsApp conectado já conversando
1. Sua marca

O cliente abre a página de conexão com o nome e a cara do seu sistema.

2. Conta na Meta

Entra com o Facebook da empresa e escolhe qual número conectar.

3. Conectado

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

  1. Crie a conta e o app no painel e gere a chave de API
  2. Crie a sessão de conexão: POST /v1/connect/sessions
  3. O cliente conecta o WhatsApp na página com a sua marca
  4. Troque o code pelo token: POST /v1/connect/exchange
  5. Envie com POST /v1/messages e 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 Meta

Perguntas 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.