Skip to content

Инструкция по загрузке сделок из CRM

Intro

Наименование Описание
Сделка Карточка продажи, которая идет по этапам воронки продаж.
Контакт Карточка клиента из вашей CRM системы.
Воронка продаж Состоит из этапов, которые проходит сделка от создания до успешного завершения (например, оплаты).
Этап Часть пути воронки продаж, который проходит сделка по процессу продажи в компании.
Ответственный сотрудник Сотрудник в CRM, ответственный за конкретную сделку.
Для анализа эффективности рекламных кампаний до сделки и прибыли в аналитических отчетах необходимо загрузить сделки из вашей CRM в личный кабинет CoMagic.
Вы это можете сделать, подключив “Сквозную аналитику” и настроив интеграцию с CRM c помощью готовых решений ( "Битрикс24" , "amoCRM" или "МИС Инфоклиника" ), где реализована передача сделок в CoMagic.
Если у вас другая CRM-система, то вы можете воспользоваться API и настроить интеграцию самостоятельно.

Для настройки интеграции через API необходимо:

  1. Создать структуру CRM в CoMagic
    • Передать структуру каждой воронки продаж
    • Передать список сотрудников и ответственных по каждой сделке
    • Передать список контактов
  2. Загрузить историю сделок
  3. Произвести настройку сквозной аналитики
  4. Настроить необходимые данные для анализа в аналитических отчетах


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

Пример Передача сделок и других данных из CRM
Описание Название воронки: "Основная воронка".
Структура воронки продаж:
  • этап 1 - "Новая сделка"
  • этап 2 - "Подготовка документов"
  • этап 3 - "Счет на предоплату"
  • этап 4 - "Финальный счет"
  • успешный этап - "Успешно реализовано"
  • проваленный этап - "Сделка провалена"
Элементы воронки:
2 ответственных сотрудника
3 контакта
3 сделки:
  • сделка 1: прошла все этапы и закрылась продажей
  • сделка 2: прошла первый этап и была провалена
  • сделка 3: дошла до этапа "Счет на предоплату"
У каждой сделки есть контакт и ответственный сотрудник.

1. Перенос структуры вашей CRM в CoMagic

1.1 Создание структуры воронки продаж:

Метод create.sales_funnel
Описание Создание воронки продаж и ее этапов
Кому доступен Агент, Клиент
В запросе "Порядковый номер этапа" указан как 10, 20, 30, 40.

Это сделано, для того чтобы в будущем вы смогли добавить промежуточные этапы
без редактирования  всей воронки.
Допустим, в CRM поменялась структура воронки, и добавился этап
"Подписание документов" между этапами "Подготовка Документов"
и "Счет на предоплату". Вы легко можете добавить этап "Подписание документов"
с порядковым номером от 21 до 29. Но лучше 25.

Максимальный номер этапа = 10000

JSON структура запроса

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "create.sales_funnel",
    "params": {
        "access_token": "${#Project#auth_prod_4735}",
        "ext_id": "1",
        "name": "Основная воронка",
        "stages": {
            "success": {
                "ext_id": "1000",
                "name": "Успешно реализовано"
            },
            "failed": {
                "ext_id": "10001",
                "name": "Сделка провалена"
            },
            "in_process": [
                {
                    "ext_id": "1",
                    "name": "Новая сделка",
                    "order": 10
                },
                {
                    "ext_id": "2",
                    "name": "Подготовка Документов",
                    "order": 20
                },
                {
                    "ext_id": "3",
                    "name": "Счет на предоплату",
                    "order": 30
                },
                {
                    "ext_id": "4",
                    "name": "Финальный счет",
                    "order": 40
                }
            ]
        }
    }
}

В ответе вернется ID созданной воронки.

JSON структура ответа

{
   "result":    {
      "metadata": {"limits":    {
         "minute_reset": 23,
         "minute_remaining": 199,
         "minute_limit": 200,
         "day_reset": 35483,
         "day_remaining": 3319,
         "day_limit": 3500
      }},
      "data":       {
         "ext_id": "1"
      }
   },
   "id": 1,
   "jsonrpc": "2.0"
}

