Как подключить Postback в UTMSTAT

Что такое Postback?

Postback или вебхук – это post-запрос отправляемый из UTMSTAT на внешний url-адрес, в момент создания заявки.

Это обычно нужно, когда у вам самописная CRM и нет готовых интеграций, в этом случае пишется собственный коннектор к UTMSTAT по такой схеме.

Формат данных

Отправляем данные в виде base64. Данные декодировать можно либо онлайн либо через функцию PHP.

{
  "base64": "5kZXhfY2xpZW50X2lkIj ... 3MjUzMDUxNC40In19fX0=
}

В декодированном виде данные представляют из себя json с информацией о заявке

{
  "id": 819194,
  "queue_id": 34345,
  "project_id": 1000,
  "created_at": 1599724744,
  "contact": {
    "id": 538538,
    "phone": "79990000000",
    "email": "test@yandex.ru",
    "name": "79990000000 Елена"
  },
  "fields": [
    {
      "code": "order_price",
      "name": "Стоимость заказа",
      "value": "1590"
    },
    {
      "code": "order_status",
      "name": "Статус заявки",
      "value": "1.00"
    }
  ],
  "source": {
    "first_click": {
      "utm": {
        "utm_source": "google",
        "utm_medium": "cpc",
        "utm_campaign": "10457412163",
        "utm_content": "446114078055",
        "utm_term": "коллтрекинг",
        "source_type_group_id": 21,
        "ip": 1839695353,
        "ga_client_id": "1975805037.1599586104",
        "ym_client_id": "1599586105905052299",
        "referrer": "https:\/\/www.google.com\/"
      },
      "ppc": {
        "campaign_id": "10457412163",
        "group_id": "106689744467",
        "ad_id": "446114078055",
        "phrase_id": "298223131678",
        "keyword": "коллтрекинг"
      },
      "device": {
        "device_type_id": 3,
        "device_type_name": "Desktop",
        "device_id": 1,
        "device_name": "Неизвестно",
        "screen_resolution": "1366x768"
      },
      "site": {
        "domain": "example.ru",
        "url": "https:\/\/example.ru",
        "url_path": "https:\/\/example.ru"
      },
      "geo": {
        "country_id": 185,
        "country_name": "Россия",
        "region_id": 536203,
        "region_name": "Санкт-Петербург",
        "city_id": 498817,
        "city_name": "Санкт-Петербург"
      },
      "clients_id": {
        "utmstat_client_id": "1599586105944923089",
        "google_client_id": "1975805037.1599586104",
        "yandex_client_id": "1599586105905052299",
        "facebook_client_id": ""
      },
      "date": {
        "created_at": "2020-09-08",
        "timestamp": 1599586121
      }
    },
    "last_significant_click": {
      "utm": {
        "utm_source": "google",
        "utm_medium": "cpc",
        "utm_campaign": "10457412163",
        "utm_content": "446114078055",
        "utm_term": "коллтрекинг",
        "source_type_group_id": 21,
        "ip": 1839695353,
        "ga_client_id": "1975805037.1599586104",
        "ym_client_id": "1599586105905052299",
        "referrer": "https:\/\/www.google.com\/"
      },
      "ppc": {
        "campaign_id": "10457412163",
        "group_id": "106689744467",
        "ad_id": "446114078055",
        "phrase_id": "298223131678",
        "keyword": "коллтрекинг"
      },
      "device": {
        "device_type_id": 3,
        "device_type_name": "Desktop",
        "device_id": 1,
        "device_name": "Неизвестно",
        "screen_resolution": "1366x768"
      },
      "site": {
        "domain": "example.ru",
        "url": "https:\/\/example.ru",
        "url_path": "https:\/\/example.ru"
      },
      "geo": {
        "country_id": 185,
        "country_name": "Россия",
        "region_id": 536203,
        "region_name": "Санкт-Петербург",
        "city_id": 498817,
        "city_name": "Санкт-Петербург"
      },
      "clients_id": {
        "utmstat_client_id": "1599586105944923089",
        "google_client_id": "1975805037.1599586104",
        "yandex_client_id": "1599586105905052299",
        "facebook_client_id": ""
      },
      "date": {
        "created_at": "2020-09-10",
        "timestamp": 1599724386
      }
    }
  }
}

Как подключить интеграцию

1. Перейдите в раздел Начало работы / Настройки интеграций

2. Найдите внизу в разделе CRM, интеграцию POSTBACK

3. В качестве url, укажите url адрес вашего обработчика, который будет принимать POST-запрос от UTMSTAT.

Ссылка может выглядеть так:

http://example.com/utmstat/postback

Если вам нужна безопасность, добавьте параметр hash и проверяйте на своей стороне, тогда ссылка будет выглядеть так:

http://example.com/utmstat/postback?hash=h123g123g1231

Для теста можно использовать сервис https://webhook.site/

4. Нажмите Подключить, если все сделано правильно, индикаторы загорятся зеленым и к вам начнут приходить данные.