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

Материал из ПланФикс
Перейти к: навигация, поиск
 
(не показано 16 промежуточных версий 3 участников)
Строка 2: Строка 2:
 
|title=Как создать собственного бота Telegram
 
|title=Как создать собственного бота Telegram
 
|titlemode=append
 
|titlemode=append
|keywords=планфикс, телеграм, бот, telegram
+
|keywords=планфикс, телеграм, бот, telegram, системное поле Telegram, поле Telegram
 
|description=создание собственного бота Telegram
 
|description=создание собственного бота Telegram
 
}}
 
}}
Строка 32: Строка 32:
 
== Подключение Telegram-бота в ПланФикс ==
 
== Подключение Telegram-бота в ПланФикс ==
  
Для подключения созданного бота в ПланФикс, перейдите в раздел '''Управление аккаунтом / Интеграции с другими сервисами/ Мессенджеры / Telegram''' и нажмите '''Добавить бота''':
+
Для подключения созданного бота в ПланФикс, перейдите в раздел '''Управление аккаунтом / Интеграции / Мессенджеры / Telegram''' и нажмите '''Добавить бота''':
  
  
https://pic.planfix.ru/pf/Qn/KMO74M.png
+
https://pic.planfix.ru/pf/PI/iqbDty.png
  
  
* в появившемся окне введите имя бота, список сотрудников, работающих с ботом, и ключ, полученный при его создании (он выделен красной рамкой на финальном скриншоте диалога с BotFather):
+
* в появившемся окне введите имя бота, ключ, полученный при его создании (он выделен красной рамкой на финальном скриншоте диалога с BotFather), укажите, по какому шаблону будут создаваться задачи по поступающим от бота сообщениям и по какому шаблону будет создаваться новый контакт, который отправит боту это сообщение, список сотрудников, которых нужно подключить [[Дополнительное подключение сотрудников |дополнительно в качестве исполнителей]] (кроме указанных в шаблоне задачи) :
  
  
https://pic.planfix.ru/pf/Hm/Dvs0R9.png
+
https://p.pfx.so/pf/EF/nSupy6.png
 
 
 
 
* После добавления бота, вы сможете выбрать, по какому шаблону будут создаваться задачи по поступающим от бота сообщениям и по какому шаблону будет создаваться новый контакт, который отправит боту это сообщение:
 
 
 
 
 
https://pic.planfix.ru/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 нельзя.
  • Возможность создания собственного бота доступна только для платных пакетов ПланФикса.


Перейти