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

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


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


https://p.pfx.so/pf/cc/bcTg8x.png
https://p.pfx.so/pf/cc/bcTg8x.png
Строка 16: Строка 14:


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


https://p.pfx.so/pf/vo/gGNLyV.png
https://p.pfx.so/pf/vo/gGNLyV.png
Строка 47: Строка 35:
*Создаем в проекте новую задачу:
*Создаем в проекте новую задачу:
:*Вводим команду создания задачи '''/task''' с желаемым названием новой задачи:
:*Вводим команду создания задачи '''/task''' с желаемым названием новой задачи:


https://p.pfx.so/pf/YG/JlrYp6.png
https://p.pfx.so/pf/YG/JlrYp6.png
Строка 53: Строка 40:


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


https://p.pfx.so/pf/pN/6MIhBJ.png
https://p.pfx.so/pf/pN/6MIhBJ.png
Строка 59: Строка 45:


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


https://p.pfx.so/pf/nB/iEzKaR.png
https://p.pfx.so/pf/nB/iEzKaR.png
Строка 65: Строка 50:


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


https://p.pfx.so/pf/Em/6rP6pm.png
https://p.pfx.so/pf/Em/6rP6pm.png




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

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

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

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

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


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

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

bcTg8x.png


3. Используйте команды боту для совершения действий:

  • /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-бота


Перейти