Integre seu sistema ao WhatsApp
Envie pelo número conectado à sua conta e acompanhe a entrega por webhook. Comece com uma consulta e avance para o primeiro envio.
Texto, template, PDF e código de autenticação.
Confira aprovação, variáveis e anexos exigidos.
Valide a assinatura e acompanhe entregue, lida ou falhou.
1. Prepare o acesso (link para esta seção)
Crie uma chave no painel, em Integrações. Copie o valor completo quando ele aparecer e guarde-o em uma variável de ambiente no seu servidor.
| Configuração | Valor |
|---|---|
| Base da API | https://api.patrociniotech.com |
| Autenticação | Authorization: Bearer SUA_CHAVE |
| Corpo de requisições | Content-Type: application/json |
A conta precisa estar ativa ou em avaliação. Contas suspensas ou desativadas não podem usar a API, mesmo com uma chave ainda não revogada.
2. Consulte seus templates (link para esta seção)
Substitua a chave e o ID de um número conectado. Esta consulta lista os modelos aprovados da conta WhatsApp desse número.
curl "https://api.patrociniotech.com/public/v1/templates?phone_number_id=SEU_NUMERO_ID" \
-H "Authorization: Bearer SUA_CHAVE"Para enviar um modelo, confira sendable: true e api_supported: true. A resposta informa as variáveis, o cabeçalho e os botões que você precisa preencher.
3. Envie e acompanhe (link para esta seção)
| Etapa | Como fazer |
|---|---|
| Enviar | Faça POST /public/v1/messages com uma Idempotency-Key por operação e uma referência em client_ref. |
| Registrar o aceite | Guarde message_id, número de envio, referência e chave. HTTP 200 com status: sent confirma o aceite da Meta. |
| Confirmar a entrega | Receba message.status em um webhook assinado. É esse evento que informa entrega, leitura ou falha. |
Veja o fluxo completo de integração para organizar envio, armazenamento e processamento dos eventos.
Como ler uma resposta (link para esta seção)
Verifique o status HTTP e o campo success. Em uma recusa, trate error.code no código da sua aplicação; error.message é a explicação para a pessoa.
{
"success": true,
"data": {
"message_id": "wamid.EXEMPLO",
"status": "sent",
"to": "5521999999999",
"client_ref": "pedido-8421"
}
}Em falha de conexão ou 5xx, preserve o corpo e a chave da operação. Consulte Erros e limites antes de implementar novas tentativas.
Importar a especificação (link para esta seção)
Use este endereço no Postman, Insomnia ou gerador de clientes. O arquivo contém as rotas públicas, os campos de envio e a autenticação Bearer.
https://patrociniotech.com/documentacao-api/openapi.jsonEndereço direto da API
A mesma especificação está disponível no endereço abaixo. Se sua ferramenta não conseguir acessá-lo, use o endereço da documentação acima.
https://api.patrociniotech.com/public/v1/openapi.jsonIntegrar com IA (link para esta seção)
Entregue o endereço abaixo à IA que está implementando sua integração. O índice aponta para versões em Markdown por assunto e para o contrato OpenAPI, sem exigir leitura da interface.
https://patrociniotech.com/documentacao-api/llms.txtAs versões em texto são geradas do mesmo conteúdo destas páginas, incluindo tabelas e exemplos completos. Se preferir consultar tudo de uma vez, use a documentação completa em texto. Nenhuma dessas referências contém sua chave ou o catálogo privado da conta.
Referência rápida (link para esta seção)
| Item | Regra |
|---|---|
| Versão | /public/v1/ |
| Dados | JSON. Datas de eventos em UTC, no formato ISO 8601. |
| Limite da API | 600 requisições por minuto, por chave. Veja limites e novas tentativas. |
| Mudanças | Histórico e compatibilidade da API |