# PlanFix

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

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

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

* Заходим в личный кабинет Савви во вкладку “**Боты**”
* Выбираем бота, которого хотим подключить
* Заходим во вкладку “**Каналы**”, нажимаем “**PlanFix**”:

<figure><img src="/files/GSx3aF4ifbBUPz3yseex" alt=""><figcaption></figcaption></figure>

В открывшемся окне нажимаем **Скопировать токен:**

<figure><img src="/files/vFfKERDCnwDjeN2Qmz54" alt=""><figcaption></figcaption></figure>

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

1. Заходим в личный кабинет **Planfix**
2. Нажимаем на кнопку с тремя полосками справа сверху и выбираем “**Управление аккаунтом**”:

<figure><img src="/files/XmIvILvqwopbrhOVdYVF" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/twhKZNnwrYqDXIZzum2o" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/Qbv2yDSjg6MPzi7R3gHH" alt=""><figcaption></figcaption></figure>

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

{% hint style="warning" %}
Новый пользователь обязательно должен быть создан с типом **сотрудник или робот**.

С типом контакт интеграция не будет корректно работать!
{% endhint %}

<figure><img src="/files/36TbwwRJq5uWR4YV2Wok" alt=""><figcaption></figcaption></figure>

6. Вставляем ранее скопированный токен авторизации и нажимаем “**Сохранить**”
7. Копируем **Адрес для API запросов:**

<figure><img src="/files/0JdxTaR8fiJGY6REjNTz" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/aJvtbrUcvWq3ecuMyK7a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/GOfuRT5i9UmdhkSTaREj" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/oQhmozVfqhS6MHFirMmw" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/4d7c2DK6vOFyagZKehlF" alt=""><figcaption></figcaption></figure>

1. В поле “**Метод**” выбираем “**POST**”
2. В поле “**URL**” вписываем “[https://api.suvvy.ai/api/webhook/planfix](https://api.suvvy.ai/api/wehbook/planfix)”. Вебхук также можно скопировать в разделе интеграции Савви:<br>

   <figure><img src="/files/ue1723nMHd0QGURfF6xg" alt=""><figcaption></figcaption></figure>
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": "{{Комментарий.Прикрепленные файлы.Имя}}"`\
`}`

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

<figure><img src="/files/NxZlUr2kAANRvPusrobU" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**ВАЖНО**: В пункте “**Автор комментария**" обязательно выбираем **Не равно**, а затем выбираем сотрудника, которого мы создали во втором пункте на моменте создания токена
{% endhint %}

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

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

<figure><img src="/files/4d7c2DK6vOFyagZKehlF" alt=""><figcaption></figcaption></figure>

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

### **Авторизация Planfix в Савви**

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

<figure><img src="/files/2VBiz8gZF42DzkGaTtZ2" alt=""><figcaption></figcaption></figure>

Где:

* **API ключ** = скопированный "Токен авторизации"
* **Домен личного кабинета Планфикс!** = скопированный **"**&#x410;дрес для API запросов"

Нажимаем “**Подключить**”.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.suvvy.ai/ru/kanaly/khelpdesk-sistemy/planfix.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.