Перейти до основного вмісту

Інтеграція з Telegram-ботом

Telegram-бот — це акаунт вашої компанії в Telegram, якому клієнти пишуть в особисті повідомлення. Після підключення ці повідомлення з'являються в розділі Месенджер, і ваша команда відповідає клієнтам прямо зі Skynum.

Робота з листуванням

Ця стаття описує підключення бота і правила Telegram для ботів. Як відповідати клієнтам, надсилати файли і створювати замовлення з чату — у розділі Месенджер. Що доступно в переписках Telegram-бота, показує таблиця Можливості каналів.

Що потрібно підготувати​

  • акаунт Telegram, з якого ви створите бота. Цей акаунт залишається власником бота і керує ним;
  • назву бота — її клієнти бачать у заголовку чату;
  • username бота — коротке ім'я для пошуку й посилання на бота.

Бот у Telegram​

Бота створюють у чаті з @BotFather — офіційним ботом Telegram для керування ботами. Біля його імені стоїть синя галочка. BotFather пише англійською.

Якщо бот у компанії вже є, новий створювати не потрібно. Надішліть BotFather команду /mybots, виберіть бота й натисніть API Token — BotFather покаже токен. Щойно бот підключений до Skynum, його повідомлення перестають іти в попередній сервіс.

Створення бота і токен​

  1. Відкрийте в Telegram чат з @BotFather.
  2. Надішліть команду /newbot.
  3. Введіть назву бота.
  4. Введіть username бота. Він складається з латинських літер, цифр і знака підкреслення, має довжину від 5 до 32 символів і закінчується на bot, наприклад my_shop_bot. Відповідь Sorry, this username is already taken означає, що такий username уже зайнятий: придумайте інший.
  5. Скопіюйте токен із повідомлення BotFather. Токен — це рядок із цифр і літер, розділений двокрапкою.
Зберігайте токен у таємниці

Токен дає повний доступ до бота. Не надсилайте його в листуванні й не показуйте на скриншотах. Якщо токен побачила стороння людина, надішліть BotFather команду /token і отримайте новий. Новий токен потрібно вставити в поле Токен інтеграції у Skynum.

Фото і назва бота​

Фото й назву бота клієнт бачить у своєму Telegram. Фото задає команда /setuserpic, назву змінює команда /setname. Обидві команди надсилаються в чат з BotFather.

Що зробити в Skynum​

  1. Відкрийте Налаштування → Інтеграції → Месенджери.
  2. Натисніть Додати інтеграцію і виберіть Telegram-бот.
  3. Заповніть Назва інтеграції.
  4. У полі Токен вставте токен із BotFather.
  5. Увімкніть Інтеграція активна.
  6. Заповніть спільні поля інтеграцій месенджера: Канал продажу, Тип ціни, Виконавець за замовчуванням, Звук сповіщень, Відправляти сповіщення тільки, Філія, юридична особа.
  7. Натисніть Зберегти. Поле Обліковий запис не заповнюйте: username бота з'явиться в ньому після збереження.
  8. Натисніть Перевірити підключення.

Після збереження в полі Обліковий запис стоїть username підключеного бота, а в полі Ім'я — назва бота. Порожнє поле Обліковий запис означає, що токен вставлено не повністю: скопіюйте його в BotFather заново, з усіма символами по обидва боки двокрапки, і збережіть інтеграцію ще раз. Успішну перевірку підтверджує повідомлення Підключення успішно пройшло перевірку.

Запит номера телефону​

Номер телефону клієнта дозволяє одразу зрозуміти, хто пише: діалог сам пов'язується з контрагентом, у якого записаний цей номер.

  1. Увімкніть в інтеграції перемикач Запитувати номер телефону.
  2. У полі Мова повідомлень бота виберіть мову, якою бот звертається до клієнтів: Українська, Русский або English.
  3. Натисніть Зберегти.

Тепер, коли клієнт починає діалог з ботом, бот надсилає йому повідомлення з кнопкою Поділитися номером. Це повідомлення видно і в чаті Skynum.

