Documentação da API

Duas coisas: o seu sistema manda mensagem pelo seu número de WhatsApp, e recebe de volta o que aconteceu com ela. HTTP e JSON, sem SDK para instalar.

Base: https://api.patrociniotech.com

Conceitos do WhatsAppJanela de 24h, template, opt-in, qualidade e limite diário.MensagensTexto, template, variáveis e idempotência.Webhook de statusFormato do evento e verificação da assinatura.EntregasConsultar a fila e reenviar pelo seu sistema.Erros e limitesTodos os códigos e o que fazer em cada um.

Autenticação (link para esta seção)

Toda chamada leva a chave no header Authorization. A chave é criada no painel, em Integrações, e aparece inteira uma única vez: guarde na hora, porque depois só mostramos o começo dela.

header
Authorization: Bearer ptk_live_...
A chave vale para a conta inteira e envia mensagem em nome dela. Trate como senha de banco: variável de ambiente no servidor, nunca no código do site nem dentro do aplicativo. Se vazar, revogue no painel e crie outra, que a antiga para de valer na hora.

Primeira chamada (link para esta seção)

Se o contato falou com você nas últimas 24 horas, dá para mandar texto livre. Fora dessa janela, a Meta só aceita template aprovado (veja Mensagens).

curl
curl -X POST https://api.patrociniotech.com/public/v1/messages \
  -H "Authorization: Bearer ptk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5521999999999",
    "text": "Seu pedido saiu para entrega.",
    "client_ref": "pedido-8421"
  }'

Formato das respostas (link para esta seção)

Sucesso e erro têm sempre a mesma forma. Olhe o campo success antes de qualquer outra coisa, e trate o erro pelo code, nunca pela message: a frase é para humano e pode mudar; o código é contrato.

sucesso e erro
{ "success": true,  "data": { ... } }

{ "success": false, "error": { "code": "outside_24h_window", "message": "..." } }

Especificação OpenAPI (link para esta seção)

O contrato legível por máquina, só das rotas públicas. Importe no Postman ou no Insomnia, gere um cliente na sua linguagem, ou abra no visualizador de API que você já usa. Esta página explica o porquê; a especificação entrega a forma exata dos campos.

url
https://api.patrociniotech.com/public/v1/openapi.json
A autenticação já vem declarada nela, então o botão de testar do seu visualizador manda o header certo sozinho: é só colar a sua chave.

Ambiente e versão (link para esta seção)

ItemValor
Basehttps://api.patrociniotech.com
VersãoEstá no caminho (/public/v1/). Mudança que quebre contrato vira /v2, e a v1 continua no ar.
FormatoJSON na entrada e na saída. Use Content-Type: application/json.
FusoToda data em UTC, no formato ISO 8601 com Z no fim.
Limite600 requisições por minuto por chave. Ver Erros e limites.