Расширяйте возможности с API

Вы можете использовать данный тип события даже со сделками, созданными через API из Ваших форм. Для того, чтобы связать сделку с конкретным посетителем сайта, Вам нужно получить идентификатор этого посетителя и передать его через API вместе с данными создаваемой сделки.

Получение идентификатора посетителя

Для получения идентификатора посетителя нужно разместить на Вашем сайте следующий код:

  1. <script type="text/javascript" id="amo_pixel_identifier_js" async="async" src="https://piper.amocrm.ru/pixel/js/identifier/pixel_identifier.js"></script>

Данный код создаст глобальный объект AMOPIXEL_IDENTIFIER. С помощью метода "getVisitorUid" данного объекта можно получить уникальный идентификатор посетителя:

  1. var visitor_uid = AMOPIXEL_IDENTIFIER.getVisitorUid();

Объект AMOPIXEL_IDENTIFIER доступен только после полной его загрузки и инициализации.
Вы можете указать callback-функцию, которая будет вызвана после полной инициализации объекта AMOPIXEL_IDENTIFIER.
Для указания callback-функции нужно создать глобальный объект AMOPIXEL_IDENTIFIER_PARAMS, где в поле "onload" будет указана callback-функция.
Первым аргументом в эту функцию будет передан сам объект AMOPIXEL_IDENTIFIER, но Вы можете обратиться к нему и через глобальный объект window, т.е. window.AMOPIXEL_IDENTIFIER.

  1. window.AMOPIXEL_IDENTIFIER_PARAMS = window.AMOPIXEL_IDENTIFIER_PARAMS || {};
  2. window.AMOPIXEL_IDENTIFIER_PARAMS.onload = function (pixel_identifier) {
  3.     var visitor_uid = pixel_identifier.getVisitorUid(); // Получаем visitor_uid
  4.     console.log('visitor_uid', visitor_uid);
  5.     if (visitor_uid) {
  6.       // Записываем его в скрытое поле формы 'visitor_uid'
  7.       document.getElementById('visitor_uid').value = visitor_uid;
  8.    }
  9. };

Полученный идентификатор можно записать в скрытое поле Вашей формы, передать на Ваш сервер, а затем создать сделку через API amoCRM с указанием "visitor_uid":

URL метода

POST /api/v2/leads

  1. {
  2.     "add": [
  3.           {
  4.               "name": "Заявка с сайта",
  5.               "status_id": 142,
  6.               "visitor_uid": "12345678-52d2-44c2-9e16-ba0052d9f6d6"
  7.           }
  8.      ]
  9. }

На стороне amoCRM произойдет связывание идентификатора посетителя "visitor_uid" с id созданной сделки.

Далее, при заходе клиента на отслеживаемую страницу, сделка, связанная с ним, автоматически перейдет в настроенный этап.

Примечание: в качестве значения поля "visitor_uid" можно использовать только идентификатор, полученный от AMOPIXEL_IDENTIFIER. Формат идентификатора соответствует UUID. Если передать некорректное значение, оно будет проигнорировано.