Клієнт натискає кнопку, і номер приходить у діалог карткою контакту. Далі:

  • номер записаний в одного контрагента або в його контактної особи — діалог пов'язується з цим контрагентом;
  • номера немає в картотеці або він записаний у кількох контрагентів — виберіть контрагента в полі Контрагент у правій панелі чату;
  • діалог уже пов'язаний з контрагентом — зв'язок залишається таким, як його встановив співробітник, і бот номер не запитує.

Враховується лише власний номер клієнта. Контакт іншої людини, який клієнт переслав у чат, показується карткою і зв'язок діалогу не змінює.

Як клієнти пишуть боту​

Діалог завжди починає клієнт: він відкриває бота і надсилає перше повідомлення. Після цього йому можна відповідати зі Skynum. Перший вхід клієнта в бота кнопкою Розпочати чат позначає рядком Клієнт розпочав діалог.

Посилання на бота має вигляд https://t.me/ і username бота. Розмістіть його на сайті, у соцмережах і на друкованих матеріалах.

Бот веде особисте листування з кожним клієнтом окремо. Кожен клієнт — окремий діалог у розділі Месенджер.

Що можна надсилати​

  • Текст до 4096 символів.
  • Фото й документи. Текст, набраний разом із файлом, клієнт отримує підписом до нього — до 1024 символів.
  • Відповідь із цитатою: дія Відповісти в меню повідомлення клієнта (три крапки).
  • Реакцію ❤️: подвійне натискання на текст повідомлення клієнта.
  • Товар із каталогу Skynum: кнопка з коробкою біля поля введення — клієнт отримає фото товару з ціною за полем Тип ціни інтеграції. Докладніше: Надсилання товару з картотеки.

Своє повідомлення можна виправити або видалити: дії Редагувати і Видалити в меню повідомлення. Видалити повідомлення бота можна протягом 48 годин після відправлення.

Що приходить від клієнта​

  • Текст, стікери, фото, відео, голосові повідомлення і документи.
  • Відповідь клієнта з цитатою вашого повідомлення.
  • Реакція клієнта — емодзі під вашим повідомленням.
  • Виправлене клієнтом повідомлення — новий текст із позначкою олівця.
  • Контакт — карткою з іменем і номером телефону.

Telegram передає ботам файли розміром до 20 МБ. Про більший файл — розділ Типові ситуації.

Перевірка після підключення​

  1. Відкрийте бота з іншого акаунта Telegram і почніть діалог.
  2. Надішліть боту повідомлення.
  3. Відкрийте в Skynum розділ Месенджер.

У списку з'явився новий діалог. На фото клієнта стоїть значок Telegram, а в правій панелі чату — рядок із назвою месенджера й username бота.

Типові ситуації​

Перевірка показує «Підключення не працює, перевірте налаштування»​

Токен в інтеграції не збігається з токеном бота. Скопіюйте токен у BotFather ще раз і вставте його в поле Токен. Після команди /token у BotFather діє лише новий токен.

«Інтеграція з обліковим записом … вже існує»​

Цей бот уже підключений в іншій інтеграції вашої компанії. Один бот підключається в одній інтеграції. Для другої інтеграції створіть окремого бота.

Повідомлення клієнтів не з'являються в месенджері​

  • Перевірте, що увімкнено Інтеграція активна.
  • Перевірте, чи бот не підключений ще й до іншої системи. Бот передає повідомлення лише одній системі — тій, що підключила його останньою. Відключіть бота в іншій системі, вставте токен у поле Токен інтеграції ще раз і натисніть Зберегти.
  • Вимкніть Інтеграція активна, збережіть інтеграцію, увімкніть знову і збережіть ще раз.

Файл клієнта показується без посилання​

Telegram віддає ботам файли розміром до 20 МБ. Більший файл показується в чаті карткою з назвою і розміром. Попросіть клієнта надіслати файл меншого розміру або посилання на нього.

Підсумок​

Щоб листуватися з клієнтами в Telegram зі Skynum, візьміть токен наявного бота або створіть нового в BotFather, вставте токен в інтеграцію та перевірте підключення. Запит номера телефону сам пов'язує діалог з контрагентом із вашої картотеки.