Como a API funciona
REST sobre HTTPS
Todos os endpoints seguem o padrão REST. Verbos HTTP representam ações:
GET lê, POST cria, PATCH atualiza, DELETE remove.JSON em tudo
Corpo das requisições e respostas sempre em
application/json. Timestamps em ISO 8601. Valores monetários em centavos.Paginação por cursor
Listas retornam
data[] + meta.next_cursor. Passe o cursor na próxima requisição para avançar páginas — sem offset, sem saltos.Eventos em tempo real
Configure webhooks para receber notificações instantâneas de criação de contatos, movimentação de negócios, mensagens recebidas e mais.
Base URL
Autenticação
Recursos disponíveis
Contatos
CRUD completo, tags, notas e campos personalizados.
Empresas
Vincule contatos a empresas com CRUD e tags.
Negócios
Gerencie negócios em funis, mova entre etapas, marque como ganho/perdido.
Funis de venda
Crie e configure funis com etapas e probabilidades de fechamento.
Conversas
Inbox multi-canal: WhatsApp, Messenger e Instagram.
Mensagens
Envie mensagens de texto, mídia e templates via WhatsApp ou Messenger.
Tarefas
Crie e gerencie atividades da equipe de vendas.
Agentes de IA
Configure, publique e monitore agentes de IA de vendas e suporte.
Disparos
Campanhas de disparo em massa via WhatsApp com segmentação de audiência.
Campos personalizados
Crie campos extras em contatos, empresas e negócios.
Webhooks
Receba eventos em tempo real no seu sistema.
Créditos de mensagem
Saldo, extrato e recarga de créditos para WhatsApp Cloud API.
Formato padrão de resposta
Toda resposta bem-sucedida segue o mesmo padrão:data é um array e meta inclui total, has_more e next_cursor.
Em erros, a resposta tem error.type, error.code e error.message — sempre legível para humanos e tratável por código. Veja a referência de erros.
Próximos passos
Início Rápido
Faça sua primeira requisição em menos de 5 minutos.
Autenticação
Gere uma API Key e entenda os escopos de permissão.
Webhooks
Receba eventos em tempo real sem polling.
Referência completa
Todos os endpoints com exemplos e parâmetros.

