Интеграция Roistat с ПланФикс¶
Как работает интеграция¶
При оформлении заявки на сайте автоматически создается новая задача в ПланФикс, в которую передается номер визита из куки браузера roistat_visit в дополнительное поле с именем roistat. Если менеджер принимает заявку по телефону, он может спросить промокод (настраивается отдельно) и ввести этот код в поле roistat.
Настройка интеграции¶
Шаг 1. Установите счетчик на сайт¶
На каждую страницу, куда заходят посетители, нужно установить счетчик, который позволит Roistat получать данные о посетителях. Сразу будет доступна функциональность промокодирования (для отслеживания продаж через телефон). Счетчик установит в cookie переменную roistat_visit,** которая будет содержать номер визита.
О том, как установить счетчик на сайт, читайте в статье Установка счетчика. Если на сайте уже есть счетчик, пропустите этот шаг.
Шаг 1. Добавьте дополнительное поле roistat¶
- Войдите в личный кабинет ПланФикс.
- Перейдите в раздел Задачи → Шаблоны задач:
- Выберите из существующих или создайте новый шаблон задачи, по которому будут создаваться заявки:
- Откройте шаблон и нажмите Редактировать:
- Нажмите кнопку Новое поле:
Откроется окно Добавление нового поля.
-
В поле Название введите roistat. Значения остальных параметров установите по своему усмотрению:
-
Нажмите Сохранить.
- Поле roistat появится в списке дополнительных полей. Отобразите его на одной из панелей шаблона, например Дополнительные параметры:
Шаг 2. Подключите ПланФикс в каталоге интеграций¶
- В проекте Roistat откройте Каталог интеграций.
- В блоке CRM выберите planfix и нажмите кнопку Настроить интеграцию.
- В поле Поддомен API введите apiru, если ваш проект Планфикс расположен на сервере в России, api - если ваш проект Планфикс расположен на сервере в другой стране.
- В поле Поддомен ведите имя аккаунта в ПланФиксе. Например, если адрес аккаунта test.planfix.ru, введите test.
- В полях Логин для входа в PlanFix и Пароль введите логин и пароль, которые вы вводили при регистрации в ПланФикс.
- В поле Апи ключ введите аутентификационный ключ для доступа к API ПланФикс.
- В поле Секретный ключ введите ключ подписи для доступа к API ПланФикс.
Как получить аутентификационный ключ и ключ подписи для доступа к API ПланФикс
-
В личном кабинете ПланФикс в правом верхнем углу окна вызовите контекстное меню Настройки и выберите Управление аккаунтом.
-
Перейдите в раздел Доступ к API.
-
В поле APIKey скопируйте аутентификационный ключ.
-
В поле PrivateKey скопируйте ключ подписи.
-
Введите идентификатор шаблона контакта.
Как получить идентификатор шаблона контакта
-
В личном кабинете ПланФикс в панели навигации выберите Контакты.
-
Перейдите в раздел Шаблоны.
-
Напротив строки Шаблон контакта отображается нужный идентификатор:
-
Введите идентификатор шаблона компании.
Как получить идентификатор шаблона компании
-
В личном кабинете ПланФикс в панели навигации выберите Контакты.
-
Перейдите в раздел Шаблоны.
-
Напротив строки Шаблон компании отображается нужный идентификатор:
-
Введите идентификатор шаблона задачи.
Как получить идентификатор шаблона задачи
-
В личном кабинете ПланФикс в панели навигации выберите Задачи.
-
Перейдите в раздел Шаблоны задач.
-
Напротив строки Стандарнтый шаблон отображается нужный идентификатор:
В Roistat загружаются все задачи, а не только те, которые удовлетворяют указанному шаблону. Шаблон задачи необходим для создания новых задач в проекте Roistat для последующей передачи в ПланФикс (см. Шаг 3).
-
Нажмите Сохранить. Откроется раздел Распределение статусов, в котором загрузятся статусы задач из ПланФикс.
-
Перетаскивая статусы задач, распределите их по группам. Подробнее читайте в статье Распределение статусов сделок.
- Нажмите Продолжить. Откроется раздел Расширенные настройки
- Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.
- Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей.
- Нажмите Сохранить.
Шаг 3. Настройте автоматическую отправку заявок в ПланФикс¶
Рекомендуем настроить передачу заявок в ПланФикс через Roistat - механизм отправки заявок, при котором заявки сначала передаются в Roistat, затем отправляются в ПланФикс в виде задач. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.
Внимание!
Передача дополнительных полей в задачу Планфикс невозможна.
Если отправка заявок с сайта в ПланФикс уже настроена с помощью вашего кода, для обмена данными с Roistat вам необходимо заполнить дополнительное поле roistat сделки значением cookie roistat_visit. *
Пример кода, с помощью которого можно получить значение этой cookie:
$roistatVisitId = array_key_exists('roistat_visit', $_COOKIE) ? $_COOKIE['roistat_visit'] : "неизвестно"
Проверка работы¶
После того, как на сайте отправлена заявка, в ПланФикс создается новая задача с заполненным полем roistat. Заявки отображаются и в Roistat:
- В проекте Roistat откройте Каталог интеграций.
- В блоке Сейчас подключено на виджете настроенной интеграции с ПланФикс нажмите кнопку Настроить.
- В окне настройки интеграции пройдите по ссылке Список отправленных заявок.
- Проверьте статус отправки заявки: в поле Отправлен должен появиться статус отправки V, а в поле CRM - номер задачи в ПланФикс.