Mindbox
Редактирование данных клиента

xml

В инструкции описаны примеры POST-запросов. Интеграция с Mindbox не будет работать, если использовать запросы из примеров ниже без редактирования.

Операции именно под вашу задачу создает и описывает в техническом задании менеджер проекта, если у вас нет такого документа, то обратитесь к вашему менеджеру.

Описание метода

Осуществляется с помощью POST-запроса. Название операции и набор принимаемых полей настраиваются в системе Майндбокс. Подробней про вызов метода можно прочитать здесь.

XMLУниверсальная операция
POST https://api.mindbox.ru/v3/operations/{синхронная/асинхронная операция}?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}&deviceUUID={уникальный идентификатор устройства}

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey {Секретный ключ, обязательность уточнить у менеджера}

<operation>
  <customer>
    <authenticationTicket>{Секретный тикет}</authenticationTicket>
    <ids>
      <webSiteUserId>{Идентификатор клиента}</webSiteUserId>
    </ids>
    <email>{Емэйл клиента}</email>
    <mobilePhone>{Мобильный телефон}</mobilePhone>
    <lastName>{Фамилия клиента}</lastName>
    <firstName>{Имя клиента}</firstName>
    <birthDate>{Дата рождения в формате YYYY-MM-DD}</birthDate>
    <password>{Пароль}</password>
    <subscriptions>
      <subscription>
        <pointOfContact>{Канал коммуникации Email/SMS/тд}</pointOfContact>
        <topic>{Тематика рассылок}</topic>
        <isSubscribed>{Статус подписки true/false}</isSubscribed>
      </subscription>
    </subscriptions>
    <customFields>
      <Дополнительное поле>{Значение дополнительного поля}</Дополнительное поле>
    </customFields>
  </customer>
</operation>

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

Чтобы затереть поле, надо передать тег с атрибутом clear. Например: <mobilePhone clear="true"/>

Примеры операций

XMLCode
POST https://api.mindbox.ru/v3/operations/async?endpointId=MindboxRu&operation=EditCustomer

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey D061p764m85bklq

<operation>
  <customer>
    <ids>
      <bitrixId>346257</bitrixId>
    </ids>
    <email>pivan@mindbox.ru</email>
    <mobilePhone>79374134389</mobilePhone>
    <lastName>Петров</lastName>
    <firstName>Иван</firstName>
    <password>Qwerty</password>
    <customFields>
      <city>Mосква</city>
      <b2b>true</b2b>
    </customFields>
    <subscriptions>
      <subscription>
        <pointOfContact>Sms</pointOfContact>
        <topic>Recommendation</topic>
        <isSubscribed>false</isSubscribed>
      </subscription>
      <subscription>
        <pointOfContact>Email</pointOfContact>
        <topic>Recommendation</topic>
        <isSubscribed>true</isSubscribed>
      </subscription>
    </subscriptions>
  </customer>
</operation>
Last modified on
Редактирование данных клиентаjavascript