Робота з ботом Planfix для Telegram

Матеріал з Planfix

Стандартний бот Planfix для Telegram @planfix_bot є зв'язком між чатом у Telegram і Planfix. Він може передавати інформацію в обидві сторони:

  • транслювати в чат повідомлення, що надходять у завдання Planfix
  • транслювати в завдання Planfix те, що додається в чаті.

Окрім цього, бот вміє створювати завдання і проєкти в Planfix, а також переключатися між ними. Усе це дозволяє працювати в Planfix прямо з чату Telegram.


Налаштування стандартного бота Planfix для Telegram

  • Пройдіть авторизацію, щоб прив'язати бота до свого облікового запису Planfix. Це ж повинен зробити кожен учасник чату, який працює в Planfix – тоді його повідомлення в чаті будуть потрапляти в Planfix від його імені. Якщо цього не зробити, при отриманні повідомлення з чату в Planfix автоматично буде створений новий контакт і повідомлення буде додано від його імені.
  • Додайте бота Planfix у потрібний чат (групу) Telegram. Зверніть увагу: це робиться в налаштуваннях групи, як додавання звичайного учасника:

bcTg8x.png


  • Використовуйте команди боту для виконання дій:
    • /task <Назва нової> або номер існуючої без знаків <> – Прив'язати завдання (нове або існуюче) до чату. Після прив'язки нові повідомлення, що надходять у завдання, будуть транслюватися в чат, а повідомлення з чату будуть транслюватися в завдання.
    • /project <Назва нового> або номер існуючого без знаків <> – Вказати, у якому проєкті (новому або існуючому) створювати нові завдання:
    • /find <текст запиту> – знайти проєкти і завдання, що містять у назві текст запиту. Знайдені проєкти і завдання будуть перераховані разом із їхніми номерами – це допоможе знайти номер проєкту/завдання, до яких ви хочете прив'язати чат.
    • /suspend – Керування трансляцією чату в Planfix: /suspend on відключає трансляцію, /suspend off – знову вмикає.
    • /status – Видає інформацію про чат: до якого проєкту/завдання він прив'язаний і чи увімкнена трансляція з чату в завдання.
    • /changeaccount – Змінює акаунти, якщо підписка на сповіщення в Telegram підключена в кількох акаунтах.
    • /endtask – Відв'язати завдання від чату.
    • /endproject – Відв'язати проєкт від чату.
    • Сповіщення про нові коментарі, додані в групі Telegram, отримають виконавці прив'язаного завдання. Повідомити інших осіб, присутніх у завданні (постановник, учасник тощо), можна, написавши в повідомленні @ім'я_учасника (точні варіанти доступні за командою /who). Щоб сповіщення в Planfix отримували лише користувачі, які беруть участь у чаті Telegram, використовуйте команду /notify active.
    • Повний список команд бота з описами доступний за командою /help.


Приклад використання бота

  • Підключаємо бота до потрібного проєкту за допомогою команди /project:

gGNLyV.png


  • Створюємо в проєкті нове завдання:
— Вводимо команду створення завдання /task з бажаною назвою нового завдання:

JlrYp6.png


— Підтверджуємо створення завдання:

6MIhBJ.png


— Обираємо варіант з прив'язкою чату до створеного завдання (наступні коментарі потраплятимуть у нього) або без прив'язки (коментарі з чату нікуди не потраплять):

iEzKaR.png


— Після завершення листування, яке повинно потрапити в завдання, чат можна відв'язати від завдання командою /endtask. Подальше листування не буде відправлятися в Planfix:

6rP6pm.png


Важливо

  • З прив'язаного чату Telegram у завдання транслюються будь-які повідомлення Контрагентів.
  • Якщо в співробітників немає доступу до завдання, до якого прив'язаний чат Telegram, то їхні повідомлення не транслюються в Planfix.
  • Чат можна прив'язувати не лише до завдання, а й до проєкту. Це дозволяє за командою з чату створювати завдання в цьому проєкті. При цьому використовується шаблон завдання, який обраний для цього проєкту за замовчуванням.
  • Якщо чат прив'язаний до проєкту, але не прив'язаний до завдання, коментарі з чату транслюватися в Planfix не будуть.
  • Бот може працювати з різноманітним контентом: окрім текстових повідомлень, він працює з фото і відео, голосовими повідомленнями, контактами і геомітками.
  • Можливо отримати прямий інтерфейс e-mail – Telegram, прив'язавши чат до завдання, в якому беруть участь клієнти, які працюють у рамках цього завдання по e-mail. Зверніть увагу: повідомлення клієнту по e-mail буде відправлене лише в тому випадку, якщо в чаті до нього звернуться безпосередньо через @.
  • Ви можете додати контакт у Planfix, надіславши його з адресної книги стандартному боту Planfix для Telegram. Детальніше
  • За допомогою автоматичних сценаріїв ви можете додавати власні команди для Telegram-бота


Перейти