Habilitar Webhooks

Configure URLs de webhook para integrar o Z-PRO com ferramentas externas como n8n, Make e outros sistemas, recebendo notificações automáticas sempre que eventos relevantes ocorrerem na plataforma.

Disponível para o perfil: Administrador

---

Como acessar a página

No painel administrativo, acesse Configurações > Integrações > Webhooks.

---

Você verá a seguinte tela

---

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 Z-PRO.

---

Como configurar o webhook principal

1. Acesse Configurações > Integrações > Webhooks.

2. Ative o toggle Ativar webhook.

3. Informe a URL do Webhook — o endereço que receberá os eventos.

4. Se quiser receber eventos de mensagens, ative também o toggle Webhook mensagens.

5. Clique em Salvar.

---

Como ativar eventos de canal e usuário

1. Na mesma tela, role até a seção Eventos de canal e usuário.

2. Ative os toggles dos eventos que deseja monitorar.

3. 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 o RequestBin para gerar uma URL temporária de teste e confirmar se os eventos estão sendo disparados pelo Z-PRO 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. Veja: Log de Auditoria.

---