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

Версия от 18:26, 25 января 2018

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

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

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

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

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

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

/task <Название новой> или номер существующей без знаков <> – Привязать задачу (новую или существующую) к чату. После привязки новые сообщения, поступающие в задачу, будут транслироваться в чат, а сообщения из чата будут транслироваться в задачу.

/project <Название нового> или номер существующего без знаков <> – Указать в каком проекте (новом или существующем) создавать новые задачи:

/find <текст запроса> – найти проекты и задачи, содержащие в названии текст запроса. Найденные проекты и задачи будут перечислены вместе с их номерами – это поможет найти номер проекта/задачи, к которым вы хотите привязать чат.

/suspend – Управление трансляцией чата в ПланФикс: /suspend on отключает трансляцию, /suspend off – опять включает.

/status – Выдает информацию о чате: к какому проекту/задаче он привязан и включена ли трансляция из чата в задачу.

/endtask – Отвязать задачу от чата.

/endproject – Отвязать проект от чата.

Уведомления о новых комментариях, добавленных в группе телеграмм, получат исполнители привязанной задачи. Уведомить других лиц, присутствующих в задаче (постановщика, участника и т.п.), можно написав в сообщении @имя_участника (точные варианты доступны по команде /who).

Полезно

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

Перейти

Интеграции

@@ Строка 3: / Строка 3: @@
 *транслировать в задачу ПланФикса то, что добавляется в чате.
-Кроме этого, бот умеет создавать [[Задачи|задачи]] и [[Проекты|проекты]] в ПланФиксе, а также переключаться между ними.
+Кроме этого, бот умеет создавать [[Задачи|задачи]] и [[Проекты|проекты]] в ПланФиксе, а также переключаться между ними. Все это позволяет работать в ПланФиксе прямо из чата Telegram.
-* Чат можно привязывать не только к задаче, но и к проекту. Это позволяет по команде из чата создавать задачи в этом проекте. При этом используется [[Шаблоны задач в рамках шаблонов проектов|шаблон задачи]], который выбран для этого проекта по умолчанию.
-* Бот может работать с разнообразным контентом: помимо текстовых сообщений, он работает с фото и видео,голосовыми сообщениями, контактами и геометками.
-* Возможно получить прямой интерфейс e-mail – Telegram, привязав чат к задаче, в которой участвуют клиенты, работающие в рамках этой задачи по [[Работа в ПланФиксе с помощью e-mail|e-mail]]. Обратите внимание: уведомление клиенту по e-mail уйдет только в том случае, если в чате к нему обратятся напрямую через '''@'''.
 == Настройка стандартного бота ПланФикса для Telegram ==
-# Включите уведомления в Telegram, чтобы привязать бота к своей [[Аккаунт|учетной записи]] ПланФикса, как это описано выше. Это же должен сделать каждый участник чата, который работает в ПланФиксе – тогда его сообщения в чате будут попадать в ПланФикс от его имени. Если этого не сделать, при получении сообщения из чата в ПланФиксе будет автоматически создан новый контакт и сообщение будет добавлено от его имени.
+# Пройдите [[Авторизация Telegram в ПланФиксе | авторизацию]], чтобы привязать бота к своей [[Аккаунт|учетной записи]] ПланФикса. Это же должен сделать каждый участник чата, который работает в ПланФиксе – тогда его сообщения в чате будут попадать в ПланФикс от его имени. Если этого не сделать, при получении сообщения из чата в ПланФиксе будет автоматически создан новый контакт и сообщение будет добавлено от его имени.
-# Добавьте бота ПланФикса в нужный чат Телеграма. Обратите внимание: это делается в настройках группы, как добавление обычного участника:
+# Добавьте бота ПланФикса в нужный чат (группу) Телеграма. Обратите внимание: это делается в настройках группы, как добавление обычного участника:
@@ Строка 19: / Строка 15: @@
-. Используйте команды боту для совершения действий.
+# Используйте команды боту для совершения действий:
-== Работа с ботом по уведомлениям из задач ==
-Работая с ботом PlanFix, вы можете использовать команды для ответа на уведомления из задач.
-Эти команды применяются при непосредственной работе с ботом, т.е. при ответах на уведомления через '''Reply.''' (Для ответа на уведомления надо выбрать нужное и нажать '''Reply''' - текст вашего ответа попадет в задачу.)
-* '''/who''' – Показывает всех участников задачи, на уведомление из которой вы отвечаете, и их роли в задаче. Помогает в том числе увидеть имя для прямой адресации через '''@'''.
-* '''/whom''' -  Показывает уведомленных по этому действию участников задачи.
-* '''/help''' – Выдает справку по командам бота.
-==Работа со стандартным ботом, добавленным в общий чат (группу Telegram)==
-После добавления бота PlanFix в группу, вы можете использовать команды для управления ботом.
-Эти команды применяются при работе в группе (общем чате с несколькими участниками и подключенным ботом) и позволяют вести работу в PlanFix прямо из чата Telegram.
 * '''/task <Название новой> или номер существующей без знаков <>''' – Привязать задачу (новую или существующую) к чату. После привязки новые сообщения, поступающие в задачу, будут транслироваться в чат, а сообщения из чата будут транслироваться в задачу.
@@ Строка 56: / Строка 34: @@
 Уведомить других лиц, присутствующих в задаче (постановщика, участника и т.п.), можно написав в сообщении @имя_участника (точные варианты доступны по команде /who).
+[[Полезно]]
+* Чат можно привязывать не только к задаче, но и к проекту. Это позволяет по команде из чата создавать задачи в этом проекте. При этом используется [[Шаблоны задач в рамках шаблонов проектов|шаблон задачи]], который выбран для этого проекта по умолчанию.
+* Бот может работать с разнообразным контентом: помимо текстовых сообщений, он работает с фото и видео,голосовыми сообщениями, контактами и геометками.
+* Возможно получить прямой интерфейс e-mail – Telegram, привязав чат к задаче, в которой участвуют клиенты, работающие в рамках этой задачи по [[Работа в ПланФиксе с помощью e-mail|e-mail]]. Обратите внимание: уведомление клиенту по e-mail уйдет только в том случае, если в чате к нему обратятся напрямую через '''@'''.
+*Вы можете добавить контакт в ПланФикс, отправив его из адресной книги стандартному боту ПланФикса для Telegram. [[Добавление контактов через бот для Telegram| Подробнее]]