Документация / Интеграция с CRM-сервисами / Интеграция с Planfix

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

planfixпланфикстариф базы
Содержание

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

1 Перейдите в раздел добавления сервиса

В Vakas-Tools перейдите в Сервисы и доступы → Добавить сервис → ПланФикс.

2 Укажите название подключения

Укажите Название подключения (произвольное).

3 Введите домен

Введите Домен — полный адрес вашего аккаунта (например, https://ваш-аккаунт.planfix.ru).

4 Введите ключ API

Введите Ключ API — токен авторизации.

5 Сохраните

Нажмите «Добавить сервис».

Где взять ключ API: в ПланФикс перейдите в Управление аккаунтом → Доступ к API → REST API. Создайте новый ключ и скопируйте его. Ключи могут быть ограничены уровнями доступа — убедитесь, что у ключа есть права на контакты, задачи, проекты и кастомные поля.

После успешного подключения сервис появится в списке и станут доступны триггеры. И в базах уже добавьте сервис именно к базе с помощью кнопки [+Сервис].

Подключение ПланФикс
Добавление сервиса ПланФикс к базе

Как работает интеграция — общая схема

Передача данных настраивается через правила. На странице сервиса есть три вкладки: Регистрации, Отчёты, Заказы. На каждой вкладке — свой список правил.

Вкладки интеграции

Схема работы:

  1. Правило — определяет, при каких условиях передавать данные.
  2. Условия (внутри правила) — фильтруют, какие лиды попадут под это правило.
  3. Действия (кнопка напротив правила) — определяют, какое действие совершить и что именно передать в сервис.

Значок ⧉ — множественное добавление

Рядом с названием некоторых действий отображается зелёный значок ⧉ (два квадрата). Он означает, что это действие можно добавить несколько раз с разными настройками. При срабатывании триггера выполнятся все добавленные блоки.

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

То есть если добавишь два блока:

  • Блок 1: «Оплатил курс А»
  • Блок 2: «Промокод: SALE2025»

Сработает триггер → в Planfix к ученику добавятся два отдельных примечания.

Значок множественного добавления

Общие настройки

Открываются кнопкой «Общие настройки» на странице триггеров. Применяются ко всем триггерам данного подключения ПланФикс.

Общие настройки

Поиск дублей

Поле Описание Пример
Проверять на дубли / Не проверять Проверять — система ищет контакт по email и телефону. Если найден — работает с существующим. Не проверять — всегда создаёт новую запись. Проверять
Поиск дублей только в выбранных проектах Ограничивает поиск задач выбранными проектами. Чтобы выбрать несколько — зажмите CTRL. Если ничего не выбрано — ищет по всем проектам. —
Поиск дублей

Доп. поле для поиска дублей

Поле Описание Пример
Поле в ПланФикс Кастомное поле задачи, по которому дополнительно искать дубли. Номер заказа
Значение поля Значение для поиска. Поддерживает шорткоды. {#order_id#}

Значения по умолчанию

Поле Описание Пример
Название задачи Название для автоматически создаваемых задач. Поддерживает шорткоды. Новая заявка: {#name#}
Выполнение часов Количество часов на выполнение задачи. По умолчанию: 8. 8
Добавлять в проект Проект по умолчанию для новых задач. Выбирается из списка. Продажи
Шаблон Шаблон задачи. Определяет структуру и начальные значения. —
Процесс Процесс (workflow) по умолчанию. —

Когда используются значения по умолчанию: если при срабатывании триггера задача не найдена — система автоматически создаёт новую с этими параметрами.

Значения по умолчанию

Добавить правило

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

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

Добавить правило
Настройка правила

Настройка действий триггеров

Передача данных в ПланФикс настраивается через действия триггера. Нажмите кнопку «Действия» напротив нужного триггера — откроется конструктор действий.

Конструктор действий

Доступные действия:

Действие Описание
Добавить задачу Создаёт новую задачу в ПланФикс. Контакт создаётся или находится автоматически.
Поля задачи Обновляет кастомные поля задачи.
Статус задачи Изменяет статус задачи на выбранный.
Изменить менеджера Назначает нового ответственного для задачи.
Название сделки Изменяет название задачи.
Добавить примечание Добавляет текстовый комментарий к задаче. Можно добавить несколько.

Создание задачи в ПланФикс

Цель: при регистрации, оплате или другом событии автоматически создать задачу в ПланФикс.

Создание задачи в ПланФикс

Шаг 1. Создайте триггер

1 Создайте триггер

Создайте триггер с нужным условием (например, по событию оплаты или регистрации).

2 Откройте действия

Нажмите «Действия» напротив триггера.

Шаг 2. Добавьте действие «Добавить задачу»

Нажмите «Добавить действие» → Добавить задачу. Заполните поля:

Поле Описание Пример
Текст задачи Название задачи. Поддерживает шорткоды. Заявка от {#name#}
Проект Проект, в который добавить задачу. Если не выбран — берётся из «Общих настроек». Продажи
Кол-во часов на выполнение Длительность задачи в часах. 8

Нажмите иконку {--} рядом с полем, чтобы увидеть список доступных шорткодов.

Как работает:

  1. Система ищет контакт в ПланФикс по email и телефону.
  2. Если контакт найден — привязывает его к задаче.
  3. Если контакт не найден — создаёт нового контакта с именем, email и телефоном из базы данных.
  4. Создаёт задачу с указанными параметрами. Если задан шаблон в «Общих настройках» — применяет его.

Шаг 3. Сохраните настройки

Нажмите «Сохранить». Теперь при срабатывании триггера задача будет создана в ПланФикс.

Обновление полей задачи

Цель: обновить кастомные поля существующей задачи (например, записать сумму оплаты, тариф, статус заказа).

Обновление полей задачи

Шаг 1. Добавьте действие «Поля задачи»

Нажмите «Добавить действие» → Поля задачи. Заполните поля:

Поле Описание Пример
Поля Пары «Кастомное поле → Значение». Поле выбирается из списка, значение вводится вручную. Поддерживает шорткоды. Сумма → {#costMoney#}
Поля2 Дополнительные пары полей (аналогично). Тариф → {#tarif#}

Шаг 2. Сохраните настройки

Нажмите «Сохранить». При срабатывании триггера кастомные поля задачи будут обновлены.

Важно: если задача не найдена — система автоматически создаст новую с параметрами из «Общих настроек».

Типы кастомных полей:

  • Набор значений — несколько значений через запятую.
  • Чекбокс — 1 (включён) или 0 (выключен).
  • Дата — значение в формате даты.
  • Время — значение времени.
  • Контакт — ID контакта.

Изменение статуса задачи

Цель: автоматически переводить задачу в нужный статус при наступлении события.

Изменение статуса задачи

Шаг 1. Добавьте действие «Статус задачи»

Нажмите «Добавить действие» → Статус задачи. Заполните:

Поле Описание Пример
Статус Выберите статус из списка. Список загружается из вашего аккаунта ПланФикс. Оплачено

Шаг 2. Сохраните настройки

Нажмите «Сохранить». При срабатывании триггера статус задачи будет изменён.

Важно: если задача не найдена — система автоматически создаст новую и установит выбранный статус.

Изменение менеджера задачи

Цель: автоматически назначить нового ответственного при наступлении события.

Изменение менеджера задачи

Шаг 1. Добавьте действие «Изменить менеджера»

Нажмите «Добавить действие» → Изменить менеджера. Заполните:

Поле Описание Пример
Менеджер Выберите пользователя из списка. Список загружается из вашего аккаунта ПланФикс. Иванов Иван

Шаг 2. Сохраните настройки

Нажмите «Сохранить». При срабатывании триггера ответственный за задачу будет изменён.

Изменение названия задачи

Цель: обновить название задачи при наступлении события.

Изменение названия задачи

Шаг 1. Добавьте действие «Название сделки»

Нажмите «Добавить действие» → Название сделки. Заполните:

Поле Описание Пример
Название Новое название задачи. Поддерживает шорткоды. Оплата: {#name#} — {#costMoney#} руб.

Шаг 2. Сохраните настройки

Нажмите «Сохранить».

Добавление комментария к задаче

Цель: добавить текстовый комментарий (примечание) к задаче.

Добавление комментария к задаче

Шаг 1. Добавьте действие «Добавить примечание»

Нажмите «Добавить действие» → Добавить примечание. Заполните:

Поле Описание Пример
Комментарий Текст комментария. Поддерживает шорткоды. Оплата: {#costMoney#} руб. Тариф: {#tarif#}

Можно добавить несколько действий «Добавить примечание» в один триггер — каждое создаст отдельный комментарий.

Шаг 2. Сохраните настройки

Нажмите «Сохранить». При срабатывании триггера комментарий будет добавлен к задаче.

Важно: если задача не найдена — система автоматически создаст новую и добавит к ней комментарий.

Типичные сценарии настройки

Сценарий 1. Регистрация → задача в ПланФикс

Настройте Общие настройки: поиск дублей включён, проект по умолчанию выбран, название задачи: Новая заявка: {#name#}.

Добавьте в триггер одно действие:

  1. Добавить задачу — текст: Заявка от {#name#}, тел: {#phone#}, проект: выбранный.

Сценарий 2. Оплата → обновление полей + статус + комментарий

Добавьте в триггер три действия:

  1. Поля задачи — заполнить нужные кастомные поля (сумма, тариф).
  2. Статус задачи — перевести в статус «Оплачено».
  3. Добавить примечание — Оплата: {#costMoney#} руб.

Сценарий 3. Событие → смена менеджера + комментарий

Добавьте в триггер два действия:

  1. Изменить менеджера — выбрать нового ответственного.
  2. Добавить примечание — Переназначено. Причина: ...

Сценарий 4. Вебинар → задача + комментарий

Настройте Общие настройки: проект по умолчанию, шаблон задачи.

Добавьте в триггер два действия:

  1. Добавить задачу — текст: Участник вебинара: {#name#}.
  2. Добавить примечание — Был на вебинаре, смотрел {#bil_minut#} мин.

Сценарий 5. Разные события → разные проекты

Создайте несколько триггеров с разными условиями:

  • Триггер 1: событие «Регистрация» → Добавить задачу (проект «Лиды»).
  • Триггер 2: событие «Оплата» → Добавить задачу (проект «Клиенты»).

Шорткоды

В текстовых полях действий можно использовать шорткоды — подстановки данных из входящего события. Нажмите иконку {--} рядом с полем, чтобы увидеть список доступных шорткодов.

Часто используемые шорткоды:

Шорткод Данные
{#name#} Имя
{#email#} Email
{#phone#} Телефон
{#city#} Город

Частые вопросы

«Ошибка доступа проверьте введеные данные»
Причина: неверный API-ключ.
Решение: перейдите в ПланФикс → Управление аккаунтом → Доступ к API → REST API. Скопируйте ключ заново, без лишних пробелов.
«Нет Разрешений в настройках ЛК ПланФикс»
Причина: API-ключу не хватает прав.
Решение: в ПланФикс → Управление аккаунтом → Доступ к API → отредактируйте ключ, добавьте разрешения (контакты, задачи, проекты, кастомные поля).
Не вижу проекты/поля/менеджеров в выпадающих списках
Решение: обновите страницу (F5). Данные загружаются из ПланФикс при открытии.
Задача не создаётся
Проверьте:
  1. Указан ли проект — в действии или в «Общих настройках» в поле «Добавлять в проект»?
  2. Имеет ли API-ключ право на создание задач?
Контакт не находится, создаются дубли
Решение: убедитесь, что email или телефон передаются и поиск дублей включён в «Общих настройках».
Поля задачи не обновляются
Решение: проверьте, что тип значения соответствует типу поля в ПланФикс (для набора значений — через запятую, для чекбокса — 1/0, для даты — формат даты).
Статус задачи не меняется
Причина: выбранный статус может быть недоступен для текущего типа задачи в ПланФикс.
Решение: проверьте настройки статусов в ПланФикс.
Комментарий не добавляется
Причина: задача должна существовать или быть создана автоматически.
Решение: убедитесь, что контакт найден и проект указан.
×