# Patrocinio Tech: API pública

> Referência para integrar envio de mensagens e templates do WhatsApp, recebimento de respostas e confirmação de entrega por webhook.

Base da API: https://api.patrociniotech.com/public/v1. Autenticação: Bearer, somente no backend. Comece pelo guia de integração com IA; consulte apenas os assuntos necessários. O OpenAPI descreve os campos e rotas públicas. Os exemplos não são credenciais nem dados reais.

Antes de enviar, consulte o catálogo autenticado do seu número: nomes, variáveis e exigências de mídia dependem dos templates aprovados daquela conta. Um aceite de envio não confirma entrega ao destinatário.

Idempotency-Key é opcional no HTTP e recomendado em todo envio automatizado; client_ref não é único por imposição do servidor. Garanta uma operação por mensagem no seu outbox, antes do POST. Em campanhas e bilhetes, failed atrasado não apaga delivered/read e sent atrasado não desfaz failed. Eventos sem vínculo ficam em conciliação, não processados. Leia validacao.md para o roteiro completo.

POST /public/v1/messages mantém a mesma URL e aceita delivery_api: cloud (padrão) ou marketing (somente template MARKETING e conta ativada na Meta). Política STRICT, sem fallback entre rotas. A escolha faz parte da idempotência; não troque rota ou chave para contornar resultado incerto. delivery_api_confirmed diferencia a evidência recebida da Meta da seleção local; null não indica falha. Veja mensagens.md, webhook.md, erros.md e campanhas.md para contrato, configuração e comparação de resultados.

## Começar

- [Visão geral](https://patrociniotech.com/documentacao-api/index.md): Autenticação e primeira consulta.
- [Integrar com IA](https://patrociniotech.com/documentacao-api/ia.md): Instrução copiável, Markdown, OpenAPI e MCP.
- [Números conectados](https://patrociniotech.com/documentacao-api/numeros.md): Remetentes, qualidade e limite compartilhado do portfólio.
- [Conceitos do WhatsApp](https://patrociniotech.com/documentacao-api/conceitos.md): Janela de 24h, template, opt-in, qualidade e capacidade.

## Enviar

- [Janela de 24h](https://patrociniotech.com/documentacao-api/janela.md): Confira se o contato pode receber uma mensagem livre.
- [Mensagens](https://patrociniotech.com/documentacao-api/mensagens.md): Texto, template, Cloud/Marketing API e idempotência.
- [Consentimento](https://patrociniotech.com/documentacao-api/consentimento.md): Consulta em lote, aceite registrado e saída de promoções.
- [Resultados de campanhas](https://patrociniotech.com/documentacao-api/campanhas.md): Aceite, entrega, falhas e destinatários do painel.
- [Templates](https://patrociniotech.com/documentacao-api/templates.md): Aprovação, variáveis e campos de envio.
- [Exemplo completo](https://patrociniotech.com/documentacao-api/exemplo.md): Do envio à confirmação de entrega.

## Receber

- [Webhook](https://patrociniotech.com/documentacao-api/webhook.md): Status de envio, resposta do contato e assinatura.
- [Entregas](https://patrociniotech.com/documentacao-api/entregas.md): Consultar e reenviar eventos do webhook.

## Referência

- [Validar a integração](https://patrociniotech.com/documentacao-api/validacao.md): Operações, conciliação e roteiro de testes Cloud/Marketing.
- [Erros e limites](https://patrociniotech.com/documentacao-api/erros.md): Códigos de erro, limites e novas tentativas.
- [Mudanças da API](https://patrociniotech.com/documentacao-api/mudancas.md): O que mudou e a regra de compatibilidade.

## Contrato

- [OpenAPI JSON](https://patrociniotech.com/documentacao-api/openapi.json): Contrato público gerado pelas rotas do backend; inclui autenticação, validações e respostas.

## MCP

- [MCP de documentação](https://patrociniotech.com/documentacao-api/mcp): Servidor HTTP de leitura pública. Ferramentas search_docs, read_doc e get_openapi. Não precisa de chave e não acessa contas nem envia mensagens.

## Optional

- [Documentação completa em texto](https://patrociniotech.com/documentacao-api/llms-full.txt): Todos os guias, tabelas e exemplos completos em uma consulta. Prefira os arquivos por assunto para economizar contexto.