Проверка структуры воронки:

Метод get.sales_funnel
Описание Получение списка воронок продаж
Кому доступен Агент, Клиент

JSON структура запроса

{
  "jsonrpc":"2.0",
  "id":"number",
  "method":"get.sales_funnel",
  "params":{
    "access_token":"${#Project#auth_prod_4735}",
    "filter":{
      "field":"ext_id",
      "operator":"=",
      "value":"1"
    }
  }
}

JSON структура ответа

{
   "result":    {
      "metadata":       {
         "limits":          {
            "minute_reset": 39,
            "minute_remaining": 199,
            "minute_limit": 200,
            "day_reset": 35139,
            "day_remaining": 3305,
            "day_limit": 3500
         },
         "total_items": 1
      },
      "data": \[    {
         "ext_id": "1",
         "name": "Основная воронка",
         "stages":          [
                        {
               "stage_name": "Новая сделка",
               "stage_ext_id": "1",
               "stage_status": "in_process",
               "stage_order": 10
            },
                        {
               "stage_name": "Подготовка Документов",
               "stage_ext_id": "2",
               "stage_status": "in_process",
               "stage_order": 20
            },
                        {
               "stage_name": "Счет на предоплату",
               "stage_ext_id": "3",
               "stage_status": "in_process",
               "stage_order": 30
            },
                        {
               "stage_name": "Финальный счет",
               "stage_ext_id": "4",
               "stage_status": "in_process",
               "stage_order": 40
            },
                        {
               "stage_name": "Успешно реализовано",
               "stage_ext_id": "1000",
               "stage_status": "success",
               "stage_order": 10010
            },
                        {
               "stage_name": "Сделка провалена",
               "stage_ext_id": "10001",
               "stage_status": "failed",
               "stage_order": 10020
            }
         ]
      }]
   },
   "id": "number",
   "jsonrpc": "2.0"
}

При необходимости можно переименовать воронку продаж методом update.sales_funnel и отредактировать этапы, используя метод update.sales_funnel_stages.

1.2 Создание списка сотрудников, ответственных за сделки

Если вы не хотите анализировать РК в разрезе по сотрудникам,
то можно пропустить этот пункт

Пример:
Добавления двух сотрудников

Метод create.deal_employees
Описание Создание/добавление ответственного сотрудника
Кому доступен Агент, Клиент

JSON структура запроса
Запрос 1

{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "create.deal_employees",
    "params": {
        "access_token":"${#Project#auth_prod_4735}",
        "ext_id": "EID_0007",
        "name": "Иванов"
    }
}

Запрос 2

{
    "jsonrpc": "2.0",
    "id": "2",
    "method": "create.deal_employees",
    "params": {
        "access_token":"${#Project#auth_prod_4735}",
        "ext_id": "EBdfID_0008",
        "name": "Сидоров"
    }
}

1.3 Создание контактов

Метод create.deal_contacts
Описание Создание контакта
Кому доступен Агент, Клиент

Пример:

В CRM есть 3 контакта с внутренними идентификаторами CID_0001, CID_0002, CID_0003
ID Имя телефон email
CID_0001 Оловянный Олег 79000000000, 79000000001 test@example.com, test2@example.com
CID_0002 Петрович 79000000003 test3@example.com
CID_0003 Новый клиент 79000000004

JSON структура запроса

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "create.deal_contacts",
    "params": {
        "access_token": "${#Project#auth_prod_4735}",
        "contacts": [
            {
                "ext_id": "CID_0001",
                "name": "Оловянный Олег",
                "created_date_time": "2019-08-02 21:00:01",
                "phone_numbers": [
                    "79000000000",
                    "79000000001"
                ],
                "emails": [
                    "test@example.com",
                    "test2@example.com"
                ]
            },
            {
                "ext_id": "CID_0002",
                "name": "Петрович",
                "created_date_time": "2019-08-03 12:15:00",
                "phone_numbers": [
                    "79000000003"
                ],
                "emails": [
                    "test3@example.com"
                ]
            },
            {
                "ext_id": "CID_0003",
                "name": "Новый клиент",
                "created_date_time": "2019-08-10 10:40:50",
                "phone_numbers": [
                    "79000000004"
                ]
            }
        ]
    }
}

