Documentação Técnica
API e Webhook do WHAPRO para integração com sistemas externos, ERPs e automações.
A extensão WHAPRO é obrigatória para a API Oficial funcionar
Para conectar sua conta à API Oficial da Meta e acessar o painel de números, templates e campanhas, você precisa ter a extensão WHAPRO instalada no navegador. Sem a extensão, o painel da API não consegue estabelecer a conexão.
Atenção: o WhatsApp Web (web.whatsapp.com) precisa estar aberto no navegador para acessar o painel da API Meta.
Visão Geral
O WHAPRO oferece uma API RESTful e um sistema de Webhooks para que você integre o WhatsApp aos seus sistemas. Toda comunicação usa JSON sobre HTTPS. O módulo de Webhook oferece eventos como CRM, etiquetas, respostas rápidas, autoatendimento, follow-up, agendamentos e mensagens em geral.
Autenticação
Autentique-se com um Bearer Token gerado no Painel Cliente dentro da extensão. Inclua o token no header de todas as requisições:
curl -X GET https://api.whapro.com.br/api/v1/contacts \ -H "Authorization: Bearer SEU_TOKEN_AQUI" \ -H "Content-Type: application/json"
Endpoints
/api/v1/messagesEnvia uma mensagem via API Oficial ou extensão.
/api/v1/contactsLista contatos com filtros por etiqueta e categoria.
/api/v1/contactsCria ou atualiza um contato no CRM.
/api/v1/dealsLista oportunidades do funil CRM (Kanban).
/api/v1/deals/:idMove um cartão de etapa no funil.
/api/v1/tagsAplica etiquetas a um contato ou conversa.
/api/v1/schedulesCria um agendamento de mensagem ou follow-up.
/api/v1/broadcastsCria um disparo em massa com variáveis e travas antibanimento.
Eventos de Webhook
Configure um endpoint no Painel Cliente para receber os seguintes eventos em tempo real:
message.receivedNova mensagem recebida de um contato.
message.sentMensagem enviada com sucesso.
contact.createdNovo contato criado no CRM.
contact.updatedDados de contato atualizados.
deal.movedCartão movido de etapa no funil CRM.
tag.appliedEtiqueta aplicada a um contato ou conversa.
quick_reply.usedUma resposta rápida foi enviada.
auto_reply.triggeredAutoatendimento (chatbot) foi acionado.
follow_up.scheduledUm follow-up foi programado.
follow_up.sentUm follow-up foi disparado.
schedule.createdUm agendamento foi criado.
schedule.reminderUm lembrete de agendamento foi disparado.
Exemplo: Enviar Mensagem
POST /api/v1/messages
Authorization: Bearer SEU_TOKEN_AQUI
{
"to": "5511999999999",
"body": "Olá {nome}, seu pedido foi enviado!",
"variables": { "nome": "João" },
"channel": "official_api"
}Exemplo: Payload de Webhook
{
"event": "message.received",
"timestamp": "2026-07-04T10:30:00Z",
"data": {
"contact_id": "ctk_abc123",
"phone": "5511999999999",
"body": "Qual o prazo de entrega?",
"tags": ["cliente", "loja-online"]
}
}Pronto para integrar o WhatsApp aos seus sistemas?
Instale grátis e ative a API no Painel Cliente da extensão.
O ecossistema WHAPRO tem 4 soluções: