Skip to content

Получение списка всех обращений

Получение списка всех обращений

Метод get.communications_report
Описание Получение списка всех обращений
Кому доступен Партнёр, Клиент

Параметры запроса

Название Тип Обязательный Допустимые значения Описание
access_token string да Ключ сессии аутентификации
user_id number нет Уникальный идентификатор пользователя клиента агента от имени которого делается запрос
Является обязательным для агента
Для получения списка пользователей клиента необходимо использовать метод "get.customer_users"
limit number нет Количество возвращаемых записей. См. раздел "Постраничный вывод"
offset number нет Сдвиг, определяет с какого номера записи возвращать "limit" записей. По умолчанию "0". См. раздел "Постраничный вывод"
filter object нет См. раздел "Критерии фильтрации"
fields array нет См. раздел "Представление возвращаемых данных"
sort array нет См. раздел "Сортировка данных"
date_from iso8601 да YYYY-MM-DD hh:mm:ss Дата начала выборки
date_till iso8601 да YYYY-MM-DD hh:mm:ss Дата окончания выбокри

Параметры ответа

Название Тип Допустимые значения Фильтрация Сортировка Ответ по умолчанию Описание
id number да да Уникальный идентификатор обращения. Для получения детализированной информации по каждому типу обращения можно использовать следующие методы: "get.chats_report", "get.goals_report", "get.offline_messages_report", "get.calls_report"
communication_type enum chat, call, goal, offline_message да да да Тип обращения. Для получения детализированной информации по каждому типу обращения можно использовать следующие методы: "get.chats_report", "get.goals_report", "get.offline_messages_report", "get.calls_report"
communication_number number да да Номер обращения. Расcчитывается в рамках персоны.
communication_page_url string нет нет нет URL страницы на которой находился посетитель в момент обращения или страница последнего взаимодействия посетителя перед обращением.
date_time iso8601 YYYY-MM-DD hh:mm:ss да да да Дата и время обращения
ua_client_id string Уникальный идентификатор в Universal Analytics
ym_client_id string Уникальный идентификатор пользователя Яндекс.Метрики
sale_date iso8601 YYYY-MM-DD hh:mm:ss да да Дата сделки
sale_cost number да да Сумма сделки
search_query string да Поисковый запрос
search_engine string да Название поисковой системы
referrer_domain string да Домен реферера
referrer string да Источник перехода
entrance_page string да Страница входа
gclid string да Google Click Identifier
yclid string да Yandex Click Identifier
ymclid string Yandex Market Click Identifier
ef_id string да Используется для разметки ссылок в системе управления контекстной рекламой AdLense
channel enum
  • display
  • paid
  • affiliate
  • messenger
  • social
  • email
  • organic
  • internal
  • recommendation
  • cashed
  • referral
  • direct
да Канал.
Проставленные теги
tags array да Теги, см. метод "get.tags"
tag_id number Уникальный идентификатор тега
tag_name string Название тега
tag_type enum auto, manual Тип тега
tag_change_time iso8601 YYYY-MM-DD hh:mm:ss Дата и время простановки тега
tag_user_id number Уникальный идентификатор пользователя, который проставил тег
tag_user_login string Логин пользователя, который проставил тег
tag_employee_id number Уникальный идентификатор сотрудника, который проставил тег
tag_employee_full_name string Ф.И.О. сотрудника который проставил тег
Информация о посетителе
visitor_id number да да да Уникальный идентификатор посетителя
person_id number да да Уникальный идентификатор персоны
visitor_type enum Новый, Вернувшийся, Не заполнен да да Тип посетителя
visitor_session_id number да да Уникальный идентификатор сессии посетителя, см. "get.visitor_sessions_report"
visits_count number да Количество посещений
visitor_first_campaign_id number да Уникальный идентификатор первой рекламной кампании.
visitor_first_campaign_name string да Название первой рекламной кампании
visitor_city string да Город посетителя
visitor_region string да Регион посетителя
visitor_country string да Страна посетителя
visitor_device enum
  • desktop
  • mobile
  • tablet
  • other
