Guia da API do Recadu

O Recadu conecta o WhatsApp da sua empresa como aparelho vinculado, igual ao WhatsApp Web, e o expõe numa API REST com webhooks. O celular continua funcionando normalmente: a equipe segue atendendo pelo app, e o seu sistema envia e recebe pela API.

Por onde começar

1. Primeiros passos: chave de API, primeira instância, primeira mensagem.
2. Instâncias e pareamento: conectar um número, estados, sandbox para testar sem celular.
3. Mensagens: todos os tipos, mídia, status, edição, idempotência.
4. Botões, listas e enquetes: mensagens interativas e as respostas.
5. Webhooks e eventos: receber mensagens e status no seu servidor.
6. Políticas, descadastro e saúde do número: limites contra banimento, SAIR/VOLTAR, nota de saúde e disponibilidade.
7. Erros: o que cada erro significa e o que fazer.

Referência

• Referência interativa (todas as rotas e campos): /docs
• Contrato OpenAPI 3.1: /v1/openapi.json
• Status dos interativos (quais formatos estão funcionando hoje): GET https://api.recadu.com.br/v1/status/interactive, sem chave

Em resumo