Как создать собственного бота Telegram: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
Строка 74: Строка 74:




'''Важно'''<br />
:'''Важно'''
 
:Поле '''Telegram''' заполняется только в том случае, если у клиента в мессенджере @имя_пользователя заполнено и его настройки приватности позволяют ПланФиксу получить такие данные.
:Поле '''Telegram''' заполняется только в том случае, если у клиента в мессенджере @имя_пользователя заполнено и его настройки приватности позволяют ПланФиксу получить такие данные.



Версия от 15:54, 5 марта 2021

Вы можете создать собственного бота Telegram и подключить его в ПланФикс. Сообщения, отправленные такому боту вашими клиентами или коллегами, станут задачами в ПланФиксе. Комментарии, добавленные в задачу с уведомлением внешнего абонента, будут отправлены ему в Telegram от имени бота. Это позволяет организовывать обработку заявок клиентов с мобильных устройств, работу службы поддержки и т.п.


Создание Telegram-бота

Для создания собственного бота Telegram:

  • перейдите по ссылке (Telegram должен быть запущен на этом устройстве)
  • в приветственном окне бота нажмите кнопку «Старт».

uDW2k4.png

  • в загрузившемся окне диалога с @BotFather введите команду /newbot
  • после получения запроса на имя нового бота, введите название бота. Название должно заканчиваться на bot или _bot. Желательно выбрать название, ассоциирующееся с вашей компанией или деятельностью. Например, для компании «BrainStorm». будет выбрать название BrainstormAgencyBot или BrainstormAgency_bot. После ввода названия, нажмите Enter.


FXkOpg.png


  • затем BotFather попросит вас ввести желаемое имя (username) для бота. В отличие от названия, имя должно быть уникально в рамках всего Telegram, поэтому для распространенных названий могут возникнуть проблемы с подбором незадействованного имени. BotFather будет сообщать о том, что это имя уже используется и предлагать ввести другое имя до тех пор, пока вы не найдете уникальное неиспользуемое ранее имя. После его ввода процесс создания бота будет завершен и вы увидите такое сообщение:


A5Psmu.png


Подключение Telegram-бота в ПланФикс

Для подключения созданного бота в ПланФикс, перейдите в раздел Управление аккаунтом / Интеграции / Мессенджеры / Telegram и нажмите Добавить бота:


iqbDty.png


  • в появившемся окне введите имя бота, список сотрудников, работающих с ботом, и ключ, полученный при его создании (он выделен красной рамкой на финальном скриншоте диалога с BotFather):


lRXrhW.png


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


tCxzgm.png


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


exICQz.png


По умолчанию чекбокс включен. При активном чекбоксе новая задача будет создаваться, если предыдущая задача данного клиента удалена, завершена или находится в неактивном статусе. При этом история переписки автоматически добавляется в описание созданной задачи:


vgEWtb.png


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


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

  • Когда клиент напишет вашему боту, в ПланФиксе в системное поле Telegram автоматически добавится @имя_пользователя клиента. Оно станет ссылкой на диалог с ним в десктопной версии мессенджера:

WHNtPc.png


Важно
Поле Telegram заполняется только в том случае, если у клиента в мессенджере @имя_пользователя заполнено и его настройки приватности позволяют ПланФиксу получить такие данные.
  • По клику на ссылку, откроется диалог с контактом в десктопной версии мессенджера. Мы сделали такую возможность ради удобства. Помните, написать первым из ПланФикса в Telegram нельзя.


Перейти