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

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

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

Чтобы создать собственного бота в Telegram:

нажмите эту ссылку (на этом устройстве должен быть запущен Telegram);
в окне приветствия нажмите кнопку «Начать»;
в окне чата с @BotFather введите команду /newbot;
когда появится запрос, введите имя нового бота. Имя должно оканчиваться на «bot» или «_bot». Желательно выбрать имя, которое как-то связано с вашей компанией или сферой деятельности. Например, компания BrainStorm может назвать бота BrainstormAgencyBot или BrainstormAgency_bot. После ввода имени нажмите Enter;
затем BotFather предложит ввести имя пользователя для бота. В отличие от имени, имя пользователя должно быть уникальным в Telegram, поэтому для распространённых вариантов может быть сложно найти свободное. Если имя уже занято, BotFather сообщит об этом и предложит ввести другое. Когда вы укажете уникальное имя, создание бота завершится, и вы получите токен, который понадобится для дальнейшей работы.

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

Чтобы подключить созданного бота к Planfix, перейдите в раздел Управление аккаунтом / Интеграции / Мессенджеры / Telegram и нажмите «Добавить бота». В появившемся окне:

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

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

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

Автоматически создавать задачу при запуске бота — задача создаётся, как только человек нажимает кнопку «Начать» в вашем боте или отправляет команду /start, ещё до того, как отправит первое сообщение. Если этого человека нет в системе, для него будет создан контакт. Если параметр выключен, одного нажатия кнопки «Начать» недостаточно: задача появится только после отправки первого сообщения боту.
Автоматически создавать задачу при добавлении бота в группу — задача создаётся сразу после того, как бота добавляют в группу Telegram, и группа сразу связывается с этой задачей — независимо от того, кто добавил бота. Если параметр выключен, сотруднику нужно вручную создать задачу для группы с помощью команды /task. Этот параметр пригодится, если клиенты создают группы для общения и сами добавляют в них вашего бота: без него такая переписка не попадёт в систему. Подробнее: Подключение группы Telegram к Planfix.

Параметры интеграции с Telegram

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

По умолчанию параметр включён:

если параметр включён, новая задача будет создана, если предыдущая задача клиента была удалена, завершена или имеет неактивный Статус. История сообщений автоматически добавится в описание созданной задачи;
если параметр выключен, все сообщения клиента будут поступать в одну задачу независимо от её текущего Статуса.

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

Когда клиент отправляет сообщение вашему боту, его имя пользователя в Telegram автоматически добавляется в системное поле «Telegram» в Planfix. Это имя становится ссылкой, которая ведёт прямо к переписке с клиентом в десктопной версии мессенджера.

Обратите внимание: поле «Telegram» заполняется, только если у клиента в мессенджере указано имя пользователя, начинающееся с @, и настройки конфиденциальности позволяют получить эту информацию.

При нажатии на ссылку откроется диалог с контактом в десктопной версии мессенджера. Эта функция создана для удобства.

Важно

Начать переписку в Telegram из Planfix нельзя.
Создавать собственных ботов можно только в платных тарифах Planfix.