# Webhook do Telegram

{% hint style="success" %}
**O que é um webhook?** 

Esta é uma notificação sobre um evento que ocorreu. Esta notificação contém os valores das variáveis alteradas.
{% endhint %}

## Como obter um webhook?

Para obter um webhook completo do Telegram, basta atribuir <mark style="color:vermelho;">**qualquer valor à**</mark>**&#x20;save\_webhook** <mark style="color:vermelho;">**variável:**</mark>

Exemplo `save_webhook = 'valor de texto'`

<div data-with-frame="true"><figure><img src="/files/14048cf1ae46f037c98751230ce538ab0dda07d2" alt="" width="563"><figcaption></figcaption></figure></div>

Exemplo: valor numérico da variável

<div data-with-frame="true"><figure><img src="/files/e0788b31f6796d1ca0325e837fb38e389ad22432" alt="" width="563"><figcaption></figcaption></figure></div>

A variável save\_webhook pode ser tanto uma constante do projeto quanto uma variável na calculadora (exemplos acima):

<div data-with-frame="true"><figure><img src="/files/9f21b792595fef16bab7f0651bb1bfcea43be0c6" alt="" width="563"><figcaption></figcaption></figure></div>

Nesse caso, a resposta do cliente à mensagem do bot, que contém essa variável, será registrada na variável do Telegram **tg\_request,** que você pode encontrar no cartão do cliente entre as variáveis da transação.

<div data-with-frame="true"><figure><img src="/files/8a2ea36ed2bb5d5cd593887de423b6ca1c15fde0" alt="" width="375"><figcaption></figcaption></figure></div>

O cliente respondeu à mensagem do bot do bloco no qual a variável save\_webhook está atribuída.

tg\_request e save\_webhook na variável do cliente

<div data-with-frame="true"><figure><img src="/files/05eafbb0ac3799858b8654120f49eacad4688140" alt="" width="563"><figcaption></figcaption></figure></div>

## Como obter um link de mídia usando uma variável?

Você pode usar a `tg_request` função para obter um link direto de download para um vídeo, imagem ou animação enviados por um usuário.

**Etapas de implementação:**

1. **Configure a variável webhook:**\
   Primeiro, atribua qualquer valor a uma variável chamada `save_webhook`. Você pode definir isso como uma **constante do projeto** ou uma **variável dentro de um bloco Calculadora**.
2. **Crie o bloco Trigger:**\
   Em seguida, crie um **Bloco de gatilho**. Esse bloco escutará mídias recebidas e usará a `tg_request` função com sua `save_webhook` variável para capturar o link do arquivo.

<div data-with-frame="true"><figure><img src="/files/37d11fe2474fddb02563d4be1a5a0d66ed03bcef" alt="" width="563"><figcaption></figcaption></figure></div>

* Em seguida, crie um bloco para exibir o resultado.

<div data-with-frame="true"><figure><img src="/files/68e2335e3d71cd275b3bc909531964663d49d8dd" alt="" width="563"><figcaption></figcaption></figure></div>

Siga estas etapas para obter um link direto para um arquivo do seu bot:

1. **Acesse seu bot do Telegram conectado** e inicie uma conversa.
2. **Digite sua palavra-chave designada** para ativar a função de solicitação de arquivo.
3. **Envie o arquivo** (imagem, vídeo etc.) para o qual você deseja receber o link para download.

<div data-with-frame="true"><figure><img src="/files/092d0e3d8f68a39337e79a7c90e18f8f02355c8b" alt="" width="563"><figcaption></figcaption></figure></div>

Preste atenção ao último file\_id na resposta do Telegram recebida:

<div data-with-frame="true"><figure><img src="/files/2cc949db96c1a49f5a277cdd791bf835dec868b3" alt=""><figcaption></figcaption></figure></div>

Não se esqueça de que o link recebido é válido apenas dentro da estrutura do bot para a qual você enviou o arquivo.


---

# 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://docs.mavibot.ai/doc/pt/chatbot/mensageiros/telegram/webhook.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.