2. Загрузка истории сделок

Для построения корректной аналитики необходимо передавать все этапы, которые прошла сделка, а не только текущий её этап (на момент выгрузки).

Это можно сделать двумя способами:
  1. Передавать обновление по сделке в CRM по тригеру, т.е загружать ее в Comagic когда произошло одно из событий:
    • Создание сделки
    • Переход сделки в другой этап
    • Обновление одного из параметров: контакта, ответственного, суммы сделки
  2. Один раз за период (час, день, неделю) загружать сразу всю историю по всем сделкам. Для каждой сделки передать все пройденные этапы и время перехода в каждый этап.

    Все переданные сделки отображаются в отчете "Сквозная аналитика" кумулятивно (т.е отображаются все этапы, которые прошла сделка, а не только текущий).

    Если какой-нибудь из промежуточных этапов не был передан, то система автоматически его создаст с флагом is_generated = True, это необходимо для корректного отображения в аналитических отчетах. В показателях по этапам учитываются сделки, которые прошли через данный этап.
Отдельного метода по созданию и обновлению сделки у нас нет.
Сделка создается при передачи первой записи по ней, и обновляется
с каждым новым вызовом метода.
Создание сделки, которая прошла все этапы и закрылась продажей:
JSON структура запроса
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "upload.deals_history",
    "params": {
        "access_token": "${#Project#auth}",
        "deals": \[
            {
                "ext_id": "DID_0001",
                "name": "Продажа аннигиляторной пушки",
                "created_date_time": "2019-08-15 07:07:00",
                "modified_date_time": "2019-08-15 07:07:00",
                "modified_stage_date_time": "2019-08-15 07:07:00",
                "contact_ext_ids": [
                    "CID_0001"
                ],
                "main_contact_ext_id": "CID_0001",
                "employee_ext_id": "EID_0001",
                "sales_funnel_ext_id": "SFID_0001",
                "stage_ext_id": "1",
                "comments": "Супер сделка"
            },
            {
                "ext_id": "DID_0001",
                "name": "Продажа аннигиляторной пушки",
                "created_date_time": "2019-08-15 07:07:00",
                "modified_date_time": "2019-08-16 07:07:00",
                "modified_stage_date_time": "2019-08-16 07:07:00",
                "contact_ext_ids": [
                    "CID_0001"
                ],
                "main_contact_ext_id": "CID_0001",
                "employee_ext_id": "EID_0002",
                "sales_funnel_ext_id": "SFID_0001",
                "revenue": 5000,
                "stage_ext_id": "2",
                "comments": "Супер сделка"
            },
            {
                "ext_id": "DID_0001",
                "name": "Продажа аннигиляторной пушки",
                "created_date_time": "2019-08-15 07:07:00",
                "modified_date_time": "2019-08-17 07:07:00",
                "modified_stage_date_time": "2019-08-17 07:07:00",
                "contact_ext_ids": [
                    "CID_0001"
                ],
                "main_contact_ext_id": "CID_0001",
                "sales_funnel_ext_id": "SFID_0001",
                "stage_ext_id": "3",
                "comments": "Супер сделка"
            },
            {
                "ext_id": "DID_0001",
                "name": "Продажа аннигиляторной пушки",
                "created_date_time": "2019-08-15 07:07:00",
                "modified_date_time": "2019-08-18 07:07:00",
                "modified_stage_date_time": "2019-08-18 07:07:00",
                "contact_ext_ids": [
                    "CID_0001"
                ],
                "main_contact_ext_id": "CID_0001",
                "sales_funnel_ext_id": "SFID_0001",
                "stage_ext_id": "4",
                "comments": "Супер сделка"
            },
            {
                "ext_id": "DID_0001",
                "name": "Продажа аннигиляторной пушки",
                "created_date_time": "2019-08-15 07:07:00",
                "closed_date_time": "2019-08-19 10:07:00",
                "modified_date_time": "2019-08-19 10:07:00",
                "modified_stage_date_time": "2019-08-19 10:07:00",
                "contact_ext_ids": [
                    "CID_0001"
                ],
                "main_contact_ext_id": "CID_0001",
                "sales_funnel_ext_id": "SFID_0001",
                "stage_ext_id": "10000",
                "comments": "Супер сделка"
            }
        ]
    }
}

