У EddyDesk є можливість обробки заявок з Telegram.
2) Підключення бота до системи
3) Додаткова інформація та можливі помилки при роботі з Telegram
Що таке боти?
Боти — спеціальні акаунти в Telegram, створені для автоматичного оброблення та надсилання повідомлень. Користувачі можуть взаємодіяти з ботами за допомогою повідомлень, що надсилаються через звичайні або групові чати.
Перший крок: створюємо бота.
Зверніться до пользователя @BotFather і дотримуйтесь його інструкцій:
- Напишіть команду /newbot, щоб створити нового бота.
- BotFather запитає у вас ім'я нового бота і запропонує вигадати name і username.
Ім'я (name) відображатиметься у контактах та чатах.
Username — ккоротке ім'я на латиниці, яке використовується для згадування бота та у посиланнях на профіль у telegram.me
Username повинен складатися з літер латинського алфавіту, підкреслень та цифр і бути довжиною від 5 до 32 символів. Також ім'я користувача обов'язково має закінчуватися на "bot", наприклад: "test_hde_bot"
- Після чого Ви можете налаштувати свого бота за бажанням: встановити картинку, опис і т.д. Повний перелік можливих команд доступний за командою /help..
Другий крок: налаштування в системі.
Після створення бота, Ви отримаєте ключ авторизації, який необхідний для підключення до вашої системи:
Як тільки ви створили бота та отримали свій ключ (токен) авторизації, Ви можете підключити створений бот до системи EddyDesk. Для цього перейдіть з Управління в розділ "Налаштування каналів зв'язку" і натисніть кнопку "Додати канал". Після чого виберіть "Telegram" і департамент якого буде підключений канал.
У полі "Ключ бота" введіть API token (який надав @Bot_father) та натисніть кнопку "Синхронізувати та зберегти". У разі коректних налаштувань у статусі буде відображено, що "З'єднання успішно встановлено":
Для того, щоб бот міг працювати як зі звичайними особистими повідомленнями, так і груповими чатами, в налаштуваннях бота необхідно вказати:
- /setjoingroups — визначає, чи можна додавати вашого робота в групи.
За замовчуванням цей параметр увімкнено (ENABLED). При необхідності його можна вимкнути (Disable):
- /setprivacy — перемикає режим конфіденційності у групах (чи всі повідомлення бачить ваш бот у групах). У відключеному стані (DISABLED) роботу надсилатимуться всі повідомлення.
Зверніть увагу, що повідомлення з Telegram доходять до системи в режимі реального часу, без очікування.
Таким чином, користувач (клієнт), не заходячи безпосередньо в систему, може звертатися до вашої служби підтримки використовуючи звичний для нього спосіб спілкування, а ви, у свою чергу, зможете обробляти заявки, що надійшли з каналів соцмереж та месенджерів безпосередньо в EddyDesk.
Відео:
Іноді під час роботи з каналом можна зіткнутися з деякими помилками (повідомлення не було доставлено, обрив з'єднання тощо). Так як інтеграція двостороння, то на стороні Telegram можуть бути певні обмеження на відправку, так і перебої роботи в цілому. У логах каналу можна ознайомитись, із чим була пов'язана та чи інша проблема, а також переглянути код її помилок. Крім того, інформація про те, що повідомлення не було доставлено, а також причина цього, відображається біля самого повідомлення:
Нижче наведено список деяких найбільш популярних проблем та причини їх виникнення:
- 413 Request Entity Too Large - означає, що вкладення, відправлене із системи, перевищує максимально допустимий розмір (50MB);
- Error 500 говорить про те, що виникла якась несправність з боку сервера Telegram. Спробуйте повторити спробу за деякий час;
- 403 FORBIDDEN - порушення конфіденційності. Наприклад, спроба написати повідомлення тому, хто заблокував вашого бота..
У Telegram також доступний метод getWebhookInfo для отримання поточного стану бота (його статус), що не вимагає параметрів. У разі успіху повертає об'єкт WebhookInfo. Якщо бот використовує getUpdates, повертається об'єкт із порожнім полем url.
Наприклад: https://api.telegram.org/bot123456:ABC-DEF1234/getWebhookInfo
де 123456:ABC-DEF1234 – токен вашого бота. Докладніше.