WABA API

Documentação da integração com WhatsApp Business API via rotas públicas da Sendeasy.

Autenticação

Header obrigatório:

Authorization: Bearer <api_token>

Prefixo de rotas

/api/v1/waba/:whatsappId

Templates

Método	Endpoint	Finalidade
`GET`	`/templates`	Listar templates
`POST`	`/templates`	Criar template
`PUT`	`/templates/:templateId`	Atualizar template
`DELETE`	`/templates/:templateName`	Remover template

Mensagens

Método	Endpoint	Finalidade
`POST`	`/send`	Enviar template (ou texto simples via body específico)
`POST`	`/send-text`	Enviar texto
`POST`	`/send-image`	Enviar imagem
`POST`	`/send-video`	Enviar vídeo
`POST`	`/send-audio`	Enviar áudio
`POST`	`/send-document`	Enviar documento
`POST`	`/marketing-lite/send`	Enviar mensagem marketing (Marketing Messages Lite API)

Nova API: mensagem marketing

Endpoint público:

POST /api/v1/waba/:whatsappId/marketing-lite/send

Endpoint Meta utilizado pelo backend:

POST /{phone-number-id}/marketing_messages

Pré-requisitos:

Conta WABA com onboarding de Marketing Messages Lite concluído.
Termos de Marketing Messages Lite aceitos na conta Meta.
Template de categoria MARKETING com status APPROVED.

Payload

Campo	Tipo	Obrigatório	Observações
`to`	`string`	Sim	número no formato internacional (somente dígitos)
`templateName`	`string`	Sim	nome do template aprovado no Meta
`language`	`string`	Não	padrão: `pt_BR`
`components`	`array`	Não	componentes/parametrizações do template
`productPolicy`	`string`	Não	`CLOUD_API_FALLBACK` (default) ou `STRICT`
`messageActivitySharing`	`boolean`	Não	padrão: `true`
`bizOpaqueCallbackData`	`string`	Não	volta no webhook para correlação de campanha

Exemplo: envio de mensagem marketing

curl --location 'https://server.sendeasy.app/api/v1/waba/SEU_WHATSAPP_ID/marketing-lite/send' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer SEU_API_TOKEN' \
  --data '{
    "to": "5511999999999",
    "templateName": "promo_blackfriday",
    "language": "pt_BR",
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "João" }
        ]
      }
    ],
    "productPolicy": "CLOUD_API_FALLBACK",
    "messageActivitySharing": true,
    "bizOpaqueCallbackData": "campaign_blackfriday_2026"
  }'

Resposta de sucesso (exemplo):

{
  "messages": [
    { "id": "wamid.HBg..." }
  ]
}

Erro de limite/opt-out (exemplo):

{
  "error": "MARKETING_LIMIT_REACHED",
  "message": "User has opted out of marketing messages or reached the limit",
  "details": "..."
}

Exemplo: envio de texto

curl --location 'https://server.sendeasy.app/api/v1/waba/SEU_WHATSAPP_ID/send-text' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer SEU_API_TOKEN' \
  --data '{
    "to": "5511999999999",
    "text": "Olá! Mensagem enviada pela WABA API."
  }'

Exemplo: envio de template

{
  "to": "5511999999999",
  "templateName": "boas_vindas",
  "language": "pt_BR",
  "components": [
    {
      "type": "body",
      "parameters": [
        { "type": "text", "text": "João" }
      ]
    }
  ]
}

Códigos de erro comuns

Código	Quando acontece
`WHATSAPP_NOT_FOUND`	`whatsappId` não existe
`WHATSAPP_CREDENTIALS_MISSING`	canal sem credenciais WABA completas
`MISSING_PARAMETERS`	payload sem campos obrigatórios
`MARKETING_LIMIT_REACHED`	contato deu opt-out ou atingiu limite de marketing
`WHATSAPP_API_ERROR`	erro retornado pela API da Meta

Coleção Postman

A coleção oficial usada internamente:

[SENDEASY] WABA Integration API.postman_collection.json