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

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

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

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

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

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

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

Шаг 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%`	Бонусы