> For the complete documentation index, see [llms.txt](https://digify.gitbook.io/digify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digify.gitbook.io/digify/configuracoes/webhooks.md).

# Webhooks

A área **Webhooks** permite configurar URLs para receber notificações em tempo real sempre que eventos específicos ocorrerem na plataforma, possibilitando integrações com sistemas externos.

Para acessá-la, em **Administração** > **Configurações**, selecione **Webhooks**.

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

Nesta tela, são exibidos todos os webhooks cadastrados, informando o **nome**, a **URL**, os **eventos configurados**, se estão **ativos** e as **ações disponíveis**.

Ao lado de cada webhook, estão disponíveis as seguintes opções:

* **Logs** (ícone de página): exibe o histórico de disparos do webhook;
* **Editar** (ícone de lápis): permite alterar as configurações do webhook;
* **Excluir** (ícone de lixeira): remove o webhook da plataforma.

***

### Como criar um Webhook

Para criar um novo webhook:

1. Em **Administração** > **Configurações**, na área **Webhook**, clique em **+ Novo Webhook**.

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

2. No modal aberto, preencha as seguintes informações:

* **Nome:** informe um nome para identificar o webhook (ex.: Zapier);
* **URL:** informe o endereço que receberá os eventos enviados pela plataforma;
* **Secret (opcional):** informe uma chave de segurança, que será enviada no cabeçalho **`X-Webhook-Secret`** para validar a origem das requisições;
* **Eventos:** selecione os eventos que deverão disparar o webhook.

{% hint style="info" %}
**Importante:** é possível selecionar um ou mais eventos de diferentes módulos da plataforma, de acordo com a necessidade do webhook.
{% endhint %}

<figure><img src="/files/XZ73a3oeq5oKOYtpbwKt" alt="" width="395"><figcaption></figcaption></figure>

3. Após concluir o preenchimento, clique em **Criar**.

Pronto! O webhook será criado e passará a enviar notificações para a URL configurada sempre que ocorrer um dos eventos selecionados.

{% hint style="info" %}
Na tela de **Logs**, é possível consultar o **histórico de envios** realizados pelo webhook, facilitando a validação da integração e a identificação de possíveis falhas.
{% endhint %}