---
title: "Tutorial: Webhooks de Saída"
description: "Na Talkey você pode enviar dados automaticamente para sistemas externos quando eventos ocorrerem no seu canal! Nesse tutorial, vamos mostrar como criar, configurar e gerenciar webhooks de saída para integrar seu canal com ferramentas externas como CRMs, ERPs e outros…"
url: "https://portal.voorks.ai/docs/tutorial-webhooks-de-saida/"
updated: "2026-03-23"
category: Canais
---

# Tutorial: Webhooks de Saída

Na Talkey você pode enviar dados automaticamente para sistemas externos quando eventos ocorrerem no seu canal! Nesse tutorial, vamos mostrar como criar, configurar e gerenciar webhooks de saída para integrar seu canal com ferramentas externas como CRMs, ERPs e outros sistemas.

---

1. Na página de detalhes do canal no painel administrativo [https://app.talkey.ai](https://app.talkey.ai), acesse a aba **Webhooks**.

![](https://portal.talkey.ai/wp-content/uploads/2026/03/image-13-1024x383.png)

2. Na seção **Webhooks de Saída**, clique no botão **+ Novo Webhook**.

![](https://portal.talkey.ai/wp-content/uploads/2026/03/image-22-1024x793.png)

3. No modal de criação, primeiro configure os **gatilhos**, os eventos que irão disparar o webhook. Você pode combinar múltiplos gatilhos:

- **Humano**: dispara quando um atendente humano envia uma mensagem.
- **Clientes**: dispara quando um cliente envia uma mensagem.
- **IA**: dispara quando a IA/agente responde automaticamente.

![](https://portal.talkey.ai/wp-content/uploads/2026/03/image-23-1024x717.png)

4. Em seguida, configure o destino do webhook:

- **URL**: informe a URL do sistema externo que receberá os dados.
- **Método HTTP**: selecione o método da requisição (POST, GET, PUT ou DELETE).

![](https://portal.talkey.ai/wp-content/uploads/2026/03/image-24-1024x701.png)

5. Adicione **Headers personalizados** clicando em **Adicionar header**. Configure pares de chave e valor para autenticação ou outros cabeçalhos necessários.

- Exemplo:
  - Chave: Authorization Valor: Bearer seu-token-aqui
  - Chave: Content-Type Valor: application/json

![](https://portal.talkey.ai/wp-content/uploads/2026/03/image-25-1024x644.png)

6. Configure o **Payload** (corpo da requisição) utilizando as variáveis disponíveis no painel lateral:

Variáveis disponíveis:

- {{customer.cell_phone}} — Telefone do cliente
- {{customer.name}} — Nome do cliente
- {{customer.email}} — E-mail do cliente
- {{message.text}} — Texto da mensagem
- {{message.media}} — URL da mídia
- {{message.caption}} — Legenda da mídia
- {{message.created_at}} — Data/hora da mensagem
- {{thread.uuid}} — ID da conversa
- {{message.uuid}} — ID da mensagem
- {{message.format}} — Formato da mensagem

Exemplo de payload:

{
"customer_name": "{{customer.name}}",
"message": "{{message.text}}",
"thread_id": "{{thread.uuid}}",
"timestamp": "{{message.created_at}}"
}

![](https://portal.talkey.ai/wp-content/uploads/2026/03/image-26-1024x635.png)

7. Após salvar, o webhook aparecerá na lista com as seguintes informações:

- **Indicador de status**: verde (ativo) ou vermelho (inativo)
- **Método HTTP**: badge colorido indicando o método (POST, GET, PUT, DELETE)
- **URL de destino**

![](https://portal.talkey.ai/wp-content/uploads/2026/03/image-27-1024x846.png)

8. Para cada webhook, você pode:

- **Copiar a URL** (ícone de cópia)
- **Editar** (ícone de lápis): modificar gatilhos, URL, headers, payload ou ativar/desativar
- **Excluir** (ícone de lixeira): remover permanentemente

Obs: Ao editar um webhook de saída, você pode alterar o **status** entre ativo e inativo para pausar temporariamente o envio sem excluir a configuração.

---

## Conclusão

Com os webhooks de saída, você consegue enviar dados automaticamente do seu canal da Talkey para qualquer sistema externo! Configure os gatilhos para escolher quais eventos disparam o envio, personalize o payload com as variáveis disponíveis e mantenha suas integrações sempre atualizadas em tempo real.