Як підключити Telegram-бота до KeyCRM (для адміністратора)

Розбираємось, як отримувати та обробляти у KeyCRM всі повідомлення з вашого Telegram-бота.
Написано Вадим Крижевський
Оновлено 5 місяців тому

Якщо ви використовуєте Telegram-бота для комунікації з покупцями, то рекомендуємо підключити його до CRM, оскільки:

  • Все листування ведеться прямо у вікні вашого кабінету;
  • По даним клієнта легко створити картку покупця або відшукати покупця в базі;
  • Оформити замовлення/картку воронки прямо з чату з покупцем.
Зверніть увагу! Для підключення у вас вже має бути створений бот. Якщо його ще немає, ви можете скористатися нашою інструкцією для створення.

Крок 1. Отримайте API-ключ вашого бота

У обліковому записі Telegram, у рядку пошуку введіть «BotFather», виберіть той, який позначений блакитним значком. Або просто перейдіть за посиланням: https://t.me/BotFather.

  1. Введіть або оберіть в меню команду /mybots;
  2. Оберіть потрібний бот зі списку створених вами ботів;
  3. Натисніть на дію з ботом API Token;
  4. З'явиться API-ключ, який необхідно скопіювати для підключення до KeyCRM.

Крок 2. Підключення бота в KeyCRM

Перейдіть до «Налаштування» «Комунікації» вкладка «Чати/SMS/Email» та натисніть кнопку «Додати новий канал».

У вікні підключення, на вкладці «Загальні» заповніть поля:

  1. Назва — вкажіть довільну назву каналу;
  2. Тип каналу  виберіть «Telegram Bot»;
  3. API ключ —  вставте, скопійований раніше, API-ключ бота;

Крок 3. Надання доступів користувачам

Щоб надати доступ окремим користувачам, перейдіть у вкладку «Доступ користувачів». У ній можна обрати:

  1. Всі користувачі — доступ до каналу буде надано всім користувачам;
  2. Вибрані ролі — доступ до каналу буде наданий тільки користувачам, які знаходяться в призначеній ролі:

Якщо необхідно надати доступ до каналу тільки одному користувачу, перейдіть у «Налаштування» → «Ролі», створіть окрему роль і вкажіть її для необхідного користувача.

Після цих дій перейдіть до налаштувань каналу і у вкладці «Доступ користувачів» оберіть цю роль.

Зверніть увагу! Доступ до чатів буде лише у тих ролей, у яких у налаштуваннях ролі надані права «Доступ до чатів».

Якщо оберете «Всі користувачі», доступ буде тільки у користувачів, ролі яких мають ці права.

Якщо оберете «Вибрані ролі», можна вказати певні ролі, яким будуть доступні чати цього каналу за умови, що вони мають права «Доступ до чатів».

Крок 4. Додаткові налаштування

На вкладці «Додатково» доступні налаштування

  1. Джерело  вкажіть джерело, яке буде використовуватися за замовчуванням для замовлень та карток у воронці, створених в чатах з цього каналу;
  2. Менеджер  вкажіть менеджера, на якого одразу призначатимуться нові чати з цього каналу. Якщо додати декілька менеджерів — чати призначатимуться на кожного менеджера по черзі. Можна залишити порожнім, чати будуть створені без призначення;
  3. Переназначати оператора — активуйте перемикач, якщо потрібно, щоб при відповіді іншим менеджером в чаті він автоматично назначався на нього;
  4. Зв'язок з воронками — активуйте та оберіть значення:
    • Ні — картки НЕ будуть створюватись з чатів автоматично;
    • Одноразовий — картки будуть створені тільки один раз за умови, що ще не має картки з цього чата;
    • Повторюваний — картки будуть створюватись завжди при відкритті нового тікета в чаті, якщо не має картки чи замовлення в робочих статусах (усі статуси крім успішного і відхилених);
  5. Воронка  оберіть воронку, якщо потрібно автоматично створювати картки з нових діалогів.  Цей пункт доступний, якщо у вас увімкнений розділ «Воронки»;
  6. Автовідповіді в робочі години — активуйте і введіть текст, який буде відправлятись автоматично на перше повідомлення в робочі години (при створенні або повторному відкритті діалога повідомленням клієнта);
  7. Автовідповіді в неробочі години — активуйте і введіть текст, який буде відправлятись автоматично на перше повідомлення в неробочі години (при створенні або повторному відкритті діалога повідомленням клієнта).

    Коли ви вкажете усі необхідні параметри, натисніть кнопку «Додати». Канал з'явиться у списку та всі повідомлення, які будуть надходити після підключення почнуть відображатися в чатах.

    Важливо! Якщо після підключення ви не отримуєте повідомлень, переконайтеся, що бот не підключений ще до якогось іншого сервісу.

    Щоб повідомлення почали надходити:
    1. Вимкніть інший сервіс. Бот повинен бути підключений лише до KeyCRM;
    2. Відключіть на кілька секунд канал у KeyCRM, потім знову увімкне. Бот перепідключиться і повідомлення надходитимуть.

    Як активувати запит на оцінку оператора в чаті

    Перейдіть у вкладку «Оцінка якості» та активуйте перемикач «Запитувати оцінку»

    З'являться додаткові поля, де ви можете вказати свої тексти для кнопок та повідомлень і обрати частоту між повторними запитами оцінки в одному діалозі: 

    Заповніть дані та збережіть налаштування каналу. 

    Після цього відразу по закриттю чатів вашому клієнту буде запропоновано оцінити обслуговування від 1 до 5 і залишити коментар, за умови що:

    1. Пройшов мінімальний час між повторними запитами на оцінку від попереднього запиту, або запитів ще взагалі не було;
    2. В тікеті є повідомлення і від клієнта, і від менеджера;
    3. В тікеті мінімум 5 повідомлень;
    4. Від останнього повідомлення в тікеті до закриття чату пройшло не більше 1 години.

    Відправлена оцінка та відгук будуть відображені у звіті по оцінках та у вікні чата в CRM: 

    Теги: телеграм, телеграм бот, телеграм-бот, телега, telegram-bot, telegram bot, підключить телеграм бот, тг
    Чи була наша стаття корисною?