Чатбот для бизнес-аккаунта Telegram

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

Сценарии использования: Эти ассистенты могут быть настроены для разных целей, например:

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

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

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

Внимание!

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

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

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

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

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

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

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

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

Если 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".

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

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

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

tg_callback(platform_id , callback_message,group_id, tg_business)

tg_callback

Параметры:

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

! callback_message - callback-сообщение

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)

tg_send_poll

Параметры:

! 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 )

tg_send_quiz_poll

! 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 защита от копирования и скриншотов, '' - без защиты.

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)

tg_send_message_1

Параметры:

! 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 или пустых кавычек ('')

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"}]

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