Kaiten

Документация и инструкции

Log in

Интеграция с Max

В Кайтене появилась интеграция с MAX. Теперь в нем можно получать уведомления, создавать карточки, отвечать на комментарии и обрабатывать заявки Service Desk. Отличная новость для команд, которые общаются в MAX и хотят быстрее реагировать на изменения без переключения между сервисами.


Что умеет интеграция

После подключения вы сможете:

— использовать MAX как канал уведомлений;
— создавать карточки и добавлять комментарии из мессенджера;
— работать с заявками Service Desk.

Вся работа происходит прямо в переписке с ботом.

Как подключить Max-бота

  1. Кликните на ваш аватар в правом верхнем углу Кайтена, затем «Настройки профиля».

  1. В открывшемся окне выберите раздел «Настройка уведомлений», вкладка «Боты».

  2. Выберите «Настроить Max-bot».

  1. Вам предложат перейти в чат с ботом Kaiten в Max. Нажмите «Запустить бота», чтобы открыть приложение. Если оно не установлено, откройте мессенджер в браузере.

  1. Напишите боту команду /start → почту, к которой привязан аккаунт в Кайтене, → подтвердите ее ПИН-кодом.

Для следующих шагов используйте команды:

/subscriptions — подписки на события досок
/options — пути создания карточек
/deadlines — срочные задачи и дедлайны
/disconnect — отвязать аккаунт
/help — справка
Чтобы быстро создать карточку — отправьте сообщение с текстом (названием карточки)

Как настроить личные уведомления в Max

Вариант 1. Через интерфейс Kaiten

  1. Откройте ваш профиль  → «Настройки профиля»  → «Настройка уведомлений».

  2. В столбце Max поставьте галочки напротив нужных вам уведомлений. Не забудьте сохранить.

  1. Также вы можете подписаться на события в определенных пространствах и колонках. Для этого перейдите в разделы «Подписки на пространства» и «Подписки на колонки» и выберите нужные опции.

Подробнее о подписке на карточки и пространства, читайте в статье «Как настроить уведомления в Kaiten»

Вариант 2. Настроить подписки прямо в боте

  1. Зайдите в бот Kaiten.

  2. Введите команду /subscriptions

  3. В появившемся меню выберите опцию «Личные сообщения»

  1. Далее нажмите кнопку «Добавить подписку» и выберите, на что хотите подписаться: аккаунт, пространства, доску, колонку или дорожку. А также выберите события, о которых хотите получать уведомления.

Как подключить уведомления для группового чата в Max

  1. Зайдите в бот Kaiten

  2. Введите команду /subscriptions

  3. В появившемся меню выберите опцию «Групповые чаты»

  1. Далее нажмите кнопку «Добавить групповой чат» и выберите чат, для которого хотите подключить уведомления.

  1. Далее выберите пространства, доски, колонки и дорожки, на которые хотите подписать ваш групповой чат.

  1. После выбора доски, колонки и/или дорожки, откроется меню с настройками созданной подписки. Здесь по умолчанию включены оповещения о создании и перемещении карточки. Для включения и выключения оповещений о событии достаточно кликнуть по одноименной кнопке меню.

Групповой чат можно подписать на разные события в разных колонках. Тогда все участники будут получать эти уведомления независимо от личных настроек в Кайтене.

Обратите внимание! Бота следует добавить в группу как обычного участника (не администратора), иначе на каждое сообщение в группе от участника, который не авторизовался в боте, бот будет присылать сообщение с просьбой авторизоваться.

Как создавать карточки через Max-бота

  1. Зайдите в бот Kaiten

  2. Введите и отправьте боту текстовое сообщение, например, «Задача из бота». Бот предложит создать карточку с текстом этого сообщения:

  1. Дальше при клике на «Создать карточку» бот предложит последовательно выбрать пространство, доску, колонку и дорожку.

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

Чтобы добавить или удалить путь, введите команду /options

Как оставлять комментарии к задачам через Max

В боте вы можете добавлять комментарии к карточкам, отвечать на комментарии коллег и даже прикреплять файлы.

Под уведомлением о действии с карточкой находятся 2 кнопки:

  • «Добавить комментарий» — нажмите, чтобы оставить комментарий в карточке, к которой относится уведомление.

  • «Ответить @username»  — нажмите, чтобы оставить комментарий с упоминанием автора действия, о котором пришло уведомление.

Как настроить Max-бота для модуля «Служба поддержки»

Заказчики могут создавать заявки в Службу поддержки, получать уведомления и отвечать на комментарии прямо в мессенджере Max. Для этого создайте и настройте бота.

Шаг 1. На сайте https://business.max.ru/ создайте бота.

Шаг 2. Выберите чат-бота, к которому хотите подключить «Службу поддержки». Нажмите «Получить токен».

В открывшемся окне скопируйте ключ.

Шаг 3. Зайдите в административный раздел «Служба поддержки» в Kaiten, откройте раздел «Бот MAX Messenger», введите скопированный ключ в поле и нажмите «Установить API-токен».

Шаг 4. Проверьте работу бота в Max.

Для этого перейдите в него и зарегистрируйтесь, отправив почту.

Для подтверждения почты ведите ПИН-код, который придет вам на указанный адрес.

Вам придет сообщение об успешной авторизации. В нем будут кнопки для подачи заявки и проверки их статуса.

Для следующих шагов используйте команды:

/list — открыть список всех заявок
/help — справка
/disconnect — отвязать аккаунт

Теперь пользователи могут открыть в Max вашего бота по ссылке и оставить заявку.

Обратите внимание: бот Службы поддержки не работает в Max-группах.

Полезные ссылки

Подписывайтесь на Kaiten в Max по ссылке.

Didn't find the answer to your question?

Create a request — we'll help you out

Submit a request