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

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

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

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

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

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

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

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

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

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

   

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

   

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

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

   

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

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

   

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

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

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

   

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

   

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

   

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

   • Поддомен АПИ: введите 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 откройте раздел Состояние проекта → Список отправленных заявок и найдите созданную заявку:

   

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