Як створити свого бота Telegram

Матеріал з Planfix

Ви можете створити власного бота Telegram і підключити його в Planfix. Повідомлення, надіслані такому боту вашими клієнтами або колегами, стануть завданнями в Planfix. Коментарі, додані в завдання з повідомленням зовнішньому абоненту, будуть відправлені йому в Telegram від імені бота. Це дозволяє організувати обробку звернень клієнтів з мобільних пристроїв, роботу служби підтримки тощо.

Створення Telegram‑бота

Для створення власного бота Telegram:

  • Перейдіть за посиланням (Telegram повинен бути запущений на цьому пристрої)
  • У вітальному вікні бота натисніть кнопку «Start».
  • У завантаженому вікні діалогу з @BotFather введіть команду /newbot
  • Після запиту на назву нового бота введіть ім'я бота. Назва повинна закінчуватися на bot або _bot. Бажано обрати назву, асоційовану з вашою компанією або діяльністю. Наприклад, для компанії «BrainStorm» можна обрати назву BrainstormAgencyBot або BrainstormAgency_bot. Після введення назви натисніть Enter.
  • Потім BotFather попросить ввести бажаний username для бота. На відміну від назви, username має бути унікальним у межах усього Telegram, тому для поширених назв можуть виникнути проблеми з підбором незайнятого імені. BotFather повідомлятиме, що це ім'я вже використовується, і пропонуватиме ввести інше ім'я доти, поки ви не знайдете унікальне. Після його введення процес створення бота буде завершено, і ви побачите токен бота, який знадобиться для подальшої роботи.

Підключення Telegram‑бота

Для підключення створеного бота перейдіть у розділ Керування акаунтом — Інтеграції — Месенджери — Telegram — Власний бот і натисніть кнопку "Додати бота".

У вікні, що з'явилося:

  • Введіть назву бота
  • Додайте ключ, отриманий під час створення бота.
  • Вкажіть, за яким шаблоном будуть створюватися завдання за вхідними від бота повідомленнями.
  • Вкажіть, за яким шаблоном буде створено новий контакт, який надішле боту повідомлення.
  • Додайте список співробітників, яких потрібно підключити додатково як виконавців (окрім зазначених у шаблоні завдання).
  • За потреби заповніть поле привітального повідомлення.

Автоматичне створення завдань

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

  • Автоматично створювати завдання при запуску бота — завдання створюється, як тільки людина натискає у вашому боті кнопку Start або надсилає команду /start — ще до того, як вона напише перше повідомлення. Якщо такої людини немає у вашій системі, для неї створюється контакт. Коли опція вимкнена, натискання Start саме по собі нічого не створює: завдання з'явиться тільки після першого реального повідомлення боту.
  • Автоматично створювати завдання при додаванні бота в групу — завдання створюється, як тільки вашого бота додають у групу Telegram, і група одразу прив'язується до цього завдання — незалежно від того, хто саме додав бота. Коли опція вимкнена, завдання для групи створює співробітник вручну командою /task. Опція потрібна, якщо групи для спілкування створюють ваші клієнти і самі додають туди вашого бота: без неї така переписка в систему не потрапить. Деталі: Підключення групи Telegram до Planfix.

Опції інтеграції Telegram

В інтеграції є опція створення нового завдання, якщо немає активних (тобто в будь‑якому активному статусі) завдань за зверненнями від клієнта.

За замовчуванням опція увімкнена:

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

Системне поле Telegram

Коли клієнт напише вашому боту, у Planfix в системне поле «Telegram» автоматично додасться @ім'я_користувача клієнта. Воно стане посиланням на діалог з ним у десктопній версії месенджера.

Зверніть увагу, поле «Telegram» заповнюється тільки в тому разі, якщо у клієнта в месенджері @ім'я_користувача вказане і його налаштування приватності дозволяють отримати такі дані.

За кліком на посилання відкриється діалог з контактом у десктопній версії месенджера. Ми зробили таку можливість задля зручності.

Важливо

  • Написати першим з Planfix в Telegram неможливо.
  • Можливість створення власного бота доступна лише для платних пакетів Planfix.

Перейти