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

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




== Пример использования бота ==
== Пример использования бота ==
*Подключаем бот к нужному проекту при помощи команды '''/project''':
*Подключаем бот к нужному проекту при помощи команды '''/project''':


https://p.pfx.so/pf/vo/gGNLyV.png
https://p.pfx.so/pf/vo/gGNLyV.png
Строка 44: Строка 33:


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


https://p.pfx.so/pf/YG/JlrYp6.png
https://p.pfx.so/pf/YG/JlrYp6.png




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


https://p.pfx.so/pf/pN/6MIhBJ.png
https://p.pfx.so/pf/pN/6MIhBJ.png




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


https://p.pfx.so/pf/nB/iEzKaR.png
https://p.pfx.so/pf/nB/iEzKaR.png




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


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


https://p.pfx.so/pf/nB/iEzKaR.png


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


== Перейти ==
== Перейти ==
[[Telegram]]
*[[Telegram]]
 
*[[Интеграции]]
[[Интеграции]]

Текущая версия от 14:13, 25 ноября 2021

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

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

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


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

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

bcTg8x.png


  • Используйте команды боту для совершения действий:
    • /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


Важно

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


Перейти