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

Материал из ПланФикс
Перейти к: навигация, поиск
(Новая страница: «Для создания собственного бота Telegram: * перейдите по [https://telegram.me/botfather ссылке] (Telegram должен …»)
 
 
(не показано 48 промежуточных версий 5 участников)
Строка 1: Строка 1:
 +
{{#seo:
 +
|title=Как создать собственного бота Telegram
 +
|titlemode=append
 +
|keywords=планфикс, телеграм, бот, telegram, системное поле Telegram, поле Telegram
 +
|description=создание собственного бота Telegram
 +
}}
 +
 +
Вы можете создать собственного бота [[Telegram]] и подключить его в ПланФикс. Сообщения, отправленные такому боту вашими клиентами или коллегами, станут [[Задачи | задачами]] в ПланФиксе. Комментарии, добавленные в задачу с уведомлением внешнего абонента, будут отправлены ему в Telegram от имени бота. Это позволяет организовывать обработку заявок клиентов с мобильных устройств, работу службы поддержки и т.п.
 +
 +
 +
== Создание Telegram-бота ==
 +
 
Для создания собственного бота Telegram:
 
Для создания собственного бота Telegram:
 
* перейдите по [https://telegram.me/botfather ссылке] (Telegram должен быть запущен на этом устройстве)
 
* перейдите по [https://telegram.me/botfather ссылке] (Telegram должен быть запущен на этом устройстве)
 +
* в приветственном окне бота нажмите кнопку «Старт».
 +
 +
https://pic.planfix.ru/pf/Mu/uDW2k4.png
 +
 
* в загрузившемся окне диалога с @BotFather введите команду /newbot
 
* в загрузившемся окне диалога с @BotFather введите команду /newbot
* после получения запроса на имя нового бота, введите название бота. Название должно заканчиваться на bot или _bot. Желательно выбрать название, ассоциирующееся с вашей компанией или деятельностью. Например, для компании "Константа" удобно будет выбрать название Konstantabot или Konstatnta_bot. После ввода названия, нажмите Enter.
+
* после получения запроса на имя нового бота, введите название бота. Название должно заканчиваться на bot или _bot. Желательно выбрать название, ассоциирующееся с вашей компанией или деятельностью. Например, для компании «BrainStorm». будет выбрать название BrainstormAgencyBot или BrainstormAgency_bot. После ввода названия, нажмите Enter.
  
https://pic.planfix.ru/pf/Q5/BJl5rV.jpg
+
 
 +
https://pic.planfix.ru/pf/ia/FXkOpg.png
  
  
Строка 10: Строка 27:
  
  
https://pic.planfix.ru/pf/dM/jKejuT.jpg
+
https://pic.planfix.ru/pf/GF/A5Psmu.png
 +
 
 +
 
 +
== Подключение Telegram-бота в ПланФикс ==
 +
 
 +
Для подключения созданного бота в ПланФикс, перейдите в раздел '''Управление аккаунтом / Интеграции / Мессенджеры / Telegram''' и нажмите '''Добавить бота''':
 +
 
 +
 
 +
https://pic.planfix.ru/pf/PI/iqbDty.png
 +
 
 +
 
 +
* в появившемся окне введите имя бота, ключ, полученный при его создании (он выделен красной рамкой на финальном скриншоте диалога с BotFather), укажите, по какому шаблону будут создаваться задачи по поступающим от бота сообщениям и по какому шаблону будет создаваться новый контакт, который отправит боту это сообщение, список сотрудников, которых нужно подключить [[Дополнительное подключение сотрудников |дополнительно в качестве исполнителей]] (кроме указанных в шаблоне задачи) :
 +
 
 +
 
 +
https://p.pfx.so/pf/EF/nSupy6.png
  
  
* Для подключения созданного бота в ПланФикс, перейдите в раздел '''Управление аккаунтом / Интеграции / Интеграция с Telegram''' и нажмите '''Добавить бота''':
+
'''Важно:''' При настройке интеграции есть возможность создавать новую задачу,  если нет [[Тип статуса задачи |
 +
активных]] (то есть в любом активном статусе) задач по обращениям от клиента:
  
https://pic.planfix.ru/pf/EM/nhSCaB.jpg
 
  
 +
https://pic.planfix.ru/pf/0C/exICQz.png
  
* в появившемся окне введите имя бота и ключ, полученный при его создании (он выделен красной рамкой на финальном скриншоте диалога с BotFather):
 
  
https://pic.planfix.ru/pf/MD/TTT0xl.jpg
+
По умолчанию чекбокс включен. При активном чекбоксе новая задача будет создаваться, если предыдущая задача данного клиента удалена, завершена или находится в неактивном статусе.
 +
При этом история переписки автоматически добавляется в описание созданной задачи:
  
* После добавления бота, вы сможете выбрать, по какому шаблону будут создаваться задачи по поступающим от бота сообщениям и по какому шаблону будет создаваться новый контакт, который отправит боту это сообщение:
 
  
https://pic.planfix.ru/pf/p7/DZEIKo.jpg
+
https://pic.planfix.ru/pf/ZR/vgEWtb.png
  
  
'''Важно:''' для каждого контакта будет автоматически создана одна задача и вся история переписки с ним будет добавляться в эту задачу
+
При неактивном чекбоксе все сообщения клиента будут попадать в одну задачу, независимо от ее текущего статуса.
 +
 
 +
 
 +
== Системное поле 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 нельзя.
  • Возможность создания собственного бота доступна только для платных пакетов ПланФикса.


Перейти