PlanFix

Подключение “PlanFix” к боту Савви

Подключение состоит из нескольких пунктов:

Получение токена бота Савви

• Заходим в личный кабинет Савви во вкладку “Боты”

• Выбираем бота, которого хотим подключить

• Заходим во вкладку “Каналы”, нажимаем “Показать токен”, а затем копируем его:

Получение токена Planfix

1. Заходим в личный кабинет Planfix

2. Нажимаем на кнопку с тремя полосками справа сверху и выбираем “Управление аккаунтом”:

1. Выбираем “Доступ к API” в левом меню

1. Нажимаем “REST API”, а затем “Создать новый токен”

1. В открывшемся меню вписываем любое название, создаем нового, отдельного сотрудника СПЕЦИАЛЬНО для бота Савви, а также выбираем “comment_add", "file_add" и "filereadonly” в поле “Разрешенные Scope”

1. Копируем наш свежесозданный токен авторизации и нажимаем “Сохранить”

2. Копируем Адрес для API запросов:

Добавление сценариев в Planfix

1. В том же меню “Управление аккаунтом” в левом меню выбираем пункт “Процессы задач”

1. Выбираем желаемый процесс, или создаем новый и выбираем в нём пункт “Автоматические сценарии” и нажимаем "Новый сценарий":

1. Создаем первый сценарий. Назовем его “Новое от клиента”. Первые два пункта настраиваем согласно картинке:

1. В 4 пункте выбираем “Послать HTTP запрос”

1. В поле “Метод” выбираем “POST”

2. В поле “URL” вписываем “https://api.suvvy.ai/api/webhook/planfix”

3. В поле “Заголовки”, в пункте, где “Content-Type” выбираем “application/json”

4. Добавляем новый заголовок, в появившемся пункте, в поле “Заголовок” вписываем “Authorization”, а в поле “Значение” вписываем “Bearer <токен Савви>”, где <токен Савви> - токен, полученный в первом пункте

5. Обязательно отмечаем галочки “url-кодировать значения полей”, а галочку “Добавлять комментарий в задачу, если сервер не отвечает” включаем по желанию

6. В поле “Содержимое запроса” копируем и вставляем следующий текст:

{ "text": "{{Комментарий.Текст}}", "sender": "customer", "task_id": "{{Задача.Номер}}", "task_name": "{{Задача.Название}}", "contact_name": "{{Задача.Постановщик.ФИО}}", "contact_id": "{{Задача.Постановщик.Номер}}", "file_ids":"{{Комментарий.Прикрепленные файлы.Идентификаторы}}", "file_names": "{{Комментарий.Прикрепленные файлы.Имя}}" }

1. Нажимаем “Сохранить”

2. Создаем второй сценарий с названием “Новое от сотрудника”, и заполняем первые два пункта согласно изображению:

1. Настраиваем 4 пункт точно также, как и в предыдущем сценарии, но в поле “Содержимое запроса” вписываем следующий текст:

   { "text": "{{Комментарий.Текст}}", "sender": "customer", "task_id": "{{Задача.Номер}}", "task_name": "{{Задача.Название}}", "contact_name": "{{Задача.Постановщик.ФИО}}", "contact_id": "{{Задача.Постановщик.Номер}}", "file_ids":"{{Комментарий.Прикрепленные файлы.Идентификаторы}}", "file_names": "{{Комментарий.Прикрепленные файлы.Имя}}" }

1. Нажимаем “Сохранить”.

Авторизация Planfix в Suvvy

Теперь, скопированные "Токен авторизации" и "Адрес для API запросов" вставляем в соответствующие поля внутри интерфейса Савви:

Где:

• API ключ = скопированный "Токен авторизации"

• Домен личного кабинета Планфикс! = скопированный "Адрес для API запросов"

Нажимаем “Сохранить”.