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

Варианты использования:
Таких ассистентов можно настроить для различных целей, например:

  • Консультации по продуктам или услугам.
  • Ответы на часто задаваемые вопросы.
  • Выполнение широкого круга других автоматизированных задач.

Ключевая особенность: полный контроль

Пользователь может в любой момент мгновенно переключиться обратно на ручное общение, не прерывая и не отключая работу бота, что обеспечивает полный контроль над чатом.

Внимание!

У аккаунта Telegram Business есть 24-часовое окно.

Как только пользователь отправляет свое первое сообщение, у бота есть 24-часовое окно, чтобы ответить и продолжить разговор. Это окно сбрасывается каждый раз, когда пользователь отвечает.

  • Если пользователь отвечает: 24-часовое окно перезапускается, что позволяет вести непрерывный диалог.
  • Если пользователь НЕ отвечает в течение 24 часов: Окно закрывается. Боту будет заблокирована возможность отправлять дальнейшие сообщения, пока пользователь не отправит новое сообщение для повторного инициирования контакта.

Подключение бота

Шаг 1. Настройка в разделе Мессенджеры.

  1. Если вы подключаете Telegram-бота впервые.

Сначала перейдите на вкладку «Каналы» в разделе Mavibot, чтобы подключить Telegram-чатбота (если его еще нет).

Далее подключаем Telegram-бота в соответствии с инструкцией.

  1. Если Telegram уже подключен.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Готово! Все необходимые настройки чат-бота с бизнес-аккаунтом выполнены.

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

Как отключить

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

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

Если вы отключите свой бизнес-аккаунт, чат-бот продолжит работать в стандартном режиме.

Доступные функции

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

tg_callback(platform_id , callback_message,group_id, tg_business)

Параметры:

! platform_id - ID клиента Telegram

! callback_message - сообщение обратного вызова

group_id - ID Telegram-бота

tg_business - для работы с бизнес-клиентами принимает значение «1».

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)

Параметры:

! platform_id - идентификатор чата в Telegram *

! 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 - значение, используемое при подключении бота (Business ID, отображается в каналах); должно передаваться, если указан токен бота и сообщение должно быть отправлено через учетную запись пользователя, привязанную к боту

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 )

! platform_id - идентификатор чата в Telegram *

! 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, отображается в каналах); должно передаваться, если указан токен бота и сообщение должно быть отправлено через учетную запись пользователя, привязанную к боту

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)

Параметры:

! token — токен Telegram-бота, полученный от BotFather

! platform_id — идентификатор клиента Telegram, которому нужно отправить сообщение *

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

client_message_id - ID цитируемого сообщения

reply_markup — настройки кнопок **

parse_mode — режим форматирования текста для жирного или курсивного начертания в описании сообщения ***. возможные значения: 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"}]

В примере показан только словарь, а сам текст сообщения определяется в отдельной переменной.

  1. Методы

- tg_send_chat_action

- tg_send_message

- tg_send_poll

- tg_send_quiz_poll

- tg_send_video_note

- tg_send_sticker

- tg_send_contact

- tg_send_venue

- tg_send_video

- tg_send_animation

- tg_send_voice

- tg_send_document

- tg_send_media_group

- tg_send_some_photo

- tg_send_some_video

- tg_send_some_document

- tg_send_some_audio

- tg_send_dice

Они автоматически работают с клиентами, написавшими в аккаунт Telegram Business, так же, как и в ботах.

Для получения дополнительной информации об этих методах см. статью Telegram API"