API oficial (Meta)
A conexão oficial usa a Cloud API da Meta. Você chama as rotas /meta/* da NOD API com a chave da conexão, e o corpo e a resposta são os da Meta.
Como funciona
- Você não informa
phone_number_idnemwaba_id: a NOD usa os da conexão. - Autenticação:
tokenouAuthorization: Bearercom a chave da conexão oficial. A chave de uma conexão não oficial recebe404 NOT_ALLOWEDaqui. - Os
POSTexigemContent-Type: application/jsone um objeto JSON. As chaves de topomethod,access_token,batcheappsecret_proofsão recusadas. - Qualquer outro caminho em
/meta/*responde404 NOT_ALLOWED. - O webhook da conexão oficial é configurado no painel, e os eventos chegam no formato da Meta, com a assinatura de Webhooks.
API oficial
Enviar mensagem
/meta/messagesConta no limite de envio da conexão. Ao passar do limite, a resposta é 429.
Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
Envia uma mensagem pelo número oficial da conexão. O corpo e a resposta são os da Cloud API da Meta, sem alteração. Você não informa o id do número: a NOD usa o da conexão.
Exemplos de corpo
Texto simples
{
"messaging_product": "whatsapp",
"to": "5511999999999",
"type": "text",
"text": {
"body": "Olá!"
}
}Respostas
- 200Mensagem aceita pela Meta (corpo da Cloud API).
- 400Corpo inválido ou com chave de topo recusada.
- 415Falta o Content-Type application/json.
- 429Limite de envio da conexão.
- 502Conexão oficial fora do ar ou token da Meta inválido.
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.
API oficial
Listar templates
/meta/message_templatesO parâmetro
fieldssó aceita nomes simples (letras minúsculas,_e vírgula).
Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
Lista os templates da conta do WhatsApp Business (WABA) da conexão. A resposta é a da Graph, com a paginação dela.
Parâmetros
| Nome | Onde | Descrição |
|---|---|---|
| limit | query | Filtro ou paginação da Graph (`limit`). |
| after | query | Filtro ou paginação da Graph (`after`). |
| before | query | Filtro ou paginação da Graph (`before`). |
| fields | query | Filtro ou paginação da Graph (`fields`). |
| name | query | Filtro ou paginação da Graph (`name`). |
| status | query | Filtro ou paginação da Graph (`status`). |
| category | query | Filtro ou paginação da Graph (`category`). |
| language | query | Filtro ou paginação da Graph (`language`). |
| content | query | Filtro ou paginação da Graph (`content`). |
| name_or_content | query | Filtro ou paginação da Graph (`name_or_content`). |
| quality_score | query | Filtro ou paginação da Graph (`quality_score`). |
| summary | query | Filtro ou paginação da Graph (`summary`). |
Respostas
- 200Lista de templates (corpo da Graph).
- 502Conexão oficial fora do ar ou token da Meta inválido.
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.
API oficial
Criar template
/meta/message_templatesLimite de 20 criações por hora por conexão (somando o painel). Passou, volta 429.
Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
Cria um template na conta do WhatsApp Business da conexão. O corpo é o oficial de criação de template da Meta. A Meta analisa o template antes de liberar o uso.
Exemplos de corpo
Template de utilidade
{
"name": "pedido_confirmado",
"language": "pt_BR",
"category": "UTILITY",
"components": [
{
"type": "BODY",
"text": "Seu pedido {{1}} foi confirmado."
}
]
}Respostas
- 200Template criado (corpo da Graph).
- 400Corpo inválido.
- 429Mais de 20 criações na última hora.
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.
API oficial
Dados do número
/meta/phone_numberAutenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
Mostra os dados do número oficial da conexão: nome verificado, número exibido, qualidade, nível de limite de mensagens, status e plataforma. Os campos são fixos.
Respostas
- 200Dados do número (corpo da Graph).
- 502Conexão oficial fora do ar ou token da Meta inválido.
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.