NODAPI

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_id nem waba_id: a NOD usa os da conexão.
  • Autenticação: token ou Authorization: Bearer com a chave da conexão oficial. A chave de uma conexão não oficial recebe 404 NOT_ALLOWED aqui.
  • Os POST exigem Content-Type: application/json e um objeto JSON. As chaves de topo method, access_token, batch e appsecret_proof são recusadas.
  • Qualquer outro caminho em /meta/* responde 404 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

POST/meta/messages
  • Conta 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.

Cole a chave gerada no painel.

API oficial

Listar templates

GET/meta/message_templates
  • O parâmetro fields só 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

NomeOndeDescrição
limitqueryFiltro ou paginação da Graph (`limit`).
afterqueryFiltro ou paginação da Graph (`after`).
beforequeryFiltro ou paginação da Graph (`before`).
fieldsqueryFiltro ou paginação da Graph (`fields`).
namequeryFiltro ou paginação da Graph (`name`).
statusqueryFiltro ou paginação da Graph (`status`).
categoryqueryFiltro ou paginação da Graph (`category`).
languagequeryFiltro ou paginação da Graph (`language`).
contentqueryFiltro ou paginação da Graph (`content`).
name_or_contentqueryFiltro ou paginação da Graph (`name_or_content`).
quality_scorequeryFiltro ou paginação da Graph (`quality_score`).
summaryqueryFiltro 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.

Cole a chave gerada no painel.
Ex.: limit=valor

API oficial

Criar template

POST/meta/message_templates
  • Limite 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.

Cole a chave gerada no painel.

API oficial

Dados do número

GET/meta/phone_number

Autenticaçã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.

Cole a chave gerada no painel.
Ex.: chave=valor&outra=valor