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

Разбираемся, как получать и обрабатывать в KeyCRM все сообщения из вашего Telegram-бота.
Автор Андрей Гадай
Обновлено 3 дня назад

Если вы используете 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-ключ бота;
  4. Источник — укажите источник, используемый по умолчанию для заказов и карт в воронке, созданных в чатах по этому каналу;
  5. Менеджер — при необходимости укажите менеджера, на которого будут сразу назначаться новые чаты по этому каналу. Если добавить несколько менеджеров, то чаты будут назначаться на каждого по очереди. Можно оставить пустым;
  6. Переназначать оператора – активируйте переключатель, если нужно, чтобы при ответе другого менеджера в чате он автоматически назначался на него;
  7. Связь с воронками — включение и и выберите значение:
    • Нет  карточки НЕ будут создаваться из чата автоматически;
    • Одноразовый — карточки будут созданы только один раз при условии, что еще нет карточки с этого чата;
    • Повторяющийся — карточки будут создаваться всегда при открытии нового тикета в чате, если у него нет карточки или заказа в рабочих статусах (все статусы кроме успешного и отклоненных);
  8. Воронка   выберите воронку, если требуется автоматически создавать карточки из новых диалогов. Этот пункт доступен, если включен раздел «Воронки».

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

Важно! Если после подключения вы не получаете сообщений, то убедитесь что бот не подключён ещё к какому-то другому сервису. 

Чтобы сообщения начали приходить:
1. Отключите другой сервис. Бот должен быть подключен только к KeyCRM;
2. Отключите на несколько секунд канал в KeyCRM, потом снова включит. Бот переподключится и сообщения будут приходить.

Как предоставить доступы пользователям к каналу

Во время или после успешного подключения, чтобы предоставить доступ отдельным пользователям, перейдите во вкладку «Доступ пользователей». В ней можно выбрать:

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

Если необходимо предоставить доступ к каналу только одному пользователю, перейдите в «Настройки» → «Роли», создайте отдельную роль и укажите ее для необходимого пользователя.

После этих действий перейдите в настройки канала и во вкладке «Доступ пользователей» выберите эту роль.

Обратите внимание! Доступ к чатам будет только у тех ролей, в которых в настройках заданы права «Доступ к чатам».

Если выберете «Все пользователи», доступ будет только у пользователей, роли которых имеют эти права.

Если выберите «Выбранные роли», то сможете указать определенные роли, которым будут доступны чаты этого канала при условии, что у них заданы права «Доступ к чатам».

Как активировать запрос на оценку оператора в чате

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

Появятся дополнительные поля, где можно указать свои тексты для кнопок и сообщений, а так же выбрать частоту между повторными запросами оценки в одном диалоге: 

Заполните данные и сохраните настройки канала.

После этого по закрытию чата вашему клиенту будет предложено оценить обслуживание от 1 до 5 и оставить комментарий, при условии что:

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

Отправленная оценка и отзыв будут отображены в отчете по оценкам и в окне чата в CRM: 

Теги: телеграм, телеграм бот, телеграм-бот, телега, telegram-bot, telegram bot, подключить телеграм

Оцените эту статью