> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-administrador/configuracoes-painel-admin/integracoes/habilitar-webhooks.md).

# 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.

{% hint style="info" %}
**Disponível para o perfil:** Administrador
{% endhint %}

***

### Como acessar a página

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

<figure><img src="/files/8JgtOwSN3LcDnM87H5uO" alt="" width="225"><figcaption></figcaption></figure>

***

### Você verá a seguinte tela

<figure><img src="/files/C37CZk2QyjQrRGUkxZYI" alt=""><figcaption></figcaption></figure>

***

### 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.                                |

{% hint style="warning" %}
**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.
{% endhint %}

***

#### 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.                        |

{% hint style="info" %}
**Dica:** Utilize ferramentas como [n8n](https://n8n.io) ou [Make](https://make.com) para receber, filtrar e automatizar ações com base nos eventos enviados pelo Z-PRO.
{% endhint %}

***

### 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**.

{% hint style="info" %}
Cada toggle é independente — você pode ativar apenas os eventos que interessam à sua integração, sem necessidade de ativar todos.
{% endhint %}

***

### 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](https://requestbin.com) 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**](/configuracao-superadmin/sistema/sistema-dados-e-configuracao/log-de-auditoria.md) para consultar o histórico de eventos enviados e identificar erros ou falhas no disparo. Veja: Log de Auditoria.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.zdg.com.br/configuracao-administrador/configuracoes-painel-admin/integracoes/habilitar-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.