# Webhook із Telegram

{% hint style="success" %}
**Що таке вебхук?**&#x20;

Це сповіщення про подію, яка сталася. Це сповіщення містить значення змінених змінних.
{% endhint %}

## Як отримати вебхук?

Щоб отримати повний вебхук із Telegram, достатньо присвоїти <mark style="color:red;">**будь-яке значення**</mark>**&#x20;змінній** <mark style="color:red;">**:**</mark>

Приклад `save_webhook = 'текстове значення'`

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

Приклад: числове значення змінної

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

Змінна save\_webhook може бути або константою проєкту, або змінною в калькуляторі (приклади вище):

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

У цьому випадку відповідь клієнта на повідомлення бота, яке містить таку змінну, буде записана в змінну Telegram **tg\_request,** яку ви можете знайти в картці клієнта серед змінних транзакції.

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

Клієнт відповів на повідомлення бота з блоку, у якому призначено змінну save\_webhook.

tg\_request і save\_webhook у змінній клієнта

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

## Як отримати посилання на медіафайл за допомогою змінної?

Ви можете використовувати `tg_request` функція для отримання прямого посилання для завантаження відео, зображення або анімації, надісланої користувачем.

**Кроки впровадження:**

1. **Налаштуйте змінну вебхука:**\
   Спочатку присвойте будь-яке значення змінній з назвою `змінній`. Ви можете визначити її як **константу проєкту** або **змінну в блоці Calculator**.
2. **Створіть блок Trigger:**\
   Далі створіть **Тригерний блок**. Цей блок буде відстежувати вхідні медіафайли та використовувати `tg_request` функцію з вашою `змінній` змінною, щоб отримати посилання на файл.

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

* Далі створіть блок для виведення результату.

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

Виконайте ці кроки, щоб отримати пряме посилання на файл із вашого бота:

1. **Перейдіть до вашого підключеного бота Telegram** і почніть чат.
2. **Введіть своє призначене ключове слово** щоб активувати функцію запиту файлу.
3. **Надішліть файл** (зображення, відео тощо), для якого ви хочете отримати посилання для завантаження.

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

Зверніть увагу на останнє file\_id у отриманій відповіді Telegram:

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

Не забувайте, що отримане посилання дійсне лише в межах фреймворку бота, якому ви надіслали файл.


---

# 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/uk/chatbot/mesendzheri/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.
