> For the complete documentation index, see [llms.txt](https://zaiadocs.gitbook.io/recursos/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zaiadocs.gitbook.io/recursos/agentes/como-criar-um-agente/habilidades/webhook-universal.md).

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