Автоматизація роботи із замовленнями

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

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

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

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

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

Щоб переглянути  створені події, перейдіть до розділу “Тригери” → “Історія подій”:

Кожна подія містить обов'язкові параметри та може містити додаткові параметри:

• ${eventKey} — ключ унікальності замовлення. Передається в поле externalOrderId. Використовується як ідентифікатор замовлення;

• ${orderId} — ID замовлення в системі; параметр потрібний для роботи сценарію;

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

• ${EmailAddress} — email-адреса контакту (якщо передається в події);

• ${SMS} — номер телефону контакту, (якщо передається в події).

Щоб замінити значення параметрів повідомлення, передавайте поля з параметрами події у вигляді масиву.

• Обов'язкові поля у масиві ordes: 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.

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

ABANDONED_SHOPPING_CART — статус для покинутих кошиків. Використовуйте цей статус якщо ви самі займаєтесь визначенням покинутих кошиків. При використанні веб-трекінгу налаштовувати API для покинутих кошиків не потрібно.

Для оновлення статусу або інших даних замовлення передавайте оновлене замовлення з тим самим externalOrderId. За цим параметром у системі визначається унікальність замовлень.

Щоб перевірити правильність передачі замовлення, перейдіть до розділу: “Тригери” — “Замовлення” вашого облікового запису eSputnik. Натисніть ID замовлення, і перегляньте всі поля у форматі JSON.

Щоб переглянути інформацію про контакт, натисніть значок "Попередній перегляд контакту".

Важливо

Створення сценаріїв для тригерних розсилок

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

У ролі ключів подій використовуються ваші ідентифікатори замовлень (ті, які ви передаєте в параметрі "externalOrderId"). Події за замовленнями містять такі параметри:

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

Для створення сценарію вибираємо Тригери → Сценарії → Додати сценарій

Вказуєте назву сценарію (Замовлення доставлено, Замовлення в процесі та ін.). Сценарій матиме такий вигляд:

У сценарії потрібні такі блоки:

• блок Завдання — Отримати замовлення. За допомогою цього блоку система витягне всі дані щодо замовлення йі передасть у лист;
• блок Email (або SMS). Вибираєте лист (повідомлення), яке ви заздалегідь створили для цього сценарію (повідомлення про замовлення, залиште відгук та ін.).

Зберігаємо сценарій. Звичайно, сценарій може бути більш складним. Можна замість одного повідомлення зробити серію. Лист із відгуком зазвичай налаштовують у сценарії для доставленого замовлення. Перед відправленням листа виставляється таймер на 1-2 тижні.

Запуск сценарію

Після створення сценарію необхідно його запустити. Для цього натискаємо Встановіть умову запуску, а після вибору умови клікаємо кнопку запуску сценарію.

У вікні, що відкриється, виберіть подію, яка запустить сценарій.

У результаті активний і працюючий сценарій виглядатиме так: