# Webhook de Telegram

{% hint style="success" %}
**¿Qué es un webhook?**&#x20;

Esta es una notificación sobre un evento que ha ocurrido. Esta notificación contiene los valores de las variables modificadas.
{% endhint %}

## ¿Cómo obtener un webhook?

Para obtener un webhook completo de Telegram, basta con asignar <mark style="color:rojo;">**cualquier valor a la**</mark>**&#x20;save\_webhook** <mark style="color:rojo;">**variable:**</mark>

Ejemplo `save_webhook = 'text value'`

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

Ejemplo: valor de variable numérica

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

La variable save\_webhook puede ser tanto una constante del proyecto como una variable en la calculadora (ejemplos arriba):

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

En este caso, la respuesta del cliente al mensaje del bot, que contiene dicha variable, se registrará en la variable de Telegram **tg\_request,** que puedes encontrar en la ficha del cliente entre las variables de la transacción.

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

El cliente respondió al mensaje del bot desde el bloque en el que se asigna la variable save\_webhook.

tg\_request y save\_webhook en la variable del cliente

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

## ¿Cómo obtener un enlace multimedia usando una variable?

Puedes usar la `tg_request` función para obtener un enlace de descarga directa de un video, imagen o animación enviados por un usuario.

**Pasos de implementación:**

1. **Configura la variable webhook:**\
   Primero, asigna cualquier valor a una variable llamada `save_webhook`. Puedes definir esto como una **constante del proyecto** o una **variable dentro de un bloque Calculadora**.
2. **Crea el bloque Trigger:**\
   A continuación, crea un **Bloque disparador**. Este bloque escuchará los medios entrantes y utilizará la `tg_request` función con tu `save_webhook` variable para capturar el enlace del archivo.

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

* A continuación, crea un bloque para mostrar el resultado.

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

Sigue estos pasos para obtener un enlace directo a un archivo desde tu bot:

1. **Ve a tu bot de Telegram conectado** e inicia un chat.
2. **Escribe tu palabra clave designada** para activar la función de solicitud de archivo.
3. **Envía el archivo** (imagen, video, etc.) del que quieres recibir el enlace de descarga.

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

Presta atención al último file\_id en la respuesta de Telegram recibida:

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

No olvides que el enlace recibido solo es válido dentro del marco del bot al que enviaste el archivo.


---

# 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/es/chatbot/mensajeros/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.
