# Webhook de Entrada (universal)

### O que é o Webhook Universal?

O Webhook Universal é uma funcionalidade da Zaia que permite conectar qualquer serviço ou plataforma externa ao seu Agente IA, utilizando a conexão de WhatsApp já configurada na Zaia para disparar mensagens automaticamente.

Na prática, quando um evento acontece em uma plataforma externa — como uma compra na Hotmart, um lead capturado no RD Station, um formulário preenchido, ou qualquer outro gatilho de uma ferramenta de automação como Make ou n8n — a Zaia recebe esse sinal via webhook e envia uma mensagem diretamente para o WhatsApp do usuário, sem precisar de nenhuma integração adicional.

### Para que serve?

O Webhook Universal é ideal para casos de uso como:

* **Recuperação de carrinho abandonado** — notificar o lead via WhatsApp quando ele deixar de finalizar uma compra
* **Confirmação de compra ou acesso** — enviar mensagens automáticas após uma transação ser concluída
* **Nutrição de leads** — disparar mensagens personalizadas a partir de eventos capturados em ferramentas de CRM ou automação
* **Integração com Make, n8n, Zapier** — conectar qualquer fluxo de automação ao WhatsApp via Zaia
* **Qualquer plataforma que suporte envio de webhooks** — Hotmart, Kiwify, Eduzz, HubSpot, e muitas outras

> **Importante:** Para que o disparo funcione, o WhatsApp conectado ao agente precisa estar com a sessão ativa no momento em que o webhook for chamado.

***

### Como configurar o Webhook Universal

#### Passo 1 — Acesse o menu de Webhooks

No menu lateral da plataforma, clique em **Webhooks** e, em seguida, em **Entrada**.

#### Passo 2 — Adicione um novo Webhook

Na tela de Webhooks de Entrada, clique em **"+ Adicionar Webhook"**.

#### Passo 3 — Escolha a ação

No campo **Ação**, selecione o que deverá acontecer quando o webhook for acionado. As opções disponíveis são:

* **Enviar mensagem no WhatsApp** → requer WhatsApp padrão com sessão ativa
* **Enviar mensagem no WhatsApp API Cloud** → requer WhatsApp API Cloud com sessão ativa

#### Passo 4 — Nomeie o Webhook

Preencha o campo **"Nome do Webhook"** com um nome que identifique facilmente a origem ou finalidade desse webhook (ex.: *Webhook Hotmart*, *Carrinho Abandonado*, *Lead RD Station*).

#### Passo 5 — Defina a mensagem

No campo **Mensagem**, escreva o texto que será enviado ao usuário quando o webhook for disparado.

Você pode — e deve — usar **variáveis dinâmicas** com a sintaxe `{{nomeDaVariavel}}` para personalizar a mensagem com os dados recebidos da plataforma de origem. Os nomes das variáveis devem corresponder aos campos enviados pelo serviço externo.

**Exemplo de mensagem com variáveis:**

```
Oi {{buyerName}}! 🌟 Vi que você deixou algo no carrinho da Hotmart. 🛒
O {{productName}} ainda está disponível! Estamos aqui para ajudar.
Se precisar de assistência ou tiver alguma dúvida, é só chamar. 😊 Volte quando puder e aproveite o {{productName}}!
```

#### Passo 6 — Selecione a localização dos usuários

No campo **"Localização dos usuários"**, escolha o país onde a maioria dos seus contatos se encontra. Isso garante que o código de país seja aplicado corretamente ao número recebido via webhook.

#### Passo 7 — Gere o Webhook

Clique em **"Gerar Webhook"**. A URL única do seu webhook será gerada e exibida no campo **"Copie a URL do webhook abaixo"**.

#### Passo 8 — Copie a URL e use na plataforma de origem

Clique em **"Copiar"** para copiar a URL gerada. Cole essa URL no campo de webhook da plataforma externa que irá disparar os eventos (Hotmart, Make, n8n, etc.).

#### Passo 9 — Acompanhe o status na aba de Informações

Após a criação, clique na aba **"2. Informações do Webhook Universal"** para visualizar os detalhes do webhook criado, incluindo:

* **Análise de saúde** — indicador de funcionamento e índice de sucesso dos disparos
* **Nome do Webhook** — o nome definido na criação
* **URL do Webhook** — para copiar novamente se necessário
* **Histórico de eventos** — registro de cada vez que o webhook foi chamado, com status e data
* **Status** — indica se o webhook está **ATIVO** ou **FUNCIONAL**

***

### Gerenciando seu Webhook

Após a criação, você pode gerenciar o webhook diretamente na aba de Informações:

* **Desativar** — use o toggle **"Desativar Webhook"** para pausar o webhook sem excluí-lo. Ele pode ser reativado a qualquer momento.
* **Excluir** — clique no ícone de lixeira para iniciar a exclusão. Uma confirmação será exibida antes de concluir a ação. Atenção: ao deletar, todas as configurações serão perdidas permanentemente.


---

# Agent Instructions: 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://zaiadocs.gitbook.io/recursos/agentes/como-criar-um-agente/habilidades/webhook-universal.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.