API v1 · contrato estável

WhatsApp no seu sistema, sem falar Graph API

Um middleware entre o seu ERP, CRM ou SaaS e a Meta. Você manda HTTP; nós cuidamos de token, WABA, janela de 24h, rate limit e retentativa.

  • Especificação OpenAPI
  • Ambientes test e live
  • SLA contratual
curl -X POST https://api.paymebr.com.br/api/v1/messages \
  -H "Authorization: Bearer $PAYMEBR_API_KEY" \
  -H "Idempotency-Key: boleto-98451" \
  -d '{
    "channel_id": "chn_01K0…",
    "to": "5541999999999",
    "type": "text",
    "content": { "text": { "body": "Seu boleto vence amanhã." } },
    "reference": { "external_id": "boleto-98451" }
  }'

# 202 Accepted — aceito e enfileirado.
# O resultado chega no seu webhook:
# message.sent → message.delivered → message.read
O que você ganha

A parte chata da integração já está resolvida

Assinatura de webhook, idempotência, rate limit por credencial, janela de 24h e aprovação de template — tudo isso é nosso problema, não seu.

Credenciais com escopo

12 escopos por chave — peça só o que vai usar. Ambientes test e live são contextos separados, e guardamos apenas o hash SHA-256.

Webhooks assinados

HMAC-SHA256 sobre o corpo bruto, com timestamp para barrar replay. Auditoria de entregas, retentativa com backoff e reenvio manual do que se perdeu.

Idempotência de verdade

Mande Idempotency-Key nas criações. Mesma chave e mesmo corpo devolvem a resposta original; corpo diferente é 409, porque isso é bug, não retry.

Seus IDs, não os nossos

Anexe reference e metadata livres em cada envio; devolvemos intactos em todo evento. Você amarra a mensagem ao seu registro sem guardar ID nosso.

Campanhas com ritmo

Nada de loop no POST /messages. A campanha valida as variáveis por índice antes de gravar, controla a vazão e respeita o tier do seu número.

Erros que dizem o que fazer

RFC 9457 em application/problem+json. 429 e 500 valem retry com backoff; 4xx de validação, não — o payload precisa mudar. Nunca devolvemos stack trace nem token.

Como funciona

Quatro passos até o primeiro envio

O provisionamento é nosso: criamos a organização, a aplicação e a chave, e conectamos a sua conta WhatsApp Business.

  1. 1

    Receba as credenciais

    Criamos tudo e entregamos a chave. Ela é exibida uma única vez — guarde em cofre de segredos.

  2. 2

    Confirme o contexto

    GET /me devolve aplicação, organização e escopos. Respondeu 200, a autenticação está resolvida.

  3. 3

    Cadastre o webhook

    POST /webhook-endpoints com a sua URL HTTPS. Você recebe um segredo whsec_… para validar a assinatura.

  4. 4

    Envie

    POST /messages responde 202 na hora. O ciclo de vida chega no seu webhook.

Planos

Entrada maior, custo por conversa menor

Planos empresariais partem de um mínimo mais alto, mas o preço unitário cai bastante — na ponta do lápis compensa a partir de alguns milhares de conversas por mês.

EscalaMelhor custo por conversa
Para integrar o gateway ao seu ERP, CRM ou SaaS.
R$ 1.290,00/mês

100 mil conversas inclusas · R$ 0,01 por conversa

Excedente a R$ 0,06.

  • Números ilimitados
  • API v1 completa com 12 escopos por credencial
  • Webhooks assinados, com auditoria e replay
  • Idempotência e ambientes test/live separados
  • Especificação OpenAPI para gerar seu cliente
Dedicado
Para volume alto e requisitos de governança.
R$ 3.900,00/mês

500 mil conversas inclusas · R$ 0,01 por conversa

Excedente a R$ 0,04.

  • Tudo do Escala
  • Saldo pré-pago em USD com reserva por campanha
  • Papéis e permissões por equipe
  • Trilha de auditoria e retenção customizada
  • SLA contratual e gerente de conta dedicado

A mensalidade cobre a plataforma. As conversas iniciadas pela empresa têm tarifa própria da Meta, repassada sem margem — conversas iniciadas pelo contato são gratuitas dentro da janela de 24h. Contas empresariais podem operar em pós-pago ou com saldo pré-pago em USD, com reserva por campanha.

Dúvidas

O que costumam perguntar antes de começar

Procurando a versão pronta para usar, sem integração? Veja os planos para uso direto.

Coloque seu WhatsApp para trabalhar ainda hoje

Conecte o número, teste com uma mensagem para você mesmo e veja o bot respondendo. Sem cartão de crédito para começar.