Перейти к содержанию

Интеграция Roistat с ПланФикс

Как работает интеграция

При оформлении заявки на сайте автоматически создается новая задача в ПланФикс, в которую передается номер визита из куки браузера roistat_visit в дополнительное поле с именем roistat. Если менеджер принимает заявку по телефону, он может спросить промокод (настраивается отдельно) и ввести этот код в поле roistat.

Настройка интеграции

Внимание!

Данная инструкция подходит для конфигурации ПланФикс Базовое рабочее пространство, в которой верхняя панель выглядит следующим образом:

0.png

Если у вас другая конфигурация, кликните по иконке ракеты в правом верхнем углу и нажмите Базовое рабочее пространство.

Шаг 1. Установите счетчик на сайт

На каждую страницу, куда заходят посетители, нужно установить счетчик, который позволит Roistat получать данные о посетителях. Сразу будет доступна функциональность промокодирования (для отслеживания продаж через телефон). Счетчик установит в cookie переменную roistat_visit, которая будет содержать номер визита.

О том, как установить счетчик на сайт, читайте в статье Установка счетчика. Если на сайте уже есть счетчик, пропустите этот шаг.

Шаг 2. Добавьте дополнительное поле roistat

  1. Войдите в личный кабинет ПланФикс.

  2. Перейдите в раздел ЗадачиШаблоны. Если у вас уже есть шаблон, по которому нужно создавать заявки, кликните по его названию и нажмите Редактировать. Вы также можете создать новый шаблон, кликнув Новый шаблон задачи:

    1.png

  3. В окне создания/редактирования шаблона нажмите Новое поле:

    2.png

    Откроется окно Добавление нового поля

  4. В поле Название введите roistat. Значения остальных параметров установите по своему усмотрению:

    4.png

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

  6. Поле roistat появится в списке полей в блоке Панель 1. Вы можете отобразить его и на других панелях шаблона – для этого раскройте меню настроек поля и выберите нужные панели:

    5.png

Шаг 3. Подключите ПланФикс в каталоге интеграций

  1. В проекте Roistat откройте раздел Интеграции.

  2. Нажмите Добавить интеграцию. В появившемся окне введите ПланФикс, кликните по карточке и нажмите Добавить:

    9.png

    Затем нажмите Настроить интеграцию (иконка шестеренки):

    10.png

  3. Откроется окно с параметрами авторизации:

    10-1.png

    Заполните поля:

    • Поддомен АПИ: введите apiru, если ваш проект Планфикс расположен на сервере в России, или api, если ваш проект Планфикс расположен на сервере в другой стране;
    • Поддомен: имя аккаунта в ПланФикс. Например, если адрес аккаунта – test.planfix.ru, введите test;
    • Логин для входа в PlanFix и Пароль: логин и пароль, которые вы вводили при регистрации в ПланФикс;
    • АПИ ключ: аутентификационный ключ для доступа к API ПланФикс;
    • Секретный ключ: ключ подписи для доступа к API ПланФикс;

      Как получить аутентификационный ключ (АПИ ключ) и ключ подписи (секретный ключ)

      • В личном кабинете ПланФикс в правом верхнем углу откройте меню Настройки и выберите Управление аккаунтом:
      ![11.png](/img/PlanFiks/11.png)
      
      • Перейдите в раздел Доступ к API. В поле APIKey скопируйте аутентификационный ключ, в поле PrivateKey – ключ подписи.
    • Идентификатор шаблона контакта и Идентификатор шаблона компании;  

      Как получить идентификаторы шаблона контакта и шаблона компании

      • В личном кабинете ПланФикс на панели навигации выберите Контакты.

      • Перейдите в раздел Шаблоны. Напротив строк Шаблон контакта и Шаблон компании отображаются нужные идентификаторы:

      ![12.png](/img/PlanFiks/12.png)
      
    • Идентификатор шаблона задачи;

      Как получить идентификатор шаблона задачи

      • В личном кабинете ПланФикс в панели навигации выберите Задачи.

      • Перейдите в раздел Шаблоны. Найдите шаблон, который вы используете для создания заявок. Напротив строки с названием шаблона отображается нужный идентификатор:

      ![13.png](/img/PlanFiks/13.png)
      

      В Roistat загружаются все задачи, а не только те, которые удовлетворяют указанному шаблону. Шаблон задачи необходим для создания новых задач в проекте Roistat для последующей передачи в ПланФикс (см. Шаг 3).

  4. Нажмите Сохранить. Откроется раздел Распределение статусов, в котором загрузятся статусы задач из ПланФикс.

  5. Перетаскивая статусы задач, распределите их по группам. Подробнее читайте в статье Распределение статусов сделок.

  6. Нажмите Продолжить. Откроется инструкция по включению отправки заявок. Ознакомьтесь с ней и нажмите Следующий шаг.

  7. В разделе Расширенные настройки укажите параметры для фильтрации сделок. Подробнее – в статье Фильтрация сделок.

  8. Также укажите значения полей бизнес-показателей. Подробнее – в статье Поля бизнес-показателей.

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

Шаг 3. Настройте автоматическую отправку заявок в ПланФикс

Рекомендуем настроить передачу заявок в ПланФикс через Roistat – в этом случае заявки сначала передаются в Roistat, а затем отправляются в ПланФикс в виде задач. Данный механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.

Внимание!

Передача дополнительных полей в задачу Планфикс невозможна.

Если отправка заявок с сайта в ПланФикс уже настроена с помощью вашего кода, для обмена данными с Roistat вам необходимо заполнить дополнительное поле roistat значением cookie roistat_visit.

Пример кода, с помощью которого можно получить значение этой cookie:

$roistatVisitId = array_key_exists('roistat_visit', $_COOKIE) ? $_COOKIE['roistat_visit'] : "неизвестно"

Проверка работы

После того, как на сайте отправлена заявка, в ПланФикс создается новая задача с заполненным полем roistat. Заявки отображаются и в Roistat:  

  1. В проекте Roistat откройте раздел Состояние проектаСписок отправленных заявок и найдите созданную заявку:

    14.png

  2. Проверьте статус отправки заявки: в поле Отправлен должен появиться статус отправки V, а в поле Сделка – номер задачи в ПланФикс.