Интеграция с Passteam

Порядок настройки, ограничения и возможности указаны по ссылке (Интеграция с Passteam).

Шаг 1 — создаем точку интеграции

Снимок экрана 2021-11-30 в 19.19.21.png

Шаг 2— создаем операции

1. Passteam.ExportCustomers. Позволяет экспортировать клиентов при синхронизации с Passteam:

Снимок экрана 2021-11-30 в 18.45.40.png

Снимок экрана 2021-11-30 в 18.45.56.png

После вызова операции создается задание на генерацию JSON файла, запуск синхронизации возможен только после того, как задание выполнится.

2. Passteam.CreateCustomer. Операция позволяет импортировать клиентов на стороне MB, при создании в Passteam карты:

Снимок экрана 2021-11-30 в 18.48.26.png

3. Passteam.GetCustomerByPhone. Позволяет находить в Mindbox клиента по номеру телефона. В интеграции используется как метод дедубликации, чтобы не возникал случай повторного создания клиента в Mindbox:

Снимок экрана 2021-11-30 в 18.49.48.png

4. Passteam.UpdateCustomer. Позволяет находить в MB клиента по номеру телефона, после чего обновляет его данными, переданными из запроса при установке карты в Passteam:

Снимок экрана 2021-11-30 в 18.51.08.png

ШАГ 3 — создаем веб-хук

Снимок экрана 2022-02-17 в 23.08.37 — копия.png

Тип: POST
Url : https://app.passteam.io/integrations/mindbox/webhook
Content-Type: application/json
MindboxKey - secretKey для подключаемой точки интеграции
companyId – идентификатор, который получает менеджер – id компании в Passteam

Тело запроса:

{
	"companyId":"...",
	"action":"customerUpdated",
	"fields":{
	    "%NAME%":"${Recipient.FirstName}",
	    "%SURNAME%":"${Recipient.LastName}",
	    "%EMAIL%":"${Recipient.Email}",
	    "%PHONE%":"${Recipient.MobilePhone}",
        "%_BALANCE%":"${Recipient.GetBonusPointsAccount("Main").Available}",
	    "%CARDCODE%": "${Recipient.Card.AnyType.Number}"
	}
}

Набор полей в теле запроса индивидуален для каждого клиента.

Синтаксис: %название_переменной_Passteam%: “поле в Mindbox“

Переменные в Passteam:

Passteam	Значение
%NAME%	Имя
%SURNAME%	Фамилия
%PATRONYMIC%	Отчество
%EMAIL%	Адрес электронной почты
%PHONE%	Номер телефона
%BIRTHDAY%	День рождения
%SEX%	Пол - возможные значения: male, female
%NEXTBURNBALANCE%	Сумма баллов к сгоранию
%DISCOUNT%	Скидка
%NEXTBURNDATE%	Дата сгорания баллов
%BONUS%	Кэшбэк
%_BALANCE%	Бонусы