Чатбот для Telegram Business-акаунта

Тепер ви можете створювати персональних бізнес-асистентів — спеціальних ботів, які безпосередньо інтегруються в окремі чати 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 - Telegram client ID

! callback_message - callback message

group_id - Telegram bot ID

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

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