Інтеграція з Telegram-ботом
Telegram-бот — це акаунт вашої компанії в Telegram, якому клієнти пишуть в особисті повідомлення. Після підключення ці повідомлення з'являються в розділі Месенджер, і ваша команда відповідає клієнтам прямо зі Skynum.
Ця стаття описує підключення бота і правила Telegram для ботів. Як відповідати клієнтам, надсилати файли і створювати замовлення з чату — у розділі Месенджер. Що доступно в переписках Telegram-бота, показує таблиця Можливості каналів.
Що потрібно підготувати
- акаунт Telegram, з якого ви створите бота. Цей акаунт залишається власником бота і керує ним;
- назву бота — її клієнти бачать у заголовку чату;
- username бота — коротке ім'я для пошуку й посилання на бота.
Бот у Telegram
Бота створюють у чаті з @BotFather — офіційним ботом Telegram для керування ботами. Біля його імені стоїть синя галочка. BotFather пише англійською.
Якщо бот у компанії вже є, новий створювати не потрібно. Надішліть BotFather команду /mybots, виберіть бота й натисніть API Token — BotFather покаже токен. Щойно бот підключений до Skynum, його повідомлення перестають іти в попередній сервіс.
Створення бота і токен
- Відкрийте в Telegram чат з @BotFather.
- Надішліть команду
/newbot. - Введіть назву бота.
- Введіть username бота. Він складається з латинських літер, цифр і знака підкреслення, має довжину від 5 до 32 символів і закінчується на
bot, наприкладmy_shop_bot. Відповідь Sorry, this username is already taken означає, що такий username уже зайнятий: придумайте інший. - Скопіюйте токен із повідомлення BotFather. Токен — це рядок із цифр і літер, розділений двокрапкою.
Токен дає повний доступ до бота. Не надсилайте його в листуванні й не показуйте на скриншотах. Якщо токен побачила стороння людина, надішліть BotFather команду /token і отримайте новий. Новий токен потрібно вставити в поле Токен інтеграції у Skynum.
Фото і назва бота
Фото й назву бота клієнт бачить у своєму Telegram. Фото задає команда /setuserpic, назву змінює команда /setname. Обидві команди надсилаються в чат з BotFather.
Що зробити в Skynum
- Відкрийте Налаштування → Інтеграції → Месенджери.
- Натисніть Додати інтеграцію і виберіть Telegram-бот.
- Заповніть Назва інтеграції.
- У полі Токен вставте токен із BotFather.
- Увімкніть Інтеграція активна.
- Заповніть спільні поля інтеграцій месенджера: Канал продажу, Тип ціни, Виконавець за замовчуванням, Звук сповіщень, Відправляти сповіщення тільки, Філія, юридична особа.
- Натисніть Зберегти. Поле Обліковий запис не заповнюйте: username бота з'явиться в ньому після збереження.
- Натисніть Перевірити підключення.
Після збереження в полі Обліковий запис стоїть username підключеного бота, а в полі Ім'я — назва бота. Порожнє поле Обліковий запис означає, що токен вставлено не повністю: скопіюйте його в BotFather заново, з усіма символами по обидва боки двокрапки, і збережіть інтеграцію ще раз. Успішну перевірку підтверджує повідомлення Підключення успішно пройшло перевірку.
Запит номера телефону
Номер телефону клієнта дозволяє одразу зрозуміти, хто пише: діалог сам пов'язується з контрагентом, у якого записаний цей номер.
- Увімкніть в інтеграції перемикач Запитувати номер телефону.
- У полі Мова повідомлень бота виберіть мову, якою бот звертається до клієнтів: Українська, Русский або English.
- Натисніть Зберегти.
Тепер, коли клієнт починає діалог з ботом, бот надсилає йому повідомлення з кнопкою Поділитися номером. Це повідомлення видно і в чаті Skynum.
Клієнт натискає кнопку, і номер приходить у діалог карткою контакту. Далі:
- номер записаний в одного контрагента або в його контактної особи — діалог пов'язується з цим контрагентом;
- номера немає в картотеці або він записаний у кількох контрагентів — виберіть контрагента в полі Контрагент у правій панелі чату;
- діалог уже пов'язаний з контрагентом — зв'язок залишається таким, як його встановив співробітник, і бот номер не запитує.
Враховується лише власний номер клієнта. Контакт іншої людини, який клієнт переслав у чат, показується карткою і зв'язок діалогу не змінює.
Як клієнти пишуть боту
Діалог завжди починає клієнт: він відкриває бота і надсилає перше повідомлення. Після цього йому можна відповідати зі Skynum. Перший вхід клієнта в бота кнопкою Розпочати чат позначає рядком Клієнт розпочав діалог.
Посилання на бота має вигляд https://t.me/ і username бота. Розмістіть його на сайті, у соцмережах і на друкованих матеріалах.
Бот веде особисте листування з кожним клієнтом окремо. Кожен клієнт — окремий діалог у розділі Месенджер.
Що можна надсилати
- Текст до 4096 символів.
- Фото й документи. Текст, набраний разом із файлом, клієнт отримує підписом до нього — до 1024 символів.
- Відповідь із цитатою: дія Відповісти в меню повідомлення клієнта (три крапки).
- Реакцію ❤️: подвійне натискання на текст повідомлення клієнта.
- Товар із каталогу Skynum: кнопка з коробкою біля поля введення — клієнт отримає фото товару з ціною за полем Тип ціни інтеграції. Докладніше: Надсилання товару з картотеки.
Своє повідомлення можна виправити або видалити: дії Редагувати і Видалити в меню повідомлення. Видалити повідомлення бота можна протягом 48 годин після відправлення.
Що приходить від клієнта
- Текст, стікери, фото, відео, голосові повідомлення і документи.
- Відповідь клієнта з цитатою вашого повідомлення.
- Реакція клієнта — емодзі під вашим повідомленням.
- Виправлене клієнтом повідомлення — новий текст із позначкою олівця.
- Контакт — карткою з іменем і номером телефону.
Telegram передає ботам файли розміром до 20 МБ. Про більший файл — розділ Типові ситуації.
Перевірка після підключення
- Відкрийте бота з іншого акаунта Telegram і почніть діалог.
- Надішліть боту повідомлення.
- Відкрийте в Skynum розділ Месенджер.
У списку з'явився новий діалог. На фото клієнта стоїть значок Telegram, а в правій панелі чату — рядок із назвою месенджера й username бота.
Типові ситуації
Перевірка показує «Підключення не працює, перевірте налаштування»
Токен в інтеграції не збігається з токеном бота. Скопіюйте токен у BotFather ще раз і вставте його в поле Токен. Після команди /token у BotFather діє лише новий токен.
«Інтеграція з обліковим записом … вже існує»
Цей бот уже підключений в іншій інтеграції вашої компанії. Один бот підключається в одній інтеграції. Для другої інтеграції створіть окремого бота.
Повідомлення клієнтів не з'являються в месенджері
- Перевірте, що увімкнено Інтеграція активна.
- Перевірте, чи бот не підключений ще й до іншої системи. Бот передає повідомлення лише одній системі — тій, що підключила його останньою. Відключіть бота в іншій системі, вставте токен у поле Токен інтеграції ще раз і натисніть Зберегти.
- Вимкніть Інтеграція активна, збережіть інтеграцію, увімкніть знову і збережіть ще раз.
Файл клієнта показується без посилання
Telegram віддає ботам файли розміром до 20 МБ. Більший файл показується в чаті карткою з назвою і розміром. Попросіть клієнта надіслати файл меншого розміру або посилання на нього.
Підсумок
Щоб листуватися з клієнтами в Telegram зі Skynum, візьміть токен наявного бота або створіть нового в BotFather, вставте токен в інтеграцію та перевірте підключення. Запит номера телефону сам пов'язує діалог з контрагентом із вашої картотеки.