# Чатбот для бізнес-облікового запису Telegram

Тепер ви можете створювати **персональних бізнес-асистентів** — спеціальних ботів, які безпосередньо інтегруються в окремі чати Telegram. Ці боти автоматично обробляють вхідні запити та відповідають від імені власника акаунта, значно зменшуючи час, витрачений на рутинні завдання, і підвищуючи ефективність комунікації.

**Сценарії використання:**\
Цих асистентів можна налаштувати для різних цілей, наприклад:

* Надання консультацій щодо продуктів або послуг.
* Відповіді на поширені запитання.
* Виконання широкого спектра інших автоматизованих завдань.

**Ключова особливість: безперебійне керування**

Користувач може **миттєво повернутися до ручного спілкування** у будь-який момент, не перериваючи і не вимикаючи роботу бота, що забезпечує повний контроль над чатом.

{% hint style="warning" %}
Увага! 

У бізнес-акаунта Telegram є 24-годинне вікно.

Щойно користувач надсилає своє перше повідомлення, бот має **24-годинне вікно** для відповіді та продовження розмови. Це вікно скидається щоразу, коли користувач відповідає.

* **Якщо користувач відповідає:** 24-годинне вікно перезапускається, що дає змогу вести безперервний діалог.
* **Якщо користувач НЕ відповідає протягом 24 годин:** Вікно закривається. Боту буде заблоковано надсилання подальших повідомлень, доки користувач не надішле нове повідомлення для повторного встановлення контакту.
  {% endhint %}

## Підключення бота

Крок 1. Налаштування в **Месенджери** розділ.

1.  **Якщо ви підключаєте Telegram-бота вперше.**

Спочатку перейдіть на вкладку Channels у розділі Mavibot, щоб підключити Telegram-чатбот (якщо його ще немає).

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

Далі ми підключаємо Telegram-бота відповідно до[ інструкцій](/doc/uk/chatbot/mesendzheri/telegram/chatbot.md) .&#x20;

2. **Якщо Telegram уже підключено**.&#x20;

Якщо у вас уже є підключений Telegram-бот, знайдіть цього бота в каналах:

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

Далі натисніть кнопку налаштувань, після чого ви побачите модальне вікно з полями токена тощо:

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

У модальному вікні, що відкриється, натисніть DONE, щоб оновити налаштування вашого Telegram-бота (більше нічого змінювати не потрібно):

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

На цьому етапі роботу з каналами завершено. Перейдіть до налаштувань месенджера.&#x20;

Крок 2. Налаштування месенджера.

Щоб підключити Telegram-чатбота до вашого бізнес-акаунта, перейдіть у налаштування профілю, де потрібно знайти вкладку "Telegram Business":

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

Далі ви побачите вкладку "Chatbots", куди потрібно перейти:

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

Потім у новій вкладці введіть посилання на потрібного Telegram-бота або його ім’я користувача (краще вводити саме посилання).

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

У цій самій вкладці встановіть дозвіл (прапорець "Reply to messages") для відповіді чатбота на повідомлення.

На цьому етапі налаштування чатбота в бізнес-акаунті завершено. Продовжуйте.

Крок 3. Налаштування BotFather.

Після прив’язки чатбота до бізнес-акаунта потрібно оновити налаштування чатбота в BotFather, де ви спочатку створили Telegram-бота.

Для цього відкрийте чат із BotFather і увімкніть для нього роботу з бізнес-акаунтом:

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

Перейдіть до налаштувань бота:

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

Далі натисніть кнопку "Business Mode", щоб увімкнути бізнес-режим для чатбота:

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

{% hint style="success" %}
Готово! Усі необхідні налаштування чатбота з бізнес-акаунтом завершено.
{% endhint %}

Тепер у налаштуваннях каналу ви знайдете Telegram-бота та побачите business ID, а також ім’я власника бізнес-акаунта:

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

### Як вимкнути&#x20;

Щоб вимкнути чатбот із бізнес-режимом, перейдіть до каналів і знайдіть чатбота, для якого потрібно вимкнути це налаштування. Натисніть кнопку налаштувань:

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

Натисніть кнопку "Disable Business Account".

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

{% hint style="success" %}
Якщо ви вимкнете бізнес-акаунт, чатбот продовжить працювати у стандартному режимі.
{% endhint %}

## Доступні функції

1. (API) Функція в калькуляторі:

**tg\_callback(platform\_id , callback\_message,group\_id, tg\_business)**

<details>

<summary><strong>tg_callback</strong></summary>

Параметри:

**! platform\_id** -  Telegram client ID

**! callback\_message** - callback message&#x20;

**group\_id** - Telegram bot ID

**tg\_business -** для роботи з бізнес-клієнтами, має значення "1".

</details>

**tg\_send\_poll(platform\_id, question, options, is\_anonymous, allows\_multiple\_answers, reply\_markup, disable\_notification, protect\_content, token, reply\_to\_message\_id, message\_thread\_id, business\_connection\_id)**

<details>

<summary><strong>tg_send_poll</strong></summary>

Параметри:&#x20;

**! platform\_id** - ідентифікатор чату в Telegram [**\***](/doc/uk/chatbot/mesendzheri/telegram/api.md)

**! question** - запитання

**! options** - масив варіантів відповідей

**is\_anonymous** - 1 - анонімне опитування, '' - неанонімне

**allows\_multiple\_answers** - 1 - дозволено кілька відповідей, '' - лише одна відповідь

**reply\_markup** - клавіатура, або '' - без клавіатури

**disable\_notification** — прапорець для надсилання зі звуковим сповіщенням (за замовчуванням 0); 1 - надсилати без звуку, 0 - надсилати зі сповіщенням

