> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/kanaly/khelpdesk-sistemy/planfix.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.