Интеграция CRM системы через API¶
Чтобы интегрировать CRM систему с R7K12, необходимо обязательно использовать два метода API:
Для чего нужен метод setStatuses¶
Например, у Вас в CRM есть такие статусы:
- Новый
- Передано в комплектацию
- Наличие подтверждено
- Комплектуется
- Согласовано с клиентом
- Доставляется
- Выполнен
Вы хотите проанализировать всю воронку сделки по статусам. Что для этого нужно сделать?
Статусы по группам в R7K12¶
Для того, чтобы выделить в аналитике R7K12 среди всех ваших сделок (заказов) целевые заявки, продажи и отмененные заявки, в R7K12 существуют четыре группы статусов: «Не учитывается», «В обработке», «Успешно реализовано», «Отказ».
Статусы из вашей CRM нужно распределить по этим группам. Тогда в столбцах в аналитике вы увидите:
- Столбец "Заявки" - здесь считаются сделки, статусы которых распределены в группах «В обработке», «Успешно реализовано», «Отказ».
- Столбец "Продажи" - считаются сделки, статусы которых распределены в группу «Успешно реализовано».
- Столбец "Отмененные заявки" - сделки, статусы которых распределены в группу «Отказ».
- Столбец "Сделки" - учитываются все сделки из CRM системы (иными словами со всех групп статусов).
- Столбец "Обращения" - подсчитываются все обращения со всех сделок (в одной сделке может быть несколько обращений от клиента). Обращение - это звонок клиента, заявка с сайта, письмо на Email и т.д.
Для того, чтобы определить каждому Вашему статусу сделки из CRM статус группы в R7K12, нужно единожды отправить нам через API распределение статусов (как на картинке выше) с помощью метода setStatuses. Если вдруг у вас изменятся статусы в CRM, отправьте после этого обновленные данные. Пример кода в описании метода.
Для чего нужен метод addLeads¶
После того, как распределили статусы по группам в R7K12, можно отправлять сделки с определенным статусом группы. Тогда в аналитике вы сможете увидеть количество целевых заявок (столбец "Заявки"), продаж, отмененных заявок, всего сделок и обращений. А также сможете посмотреть, какой источник дал Вам каждую эту сделку. В методе есть обязательные поля и необязательные. Соответственно минимальный набор полей для отправки данных содержит обязательные поля. Среди необязательных полей есть поле r7k12id -идентификатор визита. Да, вы можете отправить корректно метод без этого поля (или пустым). Но тогда все сделки попадут на источник "Без визита" и будут неопределенными. То есть, вы не увидите, с какого источника были заявки и продажи. Поэтому поле r7k12idдолжно быть определено. Для этого нужно установить наш счетчик по инструкции - Установка счетчика. В случае визита на сайт после установки счетчика R7K12, значение идентификатора будет числовым. Для offline источников в значении r7k12id можно передавать название источника. Воспользуйтесь подробными примерами в методе API - addLeads.