---
title: "Tutorial: Webhook de Entrada"
description: "Na Talkey você pode receber mensagens e iniciar conversas via API utilizando o webhook de entrada do seu canal! Nesse tutorial, vamos mostrar como acessar a URL do webhook, configurar a direção das mensagens recebidas e utilizar os exemplos de…"
url: "https://portal.voorks.ai/docs/tutorial-webhook-de-entrada/"
updated: "2026-03-23"
category: Canais
---

# Tutorial: Webhook de Entrada

Na Talkey você pode receber mensagens e iniciar conversas via API utilizando o webhook de entrada do seu canal! Nesse tutorial, vamos mostrar como acessar a URL do webhook, configurar a direção das mensagens recebidas e utilizar os exemplos de payload disponíveis para integrar sistemas externos ao seu canal.

---

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 **Webhook de entrada**, você encontra a **URL do Webhook Padrão**. Essa é a URL única do seu canal, utilizada para receber mensagens e iniciar conversas via API.

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

3. Utilize os botões ao lado da URL:

- **Regenerar** (ícone de atualização): gera um novo token para a URL. Atenção: ao regenerar, a URL anterior será invalidada permanentemente.
- **Copiar** (ícone de cópia): copia a URL para a área de transferência.

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

4. Configure como as mensagens recebidas serão tratadas usando o seletor **Receber mensagem como**:

- **Usuário**: a mensagem será registrada como se fosse enviada por um atendente/usuário.
- **Cliente**: a mensagem será registrada como se fosse enviada por um cliente.

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

5. Na seção **Exemplos de Payload**, você encontra modelos prontos para cada tipo de envio. Clique nas abas para alternar entre os exemplos:

- **Texto**: envia uma mensagem de texto simples.
  {
  "number": "5511999999999",
  "name": "Client Name",
  "text": "Test message"
  }
- **Mídia**: envia um arquivo de mídia (imagem, vídeo, áudio, documento) com legenda opcional.
  {
  "number": "5511999999999",
  "name": "Client Name",
  "media": "https://example.com/image.png",
  "caption": "Image caption"
  }
- **Template**: envia um template aprovado do WhatsApp Business sem variáveis.
  {
  "number": "5511999999999",
  "name": "Client Name",
  "template": "template_name"
  }
- **Template c/ Args**: envia um template com variáveis preenchidas.
  {
  "number": "5511999999999",
  "name": "Client Name",
  "template": "verification_code",
  "args": {
  "1": "Value 1",
  "2": "Value 2",
  "3": "Value 3"
  }
  }
- **Campanha**: envia uma mensagem vinculada a uma campanha.
  {
  "number": "5511999999999",
  "name": "Client Name",
  "template": "template_name",
  "campaign_uuid": "bc82177d-780c-426f-8276-231f6df96538"
  }
- **Campanha c/ Args**: envia uma mensagem de campanha com variáveis preenchidas.
  {
  "number": "5511999999999",
  "name": "Client Name",
  "template": "verification_code",
  "args": {
  "1": "Value 1",
  "2": "Value 2",
  "3": "Value 3"
  },
  "campaign_uuid": "bc82177d-780c-426f-8276-231f6df96538"
  }

Obs: Para canais de e-mail, facebook e instagram, o campo "number" é substituído por "email". Cada exemplo possui um botão **Copiar** para facilitar o uso.

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

---

## Conclusão

Com o webhook de entrada, você consegue receber mensagens e iniciar conversas no seu canal via API de forma simples. Basta copiar a URL, escolher o tipo de payload adequado e enviar uma requisição POST para integrar qualquer sistema externo ao seu canal da Talkey!