Lpgenerator™

Если форма размещена на страницах сайта, созданного в сервисе LPgenerator, то данные клиента, заполнившего форму, можно передать в Altcraft Platform. Так, вы можете создать профиль для нового клиента или обновить данные уже существующего.

Чтобы подключить формы LPGenerator к аккаунту Altcraft, перейдите в личный кабинет LPGenerator. Кликните "Действия" для выбранной страницы, а затем выберите "Центр оптимизации конверсии".

После этого в блоке "Интеграции" в разделе "Другие сервисы" выберите Webhook.

Описание работы Webhook на стороне сервиса: https://lpgenerator.ru/blog/2018/04/03/webhook-samostoyatelnaya-integraciya-storonnih-servisov/

Настройка Webhook интеграции

Добавьте новый Webhook и укажите следующие данные:

URL: https://example.com/api/v1.1/integrations/lpgenerator/profile_import

Дополнительные поля:

Параметр	Тип	Пример	Обязательный	Описание
token	string	abcdefghijklmnqrstuvwxyz	Да	API токен для доступа к Altcraft
db_id	string	1	Да	Идентификатор базы данных для импорта
matching	string	email phone custom	Нет	Тип поиска профиля в Altcraft для обновления: по email или телефону из полей данных или подписок профиля, - или по значению дополнительного поля профиля Altcraft.
field_name	string	custom_ID	Нет	Имя кастомного поля БД Altcraft при matching: custom . В форме сбора данных для поиска нужно поле с таким же именем. Например, custom_ID
resource_id	string	3	Нет	При передаче контактных данных (email или phone) профилям будет добавляться подписка на указанный ресурс.

Поля LPGenerator по умолчанию

Ниже приведены неизменяемые системные поля запроса, передаваемого в Altcraft.

Параметр	Тип	Пример	Описание
id	string	"777777"	ID формы сбора данных
meta_data	JSON object	"meta_data" : {...}	Метаданные. Используются для автоопределения IP, геолокации подписчиков, браузера и операционной системы.
utm_data	JSON object	"utm_data" : {...}	Предопределенные данные utm (часто пусто).
lead_data	JSON object	"lead_data" : {...}	Данные подписчика из формы сбора.

Добавление формы сбора данных

В конструкторе страниц добавьте форму:

По двойному клику на область формы откроется редактор полей формы. Добавьте необходимые поля и укажите их название для отображения на сайте.

Отметьте опцию "Отправить в crm", а в поле "Название в crm"укажите название соответствующего поля в базе данных Altcraft. Для кастомных полей укажите те же названия полей, которые использовали в платформе, учитывая регистр. Список системных полей профиля Altcraft, таких как Имя или Email, доступен по этой ссылке.

Сохраните настройки и опубликуйте форму, чтобы начать передавать данные.

Примеры структуры запросов

Импорт подписчика по email-адресу:

{
	"id": 77777777,
	"lead_data": {
		"email": "qwerty@dron.ff",
	},
	"meta_data": {
		"HTTP_USER_AGENT": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
		"LANGUAGE": "en-US",
		"form_name": "форма 1",
		"from": "Страница 107570 (Первый вариант)",
		"page_id": 1642169,
		"user_ip": "96.123.123.123",
		"variant_id": 1935651
	},
	"utm_data": {}
    "db_id": "2",
    "resource_id": "2",
    "matching": "email",
    "token": "abcdefghijklmnqrstuvwxyz"
}

Обновление полей подписчика с подпиской на ресурс (с поиском подписчика по кастомному полю custom_ID):

{
	"id": 27773744,
	"lead_data": {
		"email": "ytrewq@dron.ff",
        "custom_ID": "Bagdasaryan"
	},
	"meta_data": {
		"HTTP_USER_AGENT": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
		"LANGUAGE": "en-US",
		"form_name": "форма 1",
		"from": "Страница 207571",
		"page_id": 1642169,
		"user_ip": "96.123.123.123",
		"variant_id": 1935651
	},
	"utm_data": {}
    "db_id": "2",
    "resource_id": "2",
    "matching": "custom",
    "field_name": "custom_ID",
    "token": "abcdefghijklmnqrstuvwxyz"
}

Импорт подписчика с передачей статуса подписки:

{
  "db_id": "75",
  "id": 64368040,
  "workflow_id": 4,
  "trigger_id": 1,
  "field_for_APIContent": "any data",
  "lead_data": {
    "_status": 0,
    "_fname": "By phone (explicitly) After",
    "phone": "+234257929700231073",
    "New_field_5": 6.2,
    "subscriptions": [
      {
        "resource_id": 5,
        "channel": 2,
        "channel_sid": "sms",
        "phone_data": {
          "phone": "+234257929700231073",
          "md5": "33890b49c501f101965c6ac4fb01e409"
        },
        "priority": 0,
        "status": 2,
        "hash_id": "ceffaf99",
        "is_delete": false
      }
    ]
  },
  "matching": "phone",
  "meta_data": {
    "HTTP_USER_AGENT": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
    "LANGUAGE": "en-US",
    "form_name": "\\u0444\\u043e\\u0440\\u043c\\u0430 1",
    "from": "\\u0421\\u0442\\u0440\\u0430\\u043d\\u0438\\u0446\\u0430 518658 (\\u041f\\u0435\\u0440\\u0432\\u044b\\u0439 \\u0432\\u0430\\u0440\\u0438\\u0430\\u043d\\u0442)",
    "page_id": 1623331,
    "user_ip": "94.231.119.122",
    "variant_id": 1937033
  },
  "resource_id": "5",
  "token": "a3c31d8a15714531afebfd1541eeba41",
  "utm_data": {}
}

Поле	Значение	Обазательное	Описание
workflow_id	идентификатор сценария	Нет	Добавить профиль в сценарий сразу после импорта профиля
trigger_id	идентификатор триггерной кампании	Нет	Запустить триггерную кампанию сразу после импорта профиля
_status	0 — Подписан 1 — Отписан 2 — Жалобщик 3 — Hardbounced 4 — Не подтвержден 5 — Приостановлен 6 — Не валиден	Нет	Глобальная подписка профиля
status		Нет	Статус подписки на определенный ресурс