**protect\_content** - 1 - захист від копіювання та скріншотів, '' - без захисту

**token** - токен бота; якщо не вказано, використовується поточний

**reply\_to\_message\_id** -ID цитованого повідомлення

**message\_thread\_id** — ідентифікатор гілки (доступний у супергрупах із функціональністю форуму)

**business\_connection\_id -**&#x437;начення, що використовується під час підключення бота (Business ID, відображається в каналах); слід передавати, якщо вказано токен бота і повідомлення має бути надіслано через акаунт користувача, пов’язаний із ботом

</details>

**tg\_send\_quiz\_poll(platform\_id, question, options, explanation, correct\_option\_id, is\_anonymous, reply\_markup, parse\_mode, protect\_content, disable\_notification, token, reply\_to\_message\_id, message\_thread\_id )**

<details>

<summary><strong>tg_send_quiz_poll</strong></summary>

**! platform\_id** - ідентифікатор чату в Telegram [**\***](/doc/uk/chatbot/mesendzheri/telegram/api.md)

**! question** - запитання

**! options** - масив варіантів відповідей

**! explanation** - текст, який показується, коли користувач обирає неправильну відповідь або натискає на значок лампочки в опитуванні-вікторині; 0–200 символів, не більше двох розривів рядка після розбору сутностей.

**! correct\_option\_id** - номер правильної відповіді, починаючи з 1.

**is\_anonymous** -1 - анонімне опитування, '' - неанонімне

**reply\_markup** -  клавіатура, або '' - без клавіатури

**parse\_mode** - markdown або html для *explanation*, або '' без форматування.

**protect\_content** - 1  захист від копіювання та скріншотів, '' - без захисту.

**disable\_notification** —  прапорець для надсилання зі звуковим сповіщенням (за замовчуванням 0); 1 - надсилати без звуку, 0 - надсилати зі сповіщенням

**token** - токен бота; якщо не вказано, використовується поточний.

**reply\_to\_message\_id** - ID цитованого повідомлення

**message\_thread\_id** — ідентифікатор гілки (доступний у супергрупах із функціональністю форуму)

**open\_period** - час, дозволений для проходження вікторини/тесту; числове значення від 5 до 600, що означає секунди.

**business\_connection\_id -** значення, що використовується під час підключення бота (Business ID, відображається в каналах); слід передавати, якщо вказано токен бота і повідомлення має бути надіслано через акаунт користувача, пов’язаний із ботом

</details>

**tg\_send\_message\_1(token, platform\_id, text, client\_message\_id, reply\_markup, parse\_mode, disable\_web\_page\_preview, protect\_content, disable\_notification, message\_thread\_id, entities, business\_connection\_id)**

<details>

<summary><strong>tg_send_message_1</strong></summary>

Параметри:

**! token** —  токен бота Telegram, отриманий у BotFather

**! platform\_id** — ідентифікатор Telegram-клієнта, якому слід надіслати повідомлення [**\***](/doc/uk/chatbot/mesendzheri/telegram/api.md)

**! text** - текст повідомлення

**client\_message\_id** - ID цитованого повідомлення

**reply\_markup** — налаштування кнопок [**\*\***](/doc/uk/chatbot/mesendzheri/telegram/api.md)

**parse\_mode** — режим форматування тексту для жирного або курсивного шрифту в описі повідомлення [**\*\*\***](/doc/uk/chatbot/builder/telegram_messages.md)**.** можливі значення: html, markdown, markdownV2

**disable\_web\_page\_preview -** чи відображати попередній перегляд посилання; встановіть 1, щоб вимкнути, інакше 0 або залиште порожнім ("")

**protect\_content** — прапорець захисту вмісту від копіювання; щоб увімкнути, передайте будь-яке значення, крім 0, False або порожніх лапок ('')

**disable\_notification** —  прапорець для надсилання зі звуковим сповіщенням (за замовчуванням 0); 1 - надсилати без звуку, 0 - надсилати зі сповіщенням

**message\_thread\_id** — ідентифікатор гілки (доступний у супергрупах із функціональністю форуму) **entities** — дає змогу копіювати попередньо відформатований текст із усім стилюванням; вкажіть діапазони символів для кожного стилю форматування. Приклад можна знайти в полі tg\_request. Параметр має містити словник.

**business\_connection\_id -** значення, що використовується під час підключення бота (Business ID, відображається в каналах); слід передавати, якщо вказано токен бота і повідомлення має бути надіслано через акаунт користувача, пов’язаний із ботом

Приклад передавання параметра:

`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`&#x20;

У прикладі показано лише словник, тоді як сам текст повідомлення визначається в окремій змінній.

</details>

2. Методи

\- [tg\_send\_chat\_action](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-raboty-v-chatakh-i-kanalakh-telegram#tg_send_chat_action)

\- [tg\_send\_message](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-dlya-otpravki-i-redaktirovaniya-soobshenii)

\- [tg\_send\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_quiz\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_video\_note](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_sticker](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_contact](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-kontakt-tg_send_contact)

\- [tg\_send\_venue](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-geotochku-tg_send_venue)

\- [tg\_send\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii?q=#primer-koda-dlya-kopirovaniya-6)

\- [tg\_send\_animation](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_voice](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_media\_group](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_photo](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_audio](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_dice ](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

Вони автоматично працюють із клієнтами, які написали до бізнес-акаунта Telegram, так само, як і в ботах.

{% hint style="info" %}
Докладніше про ці методи дивіться у статті [Telegram API](/doc/uk/chatbot/mesendzheri/telegram/api.md)"
{% endhint %}


---

# 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/business.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.