Автоматизация работы с заказами | Support eSputnik

Email

Омниканальность

Автоматизация

Автоматизация работы с заказами

Автоматизация заказов позволяет обрабатывать продажи, отправлять триггерные транзакционные серии сообщений и персонализированные уведомления.

Передача заказов API-ресурсом  Add orders

Для передачи заказов необходимо настроить вызов специального API-ресурса Add orders. В запросе можно передать  до 1000 заказов.

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

Названия событий состоят из двух частей: слова order и  дописанного к нему статуса заказа, например: orderINITIALIZED, orderIN_PROGRESS, orderDELIVERED, orderCANCELLED, orderABANDONED_SHOPPING_CART.

Чтобы посмотреть созданные события, перейдите в раздел “Триггеры” →  “История событий”:

История событий

Каждое событие содержит обязательные параметры и может содержать дополнительные параметры:

  • ${eventKey}  — ключ уникальности события, передаётся в поле externalOrderId. Используется как идентификатор заказа;

  • ${orderId}  — ID события в системе; параметр нужен для работы сценария;

  • ${contactId}  — ID контакта в системе;

  • ${EmailAddress}  — адрес электронной почты контакта, если он передаётся в событии;

  • ${SMS}  — номер телефона контакта, если он передается в событии.

Важно

Если в событии не передан адрес электронной почты или номер телефона, система не привяжет контакты к заказам и не отправит сообщения этим контактам. В таких случаях ID контакта можно увидеть на вкладке “Триггеры” → “Заказы” → столбец “Контактные данные”.

Чтобы подставить значения параметров в сообщения, передавайте поля с параметрами события в виде массива.

  • Обязательные поля в массиве orders: externalOrderId, externalCustomerId, totalCost, status, date, email или phone

  • Обязательные поля в массиве items: (externalItemId, name, quantity, cost, url, imageUrl).

Массив с товарами items можно не передавать, если в письмах данные о товарах не нужны, или вы передаете заказы только для RFM-анализа.

См. полный список полей заказа с описаниями >

Пример тела запроса:

{
    "orders": [{
        "externalOrderId": "100500",
        "externalCustomerId": "12345",
        "totalCost": 1000,
        "status": "INITIALIZED",
        "date": "2017-03-08T09:30:00+02:00",
        "email": "mail@example.com",
        "phone": "380942583691",
        "firstName": "John",
        "lastName": "Smith",
        "currency": "USD",
        "shipping": 10,
        "discount": 0,
        "deliveryMethod": "express",
        "paymentMethod": "cash",
        "deliveryAddress": "First str. 1",
        "items": [{
            "externalItemId": "200600",
            "name": "Super Device",
            "category": "devices",
            "quantity": 1,
            "cost": 990,
            "url": "http://example.com/item/200600",
            "imageUrl": "http://example.com/item/200600/image.png",
            "description": "High quality"
        }]
    }]
}

Успешный ответ на запрос будет содержать статус 200.

Важно

Для формирования RFM-таблицы используются только заказы со статусом DELIVERED.

По заказам со статусом DELIVERED можно настроить сегментацию с такими условиями: средний чек, количество продаж и дата последней продажи.

Контакты из заказов со статусом DELIVERED

ABANDONED_SHOPPING_CART  — статус для брошенных корзин. Используйте этот статус, если вы сами занимаетесь определением брошенных корзин.  При использовании веб-трекинга  настраивать API для брошенных корзин не нужно.

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

Чтобы проверить корректность передачи заказа, перейдите в раздел:

 “Триггеры” → “Заказы” вашего аккаунта eSputnik. Кликните на ID заказа и просмотрите все поля в формате JSON.

Чтобы просмотреть информацию о контакте, нажмите значок “Предварительный просмотр контакта”

Важно

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

  • Если ранее уже был заказ с таким externalCustomerId, то система сразу записывает новый заказ тому же контакту.
  • Если такого externalCustomerId ранее не было, то будет идти проверка по номеру телефона и почте.

Создание сценариев

Каждый раз когда вы передаете заказ по API, в системе создается событие, которое может запускать сценарий. События создаются нескольких типов. Для каждого статуса заказа тип события будет свой, что позволяет вам настроить отдельные триггеры для каждого изменения статуса заказа. Названия событий состоят из слова order и дописанного к нему статуса заказа. То есть возможны такие события: orderINITIALIZED, orderIN_PROGRESS, odrerDELIVERED, orderCANCELLED и orderABANDONED_SHOPPING_CART. Создаваемые события вы можете увидеть в Истории событий:

История событий

В качестве ключей событий используются ваши идентификаторы заказов (те, которые вы передаете в параметре "externalOrderId"). События по заказам содержат такие параметры:

  • ${eventKey} - ключ уникальности заказа содержит значение поля "externalOrderId";
  • ${orderId} - id заказа в базе eSputnik. Параметр нужен для работы сценария;
  • ${contactId} - id контакта в eSputnik;
  • ${EmailAddress} - email-адрес покупателя (если передан в заказе);
  • ${SMS} - номер телефона покупателя (если передан в заказе).

Важно!

Если в заказе не передан ни email ни номер телефона, то система не может связать покупателя с контактом, такому покупателю невозможно отправлять сообщения, поэтому события для таких заказов не создаются.

Для создания сценария перейдите в раздел "Триггеры" → "Сценарии". Нажмите кнопку  "Новый сценарий".

Создание нового сценария

Указываете название сценария (Заказ доставлен, Заказ в процессе и т.д). Сценарий будет выглядеть следующим образом:

Cоздание структуры сценария

В сценарии нужны такие блоки:

  • блок Задача  Получить заказ. С помощью данного блока система вытянет все данные о заказе и передаст в письмо
  • блок Email (или SMS). Выбираете письмо (сообщение), которое вы предварительно создали для данного сценария (уведомление о заказе, оставьте отзыв и т.д)

Сохраняем сценарий. Конечно, сценарий может быть более сложный. Можно вместо одного сообщения сделать серию. Письмо с отзывом обычно настраивают в сценарии для доставленного заказа. Перед отправкой письма ставится таймер на 1-2 недели.

Запуск сценария

После создания сценария необходимо его запустить. Для этого нажимаем Установите условие запуска, а после выбора условия кликаем на кнопку запуска сценария.

Запуск сценария

В открывшемся окне выберите событие, которое запустит сценарий.

Выбор условий запуска сценария

В итоге активный и работающий сценарий будет выглядеть следующим образом:

Как выглядит активный сценарий

Остались вопросы?
Специалисты обязательно ответят и помогут решить вашу проблему!
Обратный звонок
Оставьте заявку – и наш специалист свяжется с вами в рабочее время.
Отправить заявку
Консультация в чате
Готовы к вашим вопросам!
Написать в чат
Электронная почта
Напишите в службу поддержки eSputnik.
Отправить email