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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показано 18 промежуточных версий 3 участников)
Строка 2: Строка 2:
|title=Как создать собственного бота Telegram
|title=Как создать собственного бота Telegram
|titlemode=append
|titlemode=append
|keywords=планфикс, телеграм, бот, telegram
|keywords=планфикс, телеграм, бот, telegram, системное поле Telegram, поле Telegram
|description=создание собственного бота Telegram
|description=создание собственного бота Telegram
}}
}}
Строка 13: Строка 13:
Для создания собственного бота Telegram:
Для создания собственного бота Telegram:
* перейдите по [https://telegram.me/botfather ссылке] (Telegram должен быть запущен на этом устройстве)
* перейдите по [https://telegram.me/botfather ссылке] (Telegram должен быть запущен на этом устройстве)
* в приветственном окне бота нажмите кнопку «Start».
* в приветственном окне бота нажмите кнопку «Старт».


https://p.pfx.so/pf/Mu/uDW2k4.png
https://p.pfx.so/pf/Mu/uDW2k4.png
Строка 27: Строка 27:




https://p.pfx.so/pf/2I/YrwLXT.png
https://p.pfx.so/pf/GF/A5Psmu.png




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


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




https://p.pfx.so/pf/Qn/KMO74M.png
https://p.pfx.so/pf/PI/iqbDty.png




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




https://p.pfx.so/pf/Hm/Dvs0R9.png
https://p.pfx.so/pf/EF/nSupy6.png
 
 
* После добавления бота, вы сможете выбрать, по какому шаблону будут создаваться задачи по поступающим от бота сообщениям и по какому шаблону будет создаваться новый контакт, который отправит боту это сообщение:
 
 
https://p.pfx.so/pf/He/tCxzgm.png




Строка 65: Строка 59:


При неактивном чекбоксе все сообщения клиента будут попадать в одну задачу, независимо от ее текущего статуса.
При неактивном чекбоксе все сообщения клиента будут попадать в одну задачу, независимо от ее текущего статуса.
== Системное поле Telegram ==
Когда клиент напишет вашему боту, в ПланФиксе в системное поле «Telegram» автоматически добавится @имя_пользователя клиента. Оно станет ссылкой на диалог с ним в десктопной версии мессенджера:
https://p.pfx.so/pf/gm/WHNtPc.png
:'''Важно''': поле «Telegram» заполняется только в том случае, если у клиента в мессенджере @имя_пользователя заполнено и его настройки приватности позволяют ПланФиксу получить такие данные.
По клику на ссылку, откроется диалог с контактом в десктопной версии мессенджера. Мы сделали такую возможность ради удобства.
== Важно ==
*Написать первым из ПланФикса в Telegram нельзя.
*Возможность создания собственного бота доступна только для платных пакетов ПланФикса.






== Перейти ==
== Перейти ==
*[[Telegram]]
*[[Telegram]]
*[[Интеграции]]
*[[Интеграции]]

Текущая версия от 07:48, 24 сентября 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), укажите, по какому шаблону будут создаваться задачи по поступающим от бота сообщениям и по какому шаблону будет создаваться новый контакт, который отправит боту это сообщение, список сотрудников, которых нужно подключить дополнительно в качестве исполнителей (кроме указанных в шаблоне задачи) :


nSupy6.png


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


exICQz.png


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


vgEWtb.png


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


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

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

WHNtPc.png


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

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


Важно

  • Написать первым из ПланФикса в Telegram нельзя.
  • Возможность создания собственного бота доступна только для платных пакетов ПланФикса.


Перейти