Создание сделки, которая с первого этапа ушла в отказ:

JSON структура запроса

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "upload.deals_history",
    "params": {
        "access_token": "${#Project#auth}",
        "deals": \[
            {
                "ext_id": "DID_0002",
                "name": "Беговел Puky Pukylino",
                "created_date_time": "2019-08-15 07:07:00",
                "modified_date_time": "2019-08-15 07:07:00",
                "modified_stage_date_time": "2019-08-15 07:07:00",
                "contact_ext_ids": [
                    "CID_0002"
                ],
                "main_contact_ext_id": "CID_0002",
                "employee_ext_id": "EID_0002",
                "revenue": 4250,
                "sales_funnel_ext_id": "SFID_0002",
                "stage_ext_id": "1",
                "comments": "Супер сделка"
            },
            {
                "ext_id": "DID_0002",
                "name": "Беговел Puky Pukylino",
                "created_date_time": "2019-08-15 07:07:00",
                "closed_date_time": "2019-08-19 10:07:00",
                "modified_date_time": "2019-08-19 10:07:00",
                "modified_stage_date_time": "2019-08-19 10:07:00",
                "contact_ext_ids": [
                    "CID_0002"
                ],
                "main_contact_ext_id": "CID_0002",
                "sales_funnel_ext_id": "SFID_0002",
                "stage_ext_id": "10002",
                "comments": "Не выдерживает необходимый вес"
            }
        ]
    }
}

Создание сделки, которая дошла до этапа "Счет на предоплату":

JSON структура запроса

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "upload.deals_history",
    "params": {
        "access_token": "${#Project#auth}",
        "deals": \[
            {
                "ext_id": "DID_0003",
                "name": "Sony PlayStation 4 Slim 500 ГБ",
                "created_date_time": "2019-08-15 07:07:00",
                "modified_date_time": "2019-08-15 07:07:00",
                "modified_stage_date_time": "2019-08-15 07:07:00",
                "contact_ext_ids": [
                    "CID_0003"
                ],
                "main_contact_ext_id": "CID_0003",
                "employee_ext_id": "EID_0003",
                "sales_funnel_ext_id": "SFID_0003",
                "stage_ext_id": "1",
            },
            {
                "ext_id": "DID_0003",
                "name": "Sony PlayStation 4 Slim 500 ГБ",
                "created_date_time": "2019-08-15 07:07:00",
                "modified_date_time": "2019-08-16 07:07:00",
                "modified_stage_date_time": "2019-08-16 07:07:00",
                "contact_ext_ids": [
                    "CID_0003"
                ],
                "main_contact_ext_id": "CID_0003",
                "employee_ext_id": "EID_0002",
                "sales_funnel_ext_id": "SFID_0003",
                "revenue": 17350,
                "stage_ext_id": "2",
            },
            {
                "ext_id": "DID_0003",
                "name": "Sony PlayStation 4 Slim 500 ГБ",
                "created_date_time": "2019-08-15 07:07:00",
                "modified_date_time": "2019-08-17 07:07:00",
                "modified_stage_date_time": "2019-08-17 07:07:00",
                "contact_ext_ids": [
                    "CID_0003"
                ],
                "main_contact_ext_id": "CID_0003",
                "sales_funnel_ext_id": "SFID_0003",
                "stage_ext_id": "3",
                "comments": "В ожидании оплаты"
            }
        ]
    }
}

3. Произвести настройку сквозной аналитики , подключив интеграцию с CRM в личном кабинете CoMagic во вкладке интеграции c помощью кнопки «Другая CRM».

4. Настроить необходимые данные для отображения и анализа в аналитических отчетах.