Работа с ботом ПланФикса для Telegram: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
Строка 7: Строка 7:


== Настройка стандартного бота ПланФикса для Telegram ==
== Настройка стандартного бота ПланФикса для Telegram ==
# Пройдите [[Авторизация Telegram в ПланФиксе | авторизацию]], чтобы привязать бота к своей [[Аккаунт|учетной записи]] ПланФикса. Это же должен сделать каждый участник чата, который работает в ПланФиксе – тогда его сообщения в чате будут попадать в ПланФикс от его имени. Если этого не сделать, при получении сообщения из чата в ПланФиксе будет автоматически создан новый контакт и сообщение будет добавлено от его имени.
#Пройдите [[Авторизация Telegram в ПланФиксе | авторизацию]], чтобы привязать бота к своей [[Аккаунт|учетной записи]] ПланФикса. Это же должен сделать каждый участник чата, который работает в ПланФиксе – тогда его сообщения в чате будут попадать в ПланФикс от его имени. Если этого не сделать, при получении сообщения из чата в ПланФиксе будет автоматически создан новый контакт и сообщение будет добавлено от его имени.
# Добавьте бота ПланФикса в нужный чат (группу) Телеграма. Обратите внимание: это делается в настройках группы, как добавление обычного участника:
#Добавьте бота ПланФикса в нужный чат (группу) Телеграма. Обратите внимание: это делается в настройках группы, как добавление обычного участника:


https://p.pfx.so/pf/cc/bcTg8x.png
https://p.pfx.so/pf/cc/bcTg8x.png




3. Используйте команды боту для совершения действий:
#Используйте команды боту для совершения действий:
*'''/task <Название новой> или номер существующей без знаков <>''' – Привязать задачу (новую или существующую) к чату. После привязки новые сообщения, поступающие в задачу, будут транслироваться в чат, а сообщения из чата будут транслироваться в задачу.
*'''/task <Название новой> или номер существующей без знаков <>''' – Привязать задачу (новую или существующую) к чату. После привязки новые сообщения, поступающие в задачу, будут транслироваться в чат, а сообщения из чата будут транслироваться в задачу.
*'''/project <Название нового> или номер существующего без знаков <>''' – Указать в каком проекте (новом или существующем) создавать новые задачи:
*'''/project <Название нового> или номер существующего без знаков <>''' – Указать в каком проекте (новом или существующем) создавать новые задачи:

Версия от 12:48, 25 ноября 2021

Стандартный бот ПланФикса для Telegram @planfix_bot является связующим звеном чата в Телеграм и ПланФикса. Он может передавать информацию в обе стороны:

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

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


Настройка стандартного бота ПланФикса для Telegram

  1. Пройдите авторизацию, чтобы привязать бота к своей учетной записи ПланФикса. Это же должен сделать каждый участник чата, который работает в ПланФиксе – тогда его сообщения в чате будут попадать в ПланФикс от его имени. Если этого не сделать, при получении сообщения из чата в ПланФиксе будет автоматически создан новый контакт и сообщение будет добавлено от его имени.
  2. Добавьте бота ПланФикса в нужный чат (группу) Телеграма. Обратите внимание: это делается в настройках группы, как добавление обычного участника:

bcTg8x.png


  1. Используйте команды боту для совершения действий:
  • /task <Название новой> или номер существующей без знаков <> – Привязать задачу (новую или существующую) к чату. После привязки новые сообщения, поступающие в задачу, будут транслироваться в чат, а сообщения из чата будут транслироваться в задачу.
  • /project <Название нового> или номер существующего без знаков <> – Указать в каком проекте (новом или существующем) создавать новые задачи:
  • /find <текст запроса> – найти проекты и задачи, содержащие в названии текст запроса. Найденные проекты и задачи будут перечислены вместе с их номерами – это поможет найти номер проекта/задачи, к которым вы хотите привязать чат.
  • /suspend – Управление трансляцией чата в ПланФикс: /suspend on отключает трансляцию, /suspend off – опять включает.
  • /status – Выдает информацию о чате: к какому проекту/задаче он привязан и включена ли трансляция из чата в задачу.
  • /changeaccount – Меняет аккаунты, если подписка на уведомления в Telegram подключена в нескольких аккаунтах.
  • /endtask – Отвязать задачу от чата.
  • /endproject – Отвязать проект от чата.
  • Уведомления о новых комментариях, добавленных в группе телеграмм, получат исполнители привязанной задачи. Уведомить других лиц, присутствующих в задаче (постановщика, участника и т.п.), можно написав в сообщении @имя_участника (точные варианты доступны по команде /who). Для того, чтобы уведомления в ПланФиксе получали только пользователи, участвующие в чате Телеграм, используйте команду /notify active.
  • Полный список команд бота с описаниями доступен по команде /help.


Пример использования бота

  • Подключаем бот к нужному проекту при помощи команды /project:

gGNLyV.png


  • Создаем в проекте новую задачу:
  • Вводим команду создания задачи /task с желаемым названием новой задачи:

JlrYp6.png


  • Подтверждаем создание задачи:

6MIhBJ.png


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

iEzKaR.png


  • После завершения переписки, которая должна попасть в задачу, чат можно отвязать от задачи командой /endtask. Дальнейшая переписка не будет уходить в ПланФикс:

6rP6pm.png


Полезно

  • Чат можно привязывать не только к задаче, но и к проекту. Это позволяет по команде из чата создавать задачи в этом проекте. При этом используется шаблон задачи, который выбран для этого проекта по умолчанию.
  • Если чат привязан к проекту, но не привязан к задаче, комментарии из чата транслироваться в ПланФикс не будут.
  • Бот может работать с разнообразным контентом: помимо текстовых сообщений, он работает с фото и видео,голосовыми сообщениями, контактами и геометками.
  • Возможно получить прямой интерфейс e-mail – Telegram, привязав чат к задаче, в которой участвуют клиенты, работающие в рамках этой задачи по e-mail. Обратите внимание: уведомление клиенту по e-mail уйдет только в том случае, если в чате к нему обратятся напрямую через @.
  • Вы можете добавить контакт в ПланФикс, отправив его из адресной книги стандартному боту ПланФикса для Telegram. Подробнее
  • При помощи автоматических сценариев вы можете добавлять собственные команды для Telegram-бота


Перейти