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