# Чат-бот для бизнес-аккаунта 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/0900508fb35cce28517580dd0bd153b5eaed21f1" alt="" width="563"><figcaption></figcaption></figure></div>

Далее подключаем Telegram-бота согласно[ инструкциям](/doc/ru/chatbot/messendzhery/telegram/chatbot.md) .&#x20;

2. **Если Telegram уже подключён**.&#x20;

Если у вас уже есть подключённый Telegram-бот, найдите этого бота в каналах:

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

Далее нажмите кнопку настроек, после чего вы увидите модальное окно с полями токена и т. д.:

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

В открывшемся модальном окне нажмите DONE, чтобы обновить настройки вашего Telegram-бота (больше ничего менять не нужно):

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

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

Шаг 2. Настройки мессенджера.

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

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

Далее вы увидите вкладку "Chatbots", куда нужно перейти:

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

Затем в новой открывшейся вкладке введите ссылку на нужного Telegram-бота или его имя пользователя (предпочтительнее вводить ссылку).

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

В той же вкладке установите разрешение (флажок "Reply to messages") для ответа чат-бота на сообщения.

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

Шаг 3. Настройки BotFather.

После привязки чат-бота к бизнес-аккаунту необходимо обновить настройки чат-бота в BotFather, где вы изначально создали Telegram-бота.

Для этого откройте чат с BotFather и включите его работу с бизнес-аккаунтом:

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

Перейдите к настройкам бота:

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

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

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

{% hint style="success" %}
Готово! Все необходимые настройки чат-бота с бизнес-аккаунтом выполнены.
{% endhint %}

Теперь в настройках канала вы найдёте Telegram-бота и увидите business ID, а также имя владельца бизнес-аккаунта:

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

### Как отключить&#x20;

Чтобы отключить чат-бота с бизнес-режимом, перейдите в каналы и найдите чат-бота, для которого нужно отключить эту настройку. Нажмите кнопку настроек:

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

Нажмите кнопку "Disable Business Account".

<div data-with-frame="true"><figure><img src="/files/0f1af8aaff08d683ad4a89ad4807d735890bf3ab" 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** -  ID клиента Telegram

**! callback\_message** - callback-сообщение&#x20;

**group\_id** - ID бота Telegram

**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/ru/chatbot/messendzhery/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/ru/chatbot/messendzhery/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/ru/chatbot/messendzhery/telegram/api.md)

**! text** - текст сообщения

**client\_message\_id** - ID цитируемого сообщения

**reply\_markup** — настройки кнопок [**\*\***](/doc/ru/chatbot/messendzhery/telegram/api.md)

**parse\_mode** — режим форматирования текста для жирного или курсивного шрифта в описании сообщения [**\*\*\***](/doc/ru/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 Business-аккаунт, так же, как и в ботах.

{% hint style="info" %}
Подробнее об этих методах см. в статье [Telegram API](/doc/ru/chatbot/messendzhery/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/ru/chatbot/messendzhery/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.