Telegram Business-аккаунт

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

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

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

Важно!

В Telegram business-аккаунт есть окно 24 часа.

Если закрыто, то будет отправляться следующая ошибка:

Соответственно бот не сможет отправить сообщение клиенту.

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

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

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

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

Для начала перейдите во вкладку Каналы в разделе Salebot для подключения чат-бота Telegram (если такового еще нет).

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

Если Телеграм-бот подключен.

В случае, если у вас уже есть подключенный Телеграм-бот, найдите данного бота в каналах:

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

В открывшемся модальном окне кликните на ГОТОВО для обновления настроек вашего Телеграм-бота (больше никаких настроек менять не нужно):

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

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

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

Далее вы увидите вкладку "Чат-боты", куда необходимо перейти:

После чего в открывшейся вкладке укажите ссылку необходимого телеграм-бота либо его имя (приоритетнее ввод ссылки):

Установите в этой же вкладке разрешение (чекбокс "Ответы на сообщения") чат-боту отвечать на сообщения:

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

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

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

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

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

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

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

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

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

Кликните по кнопке "Отключить бизнес-аккаунт":

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

Видео-инструкция

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

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

tg_callback(platform_id , callback_message,group_id, tg_business)

tg_callback

Параметры:

! platform_id - идентификатор клиент Telegram

! callback_message - текст сообщение в колбеке

group_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 - идентификатор цитируемого сообщения

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 - ид цитируемого сообщения

message_thread_id — идентификатор темы (доступно для супергрупп при наличии функционала форума)

open_period - время для прохождения викторины/теста; передается числовое значение от 5 до 600, равное количеству секунд.

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 - идентификатор сообщения, которое необходимо процитировать

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 — c ним вы можете просто копировать сверстанный текст со всеми особенностями и просто указать с какого символа по какой он будет отображаться с тем или иным шрифтом. Пример можете подсмотреть в tg_request в соответствующем поле. В параметре должен быть словарь.

Пример передачи параметра:

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

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