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

Варіанти використання:
Цих асистентів можна налаштувати для різних цілей, наприклад:

  • Надання консультацій щодо продуктів або послуг.
  • Відповіді на поширені запитання.
  • Виконання широкого спектру інших автоматизованих завдань.

Ключова особливість: безшовний контроль

Користувач може миттєво переключитися назад на ручне спілкування в будь-який момент, не перериваючи та не вимикаючи роботу бота, що забезпечує повний контроль над чатом.

Увага!

Бізнес-акаунт Telegram має 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)

tg_callback

Параметри:

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

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 захист від копіювання та скріншотів, '' - без захисту.

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)

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 або порожніх лапок ('')

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. Методи

Вони автоматично працюють з клієнтами, які написали в Telegram Business акаунт, так само, як і в ботів.

Докладніше про ці методи дивіться у статті Telegram API