> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xquiz.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook

<img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/xquiz-12076fbf/DabTafNhExNz5i1G/images/webhook.png?fit=max&auto=format&n=DabTafNhExNz5i1G&q=85&s=4127832db7a30178433360769aa8f511" width="1700" height="800" data-path="images/webhook.png" />

A função Webhook permite enviar dados do XQuiz para ferramentas externas de forma automática, assim que o usuário passa por uma etapa específica do funil.
É ideal para integrações com CRMs, automações personalizadas, sistemas próprios, plataformas de analytics, entre outros.

**Como configurar**

* Nome: Defina um nome para identificar seu webhook.

* Token: Código de autenticação (usado por algumas ferramentas para validar o envio).

* Método: Atualmente o único método disponível é o POST, que envia os dados no corpo da requisição.

* URL do Webhook: Endereço para onde as informações serão enviadas.

**Opções avançadas**

* Enviar Eventos: Ative essa opção se quiser enviar dados sobre ações do usuário (como página acessada, clique, etc).

* Enviar Variáveis: Você pode selecionar variáveis personalizadas (como nome, email, resultado, respostas) para serem enviadas no corpo do webhook.

**Conexão no Flow**

Assim como nas outras funções, você precisa conectar um botão ou ação anterior à função Webhook, para que ela seja acionada no momento certo.

**Quando usar**

* Enviar leads para automações personalizadas.

* Integrar com plataformas que não possuem integração direta com o XQuiz.

* Notificar sistemas externos em tempo real sobre ações do usuário.

Além de enviar eventos, a função Webhook permite transmitir variáveis personalizadas que você coleta ao longo do funil, como nome, e-mail, resultado, respostas e outros dados definidos por você.

**O que são variáveis?**

As variáveis são informações que você armazena a partir das interações do usuário.

Exemplos:

* nome

* email

* resultado\_final

* pergunta1\_resposta

Essas variáveis podem ser reutilizadas em outras partes do funil e também enviadas para fora via Webhook.

**Como usar variáveis no Webhook:**

* Crie as variáveis ao longo do funil (usando a função Variável).

* Vá até a função Webhook.

* Selecione as variáveis que deseja incluir no envio.

* O XQuiz vai montar uma requisição POST, contendo as variáveis selecionadas no corpo do envio em formato JSON.

**Exemplo de envio:**

Se você marcar as variáveis nome e email, o Webhook enviará:

* "nome": "Joana",
* "email": "[joana@gmail.com](mailto:joana@gmail.com)"

**Dica extra!**

Você pode usar o botão “Testar Webhook” para verificar se as informações estão sendo enviadas corretamente para o seu endpoint.
