Documentação da API
Damos uma API e você constrói em cima. Exemplos em cURL, Node.js, PHP e Python. Os exemplos aqui usam placeholders (wc_live_…, conn_…); dentro do painel eles vêm com os seus dados reais.
Especificação OpenAPI
A API pública (/v1) em um arquivo OpenAPI 3.1: importe no Postman/Insomnia, gere um cliente na sua linguagem, ou entregue a um agente de IA para consumir a API sem ler HTML.
Primeiros passos
Antes de escrever uma linha de código vale saber o que a Meta vai pedir, que é a parte que não depende de nós: um número próprio, uma conta do Facebook com Portfólio Comercial, um cartão na sua conta da Meta e —se você quiser enviar primeiro— um template aprovado. Nada disso tem custo aqui e não é preciso se cadastrar para ler. São seis passos curtos, na ordem em que acontecem de verdade.
Quando você tiver uma conta, o painel diz qual destes seis falta para você, com o estado real do seu número. Começar.
- ① Antes de conectar — o que você vai precisar
- ② Ao conectar
- ③ Os trâmites da Meta, por ordem de urgência
- ④ O que é um template (e por que existe)
- ⑤ Para enviar
- ⑥ O que a Meta cobra e o que o WAIA Connect cobra
Essencial
- Autenticação GET /v1/connections
- Enviar uma mensagem de texto POST /v1/messages
- Enviar mídia (imagem · documento · áudio · vídeo) POST /v1/messages
- Receber mensagens por webhook
- Autenticar o webhook: header estático vs assinatura
- Verificar a assinatura
- Consultar o estado de uma mensagem GET /v1/messages/:id
- Marcar uma mensagem como lida (e mostrar «digitando…») POST /v1/messages/read
- Baixar mídia recebida GET /v1/media/:mediaId
- Receber o histórico de Coexistence GET /v1/connections/:id/history
Completo
- Enviar um template POST /v1/messages
- Enviar um template com um arquivo no cabeçalho POST /v1/messages
- Criar, listar e sincronizar templates POST /v1/templates
- Conexões e o seu estado de saúde GET /v1/connections
- Onboarding hospedado (o seu cliente conecta o número dele) POST /v1/onboarding-links
- Templates propostos pelo seu cliente POST /v1/template-links
- Uso e limites GET /v1/usage
- Os 21 tipos de evento com o seu payload
- O catálogo completo de erros
- Idempotência, novas tentativas e ordem de entrega
Usa n8n? WhatsApp no n8n: o workflow completo de atendimento, grátis.
O seu projeto está no Supabase? Receber WhatsApp no Supabase com uma Edge Function.
Monta o seu bot sobre uma planilha do Google? Conectar o WhatsApp ao Google Sheets (Apps Script, sem programar).
Algo não fecha ou precisa de um plano sob medida? Escreva para hola@waiaconnect.com ou peça um orçamento.