Работа с ботом ПланФикса для Telegram: различия между версиями
Материал из Planfix
Artem (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) Нет описания правки |
||
(не показаны 3 промежуточные версии этого же участника) | |||
Строка 14: | Строка 14: | ||
*Используйте команды боту для совершения действий: | *Используйте команды боту для совершения действий: | ||
*'''/task <Название новой> или номер существующей без знаков <>''' – Привязать задачу (новую или существующую) к чату. После привязки новые сообщения, поступающие в задачу, будут транслироваться в чат, а сообщения из чата будут транслироваться в задачу. | **'''/task <Название новой> или номер существующей без знаков <>''' – Привязать задачу (новую или существующую) к чату. После привязки новые сообщения, поступающие в задачу, будут транслироваться в чат, а сообщения из чата будут транслироваться в задачу. | ||
*'''/project <Название нового> или номер существующего без знаков <>''' – Указать в каком проекте (новом или существующем) создавать новые задачи: | **'''/project <Название нового> или номер существующего без знаков <>''' – Указать в каком проекте (новом или существующем) создавать новые задачи: | ||
*'''/find <текст запроса>''' – найти проекты и задачи, содержащие в названии текст запроса. Найденные проекты и задачи будут перечислены вместе с их номерами – это поможет найти номер проекта/задачи, к которым вы хотите привязать чат. | **'''/find <текст запроса>''' – найти проекты и задачи, содержащие в названии текст запроса. Найденные проекты и задачи будут перечислены вместе с их номерами – это поможет найти номер проекта/задачи, к которым вы хотите привязать чат. | ||
*'''/suspend''' – Управление трансляцией чата в ПланФикс: '''/suspend on''' отключает трансляцию, '''/suspend off''' – опять включает. | **'''/suspend''' – Управление трансляцией чата в ПланФикс: '''/suspend on''' отключает трансляцию, '''/suspend off''' – опять включает. | ||
*'''/status''' – Выдает информацию о чате: к какому проекту/задаче он привязан и включена ли трансляция из чата в задачу. | **'''/status''' – Выдает информацию о чате: к какому проекту/задаче он привязан и включена ли трансляция из чата в задачу. | ||
*'''/changeaccount''' – Меняет аккаунты, если подписка на уведомления в Telegram подключена в нескольких аккаунтах. | **'''/changeaccount''' – Меняет аккаунты, если подписка на уведомления в Telegram подключена в нескольких аккаунтах. | ||
*'''/endtask''' – Отвязать задачу от чата. | **'''/endtask''' – Отвязать задачу от чата. | ||
*'''/endproject''' – Отвязать проект от чата. | **'''/endproject''' – Отвязать проект от чата. | ||
*Уведомления о новых комментариях, добавленных в группе телеграмм, получат исполнители привязанной задачи. Уведомить других лиц, присутствующих в задаче (постановщика, участника и т.п.), можно написав в сообщении @имя_участника (точные варианты доступны по команде /who). Для того, чтобы уведомления в ПланФиксе получали только пользователи, участвующие в чате Телеграм, используйте команду '''/notify active'''. | **Уведомления о новых комментариях, добавленных в группе телеграмм, получат исполнители привязанной задачи. Уведомить других лиц, присутствующих в задаче (постановщика, участника и т.п.), можно написав в сообщении @имя_участника (точные варианты доступны по команде /who). Для того, чтобы уведомления в ПланФиксе получали только пользователи, участвующие в чате Телеграм, используйте команду '''/notify active'''. | ||
*Полный список команд бота с описаниями доступен по команде '''/help'''. | **Полный список команд бота с описаниями доступен по команде '''/help'''. | ||
Строка 33: | Строка 33: | ||
*Создаем в проекте новую задачу: | *Создаем в проекте новую задачу: | ||
: | :— Вводим команду создания задачи '''/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'''. Дальнейшая переписка не будет уходить в ПланФикс: | ||
https://p.pfx.so/pf/Em/6rP6pm.png | https://p.pfx.so/pf/Em/6rP6pm.png | ||
== | == Важно == | ||
*Из привязанного чата Telegram в задачу транслируются любые сообщения Контактов. | |||
*Если у сотрудников нет доступа к задаче, к которой привязан чат Telegram, то их сообщения не транслируются в ПланФикс. | |||
*Чат можно привязывать не только к задаче, но и к проекту. Это позволяет по команде из чата создавать задачи в этом проекте. При этом используется [[Шаблоны задач в рамках шаблонов проектов|шаблон задачи]], который выбран для этого проекта по умолчанию. | *Чат можно привязывать не только к задаче, но и к проекту. Это позволяет по команде из чата создавать задачи в этом проекте. При этом используется [[Шаблоны задач в рамках шаблонов проектов|шаблон задачи]], который выбран для этого проекта по умолчанию. | ||
*Если чат привязан к проекту, но не привязан к задаче, комментарии из чата транслироваться в ПланФикс не будут. | *Если чат привязан к проекту, но не привязан к задаче, комментарии из чата транслироваться в ПланФикс не будут. |
Текущая версия от 14:13, 25 ноября 2021
Стандартный бот ПланФикса для Telegram @planfix_bot является связующим звеном чата в Телеграм и ПланФикса. Он может передавать информацию в обе стороны:
- транслировать в чат сообщения, приходящие в задачу ПланФикса
- транслировать в задачу ПланФикса то, что добавляется в чате.
Кроме этого, бот умеет создавать задачи и проекты в ПланФиксе, а также переключаться между ними. Все это позволяет работать в ПланФиксе прямо из чата Telegram.
Настройка стандартного бота ПланФикса для Telegram
- Пройдите авторизацию, чтобы привязать бота к своей учетной записи ПланФикса. Это же должен сделать каждый участник чата, который работает в ПланФиксе – тогда его сообщения в чате будут попадать в ПланФикс от его имени. Если этого не сделать, при получении сообщения из чата в ПланФиксе будет автоматически создан новый контакт и сообщение будет добавлено от его имени.
- Добавьте бота ПланФикса в нужный чат (группу) Телеграма. Обратите внимание: это делается в настройках группы, как добавление обычного участника:
- Используйте команды боту для совершения действий:
- /task <Название новой> или номер существующей без знаков <> – Привязать задачу (новую или существующую) к чату. После привязки новые сообщения, поступающие в задачу, будут транслироваться в чат, а сообщения из чата будут транслироваться в задачу.
- /project <Название нового> или номер существующего без знаков <> – Указать в каком проекте (новом или существующем) создавать новые задачи:
- /find <текст запроса> – найти проекты и задачи, содержащие в названии текст запроса. Найденные проекты и задачи будут перечислены вместе с их номерами – это поможет найти номер проекта/задачи, к которым вы хотите привязать чат.
- /suspend – Управление трансляцией чата в ПланФикс: /suspend on отключает трансляцию, /suspend off – опять включает.
- /status – Выдает информацию о чате: к какому проекту/задаче он привязан и включена ли трансляция из чата в задачу.
- /changeaccount – Меняет аккаунты, если подписка на уведомления в Telegram подключена в нескольких аккаунтах.
- /endtask – Отвязать задачу от чата.
- /endproject – Отвязать проект от чата.
- Уведомления о новых комментариях, добавленных в группе телеграмм, получат исполнители привязанной задачи. Уведомить других лиц, присутствующих в задаче (постановщика, участника и т.п.), можно написав в сообщении @имя_участника (точные варианты доступны по команде /who). Для того, чтобы уведомления в ПланФиксе получали только пользователи, участвующие в чате Телеграм, используйте команду /notify active.
- Полный список команд бота с описаниями доступен по команде /help.
Пример использования бота
- Подключаем бот к нужному проекту при помощи команды /project:
- Создаем в проекте новую задачу:
- — Вводим команду создания задачи /task с желаемым названием новой задачи:
- — Подтверждаем создание задачи:
- — Выбираем вариант с привязкой чата к созданной задаче (последующие комментарии будут попадать в нее) или без привязки (комментарии из чата никуда не попадут):
- — После завершения переписки, которая должна попасть в задачу, чат можно отвязать от задачи командой /endtask. Дальнейшая переписка не будет уходить в ПланФикс:
Важно
- Из привязанного чата Telegram в задачу транслируются любые сообщения Контактов.
- Если у сотрудников нет доступа к задаче, к которой привязан чат Telegram, то их сообщения не транслируются в ПланФикс.
- Чат можно привязывать не только к задаче, но и к проекту. Это позволяет по команде из чата создавать задачи в этом проекте. При этом используется шаблон задачи, который выбран для этого проекта по умолчанию.
- Если чат привязан к проекту, но не привязан к задаче, комментарии из чата транслироваться в ПланФикс не будут.
- Бот может работать с разнообразным контентом: помимо текстовых сообщений, он работает с фото и видео,голосовыми сообщениями, контактами и геометками.
- Возможно получить прямой интерфейс e-mail – Telegram, привязав чат к задаче, в которой участвуют клиенты, работающие в рамках этой задачи по e-mail. Обратите внимание: уведомление клиенту по e-mail уйдет только в том случае, если в чате к нему обратятся напрямую через @.
- Вы можете добавить контакт в ПланФикс, отправив его из адресной книги стандартному боту ПланФикса для Telegram. Подробнее
- При помощи автоматических сценариев вы можете добавлять собственные команды для Telegram-бота