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