Habilitar Webhooks
Disponível para o perfil: Administrador.
Configure URLs de webhook para integrar o Mediar Conversas com ferramentas externas como n8n, Make e outros sistemas, recebendo notificações automáticas sempre que eventos relevantes ocorrerem na plataforma.
Como acessar a página
No painel administrativo, acesse Configurações > Integrações > Webhooks.
Detalhamento da página
A tela de Webhooks é dividida em duas seções principais: Webhook principal e Eventos de canal e usuário.
Webhook principal
Controla o envio dos eventos gerais do sistema para uma URL centralizada.
| Campo / Opção | Descrição |
|---|---|
| Ativar webhook | Liga ou desliga o envio de eventos. Quando desativado, nenhuma requisição é enviada, mesmo com URL configurada |
| URL do Webhook | Endereço público que receberá as requisições POST com os dados dos eventos. Obrigatório quando o webhook está ativo |
| Webhook mensagens | Quando ativo, envia eventos de novas mensagens e atendimentos para a URL configurada |
Atenção: a URL informada precisa ser pública, acessível externamente, aceitar requisições POST e utilizar protocolo HTTPS. URLs locais (ex.: localhost) não funcionarão.
Eventos de canal e usuário
Permite ativar webhooks granulares para eventos específicos de criação e atualização de canais, usuários e APIs.
| Evento | Descrição |
|---|---|
| Webhook criar canal | Dispara quando um novo canal (sessão/conexão) é criado no sistema |
| Webhook atualizar canal | Dispara quando as configurações de um canal existente são alteradas |
| Webhook criar usuário | Dispara quando um novo usuário é cadastrado na plataforma |
| Webhook atualizar usuário | Dispara quando os dados de um usuário são atualizados |
| Webhook criar API | Dispara quando uma nova chave de API é gerada |
| Webhook atualizar API | Dispara quando uma chave de API existente é modificada |
| Webhook renovar API | Dispara quando o token de uma API é renovado |
Dica: utilize ferramentas como n8n ou Make para receber, filtrar e automatizar ações com base nos eventos enviados pelo Mediar Conversas.
Como configurar o webhook principal
- Acesse Configurações > Integrações > Webhooks.
- Ative o toggle Ativar webhook.
- Informe a URL do Webhook, o endereço que receberá os eventos.
- Se quiser receber eventos de mensagens, ative também o toggle Webhook mensagens.
- Clique em Salvar.
Como ativar eventos de canal e usuário
- Na mesma tela, role até a seção Eventos de canal e usuário.
- Ative os toggles dos eventos que deseja monitorar.
- Clique em Salvar.
Cada toggle é independente, você pode ativar apenas os eventos que interessam à sua integração, sem necessidade de ativar todos.
Solução de problemas
Os eventos não estão chegando na minha URL
Causa: a URL pode estar inacessível externamente, sem HTTPS ou com firewall bloqueando requisições de entrada.
Solução: use um serviço de teste (como RequestBin) para gerar uma URL temporária e confirmar se os eventos estão sendo disparados pelo Mediar Conversas antes de apontar para a URL definitiva.
Como verificar se o webhook está disparando corretamente
Solução: acesse Configuração → Log de Auditoria para consultar o histórico de eventos enviados e identificar erros ou falhas no disparo.
Não encontrou o que precisava?
Falar no WhatsApp