# Configuração de webhooks no encaminhamento de mensagens no Telegram

Language: pt-br
Canonical: <https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram>
Published: 2026-10-27T05:10:26+00:00
Modified: 2026-10-27T05:10:26+00:00

Webhooks são um mecanismo de envio automático de dados entre sites e aplicativos quando determinados eventos ocorrem. Os dados são transmitidos por meio de uma requisição HTTP: um aplicativo os envia pela Internet a um endereço de outro aplicativo definido previamente.

![Envio de uma mensagem do Telegram para outro site ou aplicativo](<https://flowin.click/wp-content/uploads/2026/10/cf-9b39d30d9dc16598f9eeabf7.webp>)

Conteúdo do artigo

- [Possibilidades dos webhooks](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#headline-156-507>)
- [Criação de um webhook](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#headline-160-507>)
- [Configurações dos webhooks](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#headline-181-507>)
- [Ações disponíveis para um webhook](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#headline-194-507>)
- [Perguntas frequentes](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#faq>)

## Possibilidades dos webhooks

No FLOWIN, os webhooks funcionam com encaminhamentos. Eles podem ser acionados quando uma mensagem é criada, editada, excluída ou fixada no chat de origem, assim como quando um botão é pressionado no chat para o qual as mensagens são encaminhadas (destino).

Assim, você pode conectar o FLOWIN a redes sociais, bolsas, planilhas e sistemas de CRM (sistemas de gestão de relacionamento com clientes). Essa conexão é chamada de integração e permite:

- Adicionar automaticamente solicitações do Telegram a um CRM.
- Enviar sinais de negociação do Telegram para uma bolsa para que as operações sejam copiadas automaticamente, ou seja, realizadas de forma automática com base nesses sinais.
- Encaminhar mensagens do Telegram para outras redes sociais.
- Copiar posts e mensagens para o Planilhas Google.
- Configurar respostas automáticas em um bot.

Para cada cenário, é preciso configurar o recebimento dos dados e a ação desejada no site ou aplicativo.

## Criação de um webhook

Vamos testar o webhook no webhook.site, que fornece um endereço para receber dados e exibe as requisições recebidas. Enviaremos a ele o texto de uma nova mensagem do Telegram.

Para isso, é preciso ter um [encaminhamento configurado e funcionando](<https://flowin.click/pt-br/articles/configuracao-do-encaminhamento-de-mensagens-no-telegram>) no FLOWIN.

Para o primeiro teste

Use um chat de teste separado e uma solicitação fictícia. Para a verificação, basta enviar o texto, sem nomes, telefones ou outros dados pessoais.

0. Abra [@flow\_in\_bot](<https://telegram.me/flow_in_bot?start=site_peresylka_telegram_click>), envie o comando ` /start ` e clique em “Painel de controle”.
   
   [![Acesso ao painel de controle pelo @flow\_in\_bot](<https://flowin.click/wp-content/uploads/2026/10/cf-a4a75a74ef7ba0b9f8e9fc28.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-a4a75a74ef7ba0b9f8e9fc28.webp>)
   
   Acesso ao painel de controle pelo @flow\_in\_bot.
1. Abra o [webhook.site](<https://webhook.site/>) em outra aba. Copie o endereço para receber requisições do campo “Your unique URL”.
   
   [![Endereço para receber a requisição de teste](<https://flowin.click/wp-content/uploads/2026/10/cf-b1f528845106425e090a2e4f.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-b1f528845106425e090a2e4f.webp>)
   
   Endereço para receber a requisição de teste.
2. No painel do FLOWIN, abra “Menu” → “Webhooks” e clique em “Criar”.
   
   [![Seção “Webhooks” no menu do FLOWIN](<https://flowin.click/wp-content/uploads/2026/10/cf-e320c505f3765912a50ef5fc.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-e320c505f3765912a50ef5fc.webp>)
   
   Seção “Webhooks” no menu do FLOWIN.
   
   [![Criação do primeiro webhook](<https://flowin.click/wp-content/uploads/2026/10/cf-e8f995aae0788469bc1fe430.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-e8f995aae0788469bc1fe430.webp>)
   
   Criação do primeiro webhook.
3. Cole o endereço copiado no campo superior. No campo “Corpo da requisição”, insira ` {"message":"<message-text>"} ` e clique em “Criar”. Esse é o modelo dos dados enviados: no lugar de ` <message-text> ` o FLOWIN colocará o texto da mensagem, e o destinatário o verá no campo ` message `.
   
   [![Endereço e corpo da requisição de teste](<https://flowin.click/wp-content/uploads/2026/10/cf-77128c407d3af4d42d4cc1cf.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-77128c407d3af4d42d4cc1cf.webp>)
   
   Endereço e corpo da requisição de teste.
4. Clique em “Aplicar” ao lado do webhook criado. Marque o encaminhamento desejado e clique em “Salvar”.
   
   [![Conexão do webhook a um encaminhamento](<https://flowin.click/wp-content/uploads/2026/10/cf-b0c78c40ac9c793b027d27c4.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-b0c78c40ac9c793b027d27c4.webp>)
   
   Conexão do webhook a um encaminhamento.
   
   [![Seleção do encaminhamento para o webhook](<https://flowin.click/wp-content/uploads/2026/10/cf-0dfd65c8a3432e1bc277eda8.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-0dfd65c8a3432e1bc277eda8.webp>)
   
   Seleção do encaminhamento para o webhook.
5. Envie uma mensagem de teste ao chat de origem, por exemplo: “Solicitação nº 1042: preciso de um catálogo de móveis.” Volte ao webhook.site: a primeira requisição recebida será aberta automaticamente. No bloco “Request Content”, o texto da solicitação aparecerá no campo ` message `. Agora, o FLOWIN enviará automaticamente o texto de cada nova mensagem ao endereço indicado antes de encaminhá-la ao chat de destino.
   
   [![Solicitação de teste no chat de origem](<https://flowin.click/wp-content/uploads/2026/10/cf-2e1e0adfb303bceef062b6f5.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-2e1e0adfb303bceef062b6f5.webp>)
   
   Solicitação de teste no chat de origem.
   
   [![Texto da solicitação recebido no webhook.site](<https://flowin.click/wp-content/uploads/2026/10/cf-4d05757a28ff7a6b93482b67.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-4d05757a28ff7a6b93482b67.webp>)
   
   Texto da solicitação recebido no webhook.site.

## Configurações dos webhooks

Vamos examinar as configurações usando o webhook criado como exemplo: como alterá-las e o que significa cada campo.

Onde encontrar as configurações

Para conectar outro site ou aplicativo, consulte a documentação dele. Em geral, as regras para recebimento de dados ficam na seção API, que descreve a interação com outros programas. Ela informa o endereço, o método HTTP e o formato dos dados para preencher os campos abaixo.

### Como alterar as configurações do webhook

1. Na lista “Webhooks”, clique em “Alterar” ao lado do webhook desejado.
   
   [![Abertura das configurações do webhook](<https://flowin.click/wp-content/uploads/2026/10/cf-273edc6915b02ea1889b5bbf.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-273edc6915b02ea1889b5bbf.webp>)
   
   Abertura das configurações do webhook.
2. Altere os campos desejados e clique em “Salvar”.
   
   [![Salvamento das configurações alteradas](<https://flowin.click/wp-content/uploads/2026/10/cf-c890850d950f54451c5536c4.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-c890850d950f54451c5536c4.webp>)
   
   Salvamento das configurações alteradas.
   
   [![Descrição salva nas configurações do webhook](<https://flowin.click/wp-content/uploads/2026/10/cf-f60f458fc65a73422f1871c4.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-f60f458fc65a73422f1871c4.webp>)
   
   Descrição salva nas configurações do webhook.

### Método HTTP

O método HTTP define a ação da requisição: POST envia dados para processamento, GET solicita dados e PUT os substitui. POST é a opção padrão e é adequada ao nosso teste. Para outro site ou aplicativo, selecione o método indicado na documentação dele.

[![Métodos HTTP disponíveis](<https://flowin.click/wp-content/uploads/2026/10/cf-c28468dd93babbdc0b824e7f.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-c28468dd93babbdc0b824e7f.webp>)

Métodos HTTP disponíveis.

### Endereço URL

URL é um endereço na Internet. Aqui, você informa o endereço para receber dados fornecido pelo site ou aplicativo que está sendo conectado. No nosso exemplo, ele foi fornecido pelo webhook.site.

### Corpo da requisição

O corpo da requisição contém os dados enviados em formato JSON: pares de “nome do campo: valor”. O conjunto de campos depende dos requisitos do site ou aplicativo que está sendo conectado.

Metatags são marcadores que o FLOWIN substitui pelos dados da mensagem. Por exemplo, ` <message-text> ` é substituído pelo texto, e ` <author-name> ` pelo nome do autor. A lista de metatags também pode ser aberta pelo link “metatags” abaixo do campo.

Os números de usuários, mensagens, chats e tópicos na lista abaixo são seus identificadores (IDs) no Telegram.

#### Mensagem e autor

- Texto da mensagem: ` <message-text> `.
- Data da mensagem: ` <message-date> `.
- Hora da mensagem: ` <message-time> `.
- Número do autor: ` <author-id> `.
- Nome do autor: ` <author-name> `.
- Nome do autor em um link HTML para o perfil dele: ` <author-name-link> `.
- Nome do autor como hashtag: ` <author-name-tag> `.
- Nome de usuário do autor: ` <author-username> `.

#### Origem

- Texto da mensagem: ` <src-message-text> `.
- Número da mensagem: ` <src-message-id> `.
- Link da mensagem: ` <src-message-link> `.
- Número do chat: ` <src-chat-id> `.
- Nome do chat: ` <src-chat-name> `.
- Nome de usuário do chat: ` <src-chat-username> `.
- Número do tópico: ` <src-topic-id> `.
- Nome do tópico: ` <src-topic-name> `.

#### Destino

- Texto da mensagem: ` <dst-message-text> `.
- Número da mensagem: ` <dst-message-id> `.
- Link da mensagem: ` <dst-message-link> `.
- Número do chat: ` <dst-chat-id> `.
- Nome do chat: ` <dst-chat-name> `.
- Nome de usuário do chat: ` <dst-chat-username> `.
- Número do tópico: ` <dst-topic-id> `.
- Nome do tópico: ` <dst-topic-name> `.

O número e o link da mensagem no destino ficam disponíveis após o encaminhamento. Para enviá-los, selecione “Após o envio” no campo [“Gatilho da requisição”](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#trigger>).

#### Clique no botão

- Número do usuário que clicou: ` <clicker-id> `.
- Nome do usuário que clicou: ` <clicker-name> `.
- Dados do botão: ` <clicker-data> `.
- Data do clique: ` <click-date> `.
- Hora do clique: ` <click-time> `.

#### Seleção de texto

- Uma expressão regular define uma regra de busca de texto. Por exemplo, ` <regexp>(short|sell)</regexp> ` insere a primeira correspondência encontrada para ` short ` ou ` sell `.
- Texto aleatório ` <random>1|2|3|4|5</random> ` insere uma das cinco opções. Entre as tags, você pode indicar suas próprias opções, separando-as pelo símbolo ` | `.

### Cabeçalhos da requisição

Os “Cabeçalhos da requisição” contêm informações técnicas para o destinatário. Por exemplo, uma chave de acesso permite verificar quem enviou a requisição. Os cabeçalhos são definidos em formato JSON. Em geral, não é necessário alterar esse campo; os valores necessários são obtidos na documentação do site ou aplicativo que está sendo conectado.

### Gatilho da requisição

O “Gatilho da requisição” define o evento e o momento em que o webhook deve enviar a requisição ao endereço indicado. Você pode selecionar os seguintes eventos:

- “Envio” é a opção padrão. O webhook é acionado ao encaminhar uma nova mensagem.
- “Edição” é acionado ao processar a edição de uma mensagem na origem.
- “Fixação” é acionado ao processar a fixação de uma mensagem na origem.
- “Exclusão” é acionado ao processar a exclusão de uma mensagem na origem.
- “Clique no botão” é acionado por botões de callback no chat de destino. Esse tipo de botão informa ao bot que houve um clique e envia os dados definidos para ele. Um botão comum com link não aciona esse webhook.

[![Eventos que acionam a requisição](<https://flowin.click/wp-content/uploads/2026/10/cf-8e63a6c321135ef2b139876d.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-8e63a6c321135ef2b139876d.webp>)

Eventos que acionam a requisição.

O momento do envio define em qual etapa do encaminhamento a requisição será enviada:

- “Antes do processamento”: a requisição é enviada antes da tradução e do processamento da mensagem por inteligência artificial (IA).
- “Após o processamento”: a requisição é enviada após a [tradução](<https://flowin.click/pt-br/articles/traducao-automatica-de-mensagens-no-telegram>) e o [processamento com IA](<https://flowin.click/pt-br/articles/processamento-de-texto-e-imagens-com-ia-no-telegram>).
- “Após o envio”: a requisição é enviada quando a mensagem já foi enviada ou editada com sucesso no chat de destino.

[![Momento do envio da requisição](<https://flowin.click/wp-content/uploads/2026/10/cf-34b916dc0daf0524a6926561.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-34b916dc0daf0524a6926561.webp>)

Momento do envio da requisição.

Momentos de envio disponíveis

As três opções estão disponíveis para os eventos “Envio” e “Edição”. Para “Fixação”, “Exclusão” e “Clique no botão”, é usado “Antes do processamento”, e não é possível selecionar outro momento.

### Descrição

A “Descrição” serve como comentário para sua conveniência e não afeta o funcionamento do webhook. O campo pode ficar vazio.

## Ações disponíveis para um webhook

Você pode gerenciar os webhooks criados pela lista “Webhooks”:

- “Alterar” abre as configurações principais do webhook.
- “Duplicar”, no menu “Mais”, cria uma cópia das configurações do webhook.
- “Selecionar projeto”, no menu “Mais”, adiciona o webhook a um projeto.
- “Excluir”, no menu “Mais”, exclui o webhook.

[![Ações adicionais para um webhook](<https://flowin.click/wp-content/uploads/2026/10/cf-de4851485146392b71882d57.webp>)](<https://flowin.click/wp-content/uploads/2026/10/cf-de4851485146392b71882d57.webp>)

Ações adicionais para um webhook.

Além disso, cada webhook tem um botão “Encaminhamentos \[N\]”, que abre a seleção dos encaminhamentos aos quais ele se aplica. N representa a quantidade de encaminhamentos selecionados. Se nenhum encaminhamento tiver sido selecionado, aparecerá o botão “Aplicar” no lugar dele.

## Perguntas frequentes

 

**O que é um webhook em palavras simples?**

É uma forma de enviar dados automaticamente a outro aplicativo quando ocorre um determinado evento. Por exemplo, ao encaminhar uma nova mensagem, o FLOWIN envia o texto dela ao endereço que você indicou por meio de uma requisição HTTP. Aqui, quem envia a requisição é o FLOWIN; o método do Telegram ` setWebhook ` configura outro sentido: a entrega de atualizações do Telegram ao programa que opera o bot.

 

**Basta informar o endereço do CRM?**

Não. É necessário usar o endereço para receber dados indicado na documentação do CRM, além do método HTTP, dos campos JSON e dos cabeçalhos adequados, caso sejam exigidos para o acesso. O endereço comum do site do CRM não serve para isso. O FLOWIN envia a requisição, enquanto a criação da solicitação ou outra ação depende de como o CRM processa os dados recebidos. Os valores dos campos estão descritos na seção [“Configurações dos webhooks”](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#headline-181-507>).

 

**Por que o link da mensagem no destino está vazio?**

Antes de uma nova mensagem ser enviada com sucesso, o FLOWIN ainda não tem o número nem o link dela no destino. Para enviar ` <dst-message-id> ` e ` <dst-message-link> ` selecione o evento “Envio” ou “Edição” e o momento “Após o envio” no campo [“Gatilho da requisição”](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#trigger>). O link é gerado para canais e supergrupos. No caso de um chat privado ou de um grupo comum, ` <dst-message-link> ` permanecerá vazio mesmo após o envio.

 

**É possível acionar um webhook clicando em um botão de URL comum?**

Não. Um botão de URL comum abre um link. Para o evento “Clique no botão”, é necessário um botão de callback no chat de destino: ele envia ao bot os dados do clique. Essa diferença está descrita na seção [“Gatilho da requisição”](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#trigger>).

 

**Como verificar se o serviço externo recebeu os dados?**

Envie uma mensagem fictícia e confira a requisição recebida no serviço. No [exemplo com webhook.site](<https://flowin.click/pt-br/articles/configuracao-de-webhooks-no-encaminhamento-de-mensagens-no-telegram#check-webhook>) o texto da solicitação aparece no bloco “Request Content”. O sucesso do encaminhamento no Telegram, por si só, não confirma que o serviço externo recebeu os dados ou executou a ação desejada. Para a verificação, basta usar o texto, sem nomes, telefones ou outros dados pessoais.
