Как создать собственного бота Telegram

Материал из Planfix

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

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

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

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

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

Для подключения созданного бота перейдите в раздел Управление аккаунтом — Интеграции — Мессенджеры — Telegram — Собственный бот и нажмите кнопку "Добавить бота".

В появившемся окне:

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

Автоматическое создание задач

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

  • Автоматически создавать задачу при запуске бота — задача создаётся, как только человек нажимает в вашем боте кнопку Старт или отправляет команду /start — ещё до того, как он напишет первое сообщение. Если такого человека нет в вашей системе, для него создаётся контакт. Когда опция выключена, нажатие Старт само по себе ничего не создаёт: задача появится только после первого настоящего сообщения боту.
  • Автоматически создавать задачу при добавлении бота в группу — задача создаётся, как только вашего бота добавляют в группу Telegram, и группа сразу привязывается к этой задаче — независимо от того, кто именно добавил бота. Когда опция выключена, задачу для группы создаёт сотрудник вручную, командой /task. Опция нужна, если группы для общения создают ваши клиенты и сами добавляют туда вашего бота: без неё такая переписка в систему не попадёт. Подробности: Подключение группы Telegram к ПланФиксу.

Опции интеграции Telegram

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

По умолчанию опция включена:

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

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

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

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

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

Важно

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

Перейти