# Подключение ПланФикса

Интеграция позволяет боту искать и сохранять контакты, создавать CRM-задачи, менять разрешённые статусы, добавлять задачи и комментарии, возвращать ссылки на записи ПланФикса.

ПланФикс подключается как источник данных. Эта версия не принимает события автоматизации и не подключает переписку через Chat API.

# Подготовка в ПланФиксе

Потребуются права администратора для настройки API, доступный REST API в тарифе ПланФикса и подписка на интеграцию в ChatRex. Подписка ChatRex оформляется внутри ChatRex.

1. В ПланФиксе откройте Account management → API → REST API. Здесь и далее приведены названия английского интерфейса Planfix.
2. Создайте отдельного робота для интеграции. Выберите его при создании токена. Он должен иметь доступ к контактам, шаблонам, процессам и задачам, с которыми будет работать бот.
3. Создайте токен, разрешив Common metadata, чтение процессов, проектов и сотрудников, чтение/создание/изменение контактов и задач, добавление комментариев. Удаление данных и изменение сотрудников для этой интеграции не требуются.
4. Сохраните токен в защищённом месте. В ChatRex потребуется токен, а не пароль от Planfix.
5. Подготовьте процесс и шаблон задачи для обращений клиентов. В проверенном интерфейсе они находятся в Account management → Types of objects → Task → Processes и Task → Templates. Шаблон должен относиться к выбранному процессу.

Если в аккаунте доступны только новые Objects, проверьте, что нужные шаблон и процесс также доступны через REST API. Не выбирайте другой процесс только ради завершения подключения.

# Подключение в ChatRex

1. Откройте Интеграции → Подключить интеграцию → Источники данных и выберите ПланФикс.
2. Укажите HTTPS-адрес аккаунта, например https://company.planfix.com, и вставьте токен.
3. Нажмите Подключить. Дождитесь статуса подключения и проверьте адрес аккаунта.
4. После подключения откроется выбор подписки. Оформите подходящую подписку штатным способом.
5. Во вкладке Настройки выберите Владельца API-токена — сотрудника или робота, которому выдан этот токен. ChatRex использует его часовой пояс для сроков задач.
6. При необходимости включите Менять статус без уведомлений в Planfix и нажмите Сохранить.

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

Шаблоны и статусы загружаются из подключённого аккаунта. После изменения процесса выберите зависимые значения заново. Если справочники изменились в Planfix, нажмите Обновить справочники, проверьте выбор и сохраните настройки.

Режим Только находить существующие запрещает создание новых контактов. Находить или создавать с согласия клиента разрешает создание после согласия клиента. По умолчанию бот ищет точное совпадение телефона, затем email; поиск по одному имени не выполняется. Если телефон и email относятся к разным контактам, запись останавливается.

Тихий режим применяется к изменению статуса задачи. Он не отключает уведомления при создании задач или добавлении комментариев.

# Подключение к боту и проверка

Добавьте действия в разделе бота Интеграции и действия или создайте бота по шаблону AI-консультант с ПланФиксом. Выберите подключённый аккаунт и сохраните настройки. Параметры CRM задаются отдельно в каждом действии и не меняют настройки других ботов. Условия запуска, согласие клиента и передачу менеджеру задавайте в поведении бота. Старые действия сохраняют прежние параметры; при редактировании проверьте их в самом действии.

На отдельном тестовом контакте проверьте поиск, сохранение, создание CRM-задачи, изменение статуса, связанную задачу, комментарий и ссылку. Полный список параметров — в статье ПланФикс: действия бота.

CRM-заявка хранится в Planfix как задача выбранного шаблона и процесса. Перед созданием проверяется существующая активная CRM-задача контакта; при нескольких совпадениях бот передаёт вопрос менеджеру.

Изменение статуса может ожидать подтверждения Planfix. До подтверждения бот не должен сообщать об успехе. Если результат записи неизвестен, не запускайте создание заново: сначала проверьте запись в Planfix.

# Отключение

Откройте карточку ПланФикса и нажмите Отключить. ChatRex удалит сохранённый токен и прекратит выполнять действия. Для полного отзыва доступа удалите токен в разделе REST API самого Planfix.

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

При отзыве токена соединение становится неактивным. Создайте новый токен с нужными правами и повторите подключение.