да да Устройство посетителя
Свойства посетителя
visitor_custom_properties array да Свойства посетителя, которые могут быть заданы через личный кабинет или с помощью JavaScript API [метод Comagic.setProperty(name, value);]
property_name string Имя свойства, которое должно быть присвоено посетителю
property_value string Значение свойства
Сайт
site_id number да да да Уникальный идентификатор сайта
site_domain_name string да Адрес сайта в интернете. Без указания протокола - "http://" или "https://"
Рекламная кампания
campaign_id number да да да Уникальный идентификатор рекламной кампании
campaign_name string да Название рекламной кампании
visit_other_campaign boolean true, false да Флаг показывает заходил ли посетитель (в пределах персоны) по другим рекламным кампаниям
Сегменты
segments array да Сегменты
segment_name string Название сегмента
segment_id number Уникальный идентификатор сегмента
UTM-метки
utm_source string да Источник кампании
utm_medium string да Канал кампании
utm_term string да Ключевое слово кампании
utm_content string да Содержание кампании
utm_campaign string да Название кампании
utm_referrer string да Источник перехода на сайт
utm_expid string да Идентификатор эксперимента в Google Analytics
OS-метки
openstat_ad string да Идентификатор рекламного объявления
openstat_campaign string да Идентификатор рекламной кампании
openstat_service string да Идентификатор сервиса, предоставляющего услуги
openstat_source string да Идентификатор площадки, раздела, страницы, места на странице, на котором было показано соответствующее рекламное объявление
Атрибуты обращения
attributes array
  • first - Первый качественный
  • through - Сквозной первый качественный
  • primary - Первичное
  • secondary - Вторичное
  • lost - Потерянное
  • target - Целевое
  • off-target - Не целевое
  • quality - Качественное
  • rest - целевые повторные обращения (обращения, совершенные в период повторного обращения, настроенного для сайта в ЛК CoMagic).
да Атрибут обращения
Расширенные UTM-метки
eq_utm_source string да Расширенная utm_source
eq_utm_medium string да Расширенная utm_medium
eq_utm_term string да Расширенная utm_term
eq_utm_content string да Расширенная utm_content
eq_utm_campaign string да Расширенная utm_campaign
eq_utm_referrer string да Расширенная utm_referrer
eq_utm_expid string да Расширенная utm_expid

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

{
  "jsonrpc":"2.0",
  "id":"number",
  "method":"get.communications_report",
  "params":{
    "access_token":"string",
    "user_id":"number",
    "offset":"number",
    "limit":"number",
    "date_from":"iso8601",
    "date_till":"iso8601",
    "filter":{

    },
    "sort":[
      {
        "field":"string",
        "order":"string"
      }
    ],
    "fields:[
      "string"
    ]
  }
}

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

{
  "jsonrpc":"2.0",
  "id":"number",
  "result":{
    "metadata":{

    },
    "data":[
      {
        "id":"number",
        "communication_type":"enum",
        "communication_number":"number",
        "communication_page_url": "string",
        "date_time":"iso8601",
        "ua_client_id":"string",
        "ym_client_id": "string",
        "sale_date":"iso8601",
        "sale_cost":"number",
        "search_query":"string",
        "search_engine":"string",
        "referrer_domain":"string",
        "referrer":"string",
        "entrance_page":"string",
        "gclid":"string",
        "yclid":"string",
        "ymclid":"string",
        "ef_id":"string",
        "channel":"enum",
        "tags":[
          {
            "tag_id":"number",
            "tag_name":"string",
            "tag_type":"enum",
            "tag_change_time":"iso8601",
            "tag_user_id":"number",
            "tag_user_login":"string",
            "tag_employee_id":"number",
            "tag_employee_full":"string"
          }
        ],
        "site_id":"number",
        "site_domain_name":"string",
        "campaign_id":"number",
        "campaign_name":"string",
        "visit_other_campaign":"boolean",
        "visitor_id":"number",
        "person_id":"number",
        "visitor_type":"enum",
        "visitor_session_id":"number",
        "visits_count":"number",
        "visitor_first_campaign_id":"number",
        "visitor_first_campaign_name":"string",
        "visitor_city":"string",
        "visitor_region":"string",
        "visitor_country":"string",
        "visitor_device":"enum",
        "visitor_custom_properties":[
          {
            "property_name":"string",
            "property_value":"string"
          }
        ],
        "segments":[
          {
            "segment_id":"number",
            "segment_name":"string"
          }
        ],
        "utm_source":"string",
        "utm_medium":"string",
        "utm_term":"string",
        "utm_content":"string",
        "utm_campaign":"string",
        "openstat_ad":"string",
        "openstat_campaign":"string",
        "openstat_service":"string",
        "openstat_source":"string",
        "eq_utm_source": "string",
        "eq_utm_medium": "string",
        "eq_utm_term": "string",
        "eq_utm_content": "string",
        "eq_utm_campaign": "string",
        "eq_utm_referrer": "string",
        "eq_utm_expid": "string",
        "attributes":[

        ]
      }
    ]
  }
}

Список возвращаемых ошибок

Смотрим раздел "Список ошибок для методов с глаголом get"