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

Ви можете передавати дані щодо замовлень до eSputnik, щоб:

  • користуватися RFM-аналізом вашої контактної бази;
  • відправляти покупцям повідомлення, пов'язані із замовленнями, і виконувати інші дії з контактами.

Створення автоматичних тригерних листів, які пов'язані із замовленнями (замовлення отримано, замовлення відправлено, залиште відгук про купівлю та ін.) складається з таких етапів:

  • налаштування передачі замовлень за API;
  • створення листів з динамічним контентом;
  • створення сценаріїв для тригерних розсилок.

Налаштування передачі замовлень за API

Для передачі замовлень необхідно налаштувати виклик спеціального методу API /v1/orders. У запиті передаються одне або кілька замовлень (до 1000). Кожне замовлення має містити певні обов'язкові поля. Решта полів є опціональними. Передавайте ті поля, які ви, можливо, захочете використовувати в листах. Звичайно, щоб підставляти в листи товари, у замовленнях треба передавати масив із даними щодо цих товарів. Формат запиту й опис усіх полів доступні тут.

Приклад тіла запиту:

{
    "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"
        }]
    }]
}

Обов'язкові поля виділені жирним. Масив з товарами items можна не передавати, якщо в листах дані щодо товарів вам не потрібні або ви передаєте замовлення тільки для RFM-аналізу.

Вдала відповідь на запит міститиме статус 200.

Для замовлень можна використовувати кілька статусів. Наприклад, для щойно створеного замовлення використовуйте статус INITIALIZED. Для замовлення в процесі доставлення IN_PROGRESS. Для оплаченого і доставленого замовлення — DELIVERED. Для скасованих замовлень — CANCELLED.

Важливо!

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

Також є статус для покинутих кошиків ABANDONED_SHOPPING_CART. Використовувати цей статус потрібно, якщо ви самостійно займаєтеся визначенням покинутих кошиків. Якщо ж ви використовуєте функціонал, то налаштовувати API для покинутих кошиків взагалі не потрібно.

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

Перевірити, чи потрапило замовлення до системи і чи коректно передані поля, можна в особистому кабінеті в розділі Тригери — Замовлення. Клікнувши ID замовлення, ви побачите всі поля у форматі JSON.

Важливо!

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

  • Якщо раніше вже було замовлення з таким externalCustomerId, то система відразу записує нове замовлення тому ж контакту.
  • Якщо такого externalCustomerId не було раніше, то відбудеться перевірка за номером телефону та поштою.

Створення листів з динамічним контентом

Для створення листа переходимо до Повідомлень → Повідомлення і натискаємо Створити email

Створення повідомлення з динамічним контентом

Припустимо, треба відправити клієнту повідомлення про здійснене замовлення, вказати спосіб і місце доставки, а також форму оплати.

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

Створення шаблону листа для замовлення

 

Потім за допомогою velocity лист необхідно обладнати динамічним контентом.

Так виглядатиме готовий лист, який замість тексту містить назву змінних. Наприклад, замість Іванов Сергій ви підставляєте назви змінних із замовлення, які містять прізвище lastName та ім'я firstName.

Шаблон листа для замовлення з динамічним контентом

Важливий момент!

Якщо ви бажаєте відобразити в листі дані щодо товарів — використовуйте таку конструкцію:

- це початок блоку - кінець блоку

Для цього потрібно виділити структуру, в якій буде розміщено динамічний контент, відкрити редактор коду й додати код, як показано нижче:

Як додати код для виведення масиву із замовлення

 

У середині цього блоку прописуйте змінні, які містять дані про товари. У нашому прикладі це $!item.get('name') (назва товару) і $!item.get('cost') (вартість товару). Для блоку зображення в ролі посилання на сторінку товару прописуємо $!item.get('url'), для картинки $!item.get('imageUrl') і альтернативний текст $!item.get('name').

Змінна в ролі адреси зображення

Для зручності створення й тестування листа в редакторі є спеціальна функція, яка дозволяє підставити динамічні дані й одразу без відправлення побачити результат. Доступна вона в редакторі за кліком на Три крапки - Налаштування динамічного контенту.

Підстановка json даних для попереднього перегляду

У вікні, що відкриється, у текстове поле треба вставити JSON-дані щодо замовлення. І натиснути "Перегляд повідомлення"

Як вставити JSON-дані щодо замовлення

Ці дані не треба набирати вручну. Можна взяти їх із будь-якого переданого до системи замовлення. Для цього треба зайти до Тригерів → Замовлення.

Розділ замовлень у eSputnik

У таблиці замовлень клікніть на будь-яке замовлення.

Вибір замовлення зі списку замовлень

Відкриється вікно з даними щодо замовлення. Використовуйте ці дані у вікні редактора повідомлень.

Перегляд даних про замовлення

Після того як ви вставите дані щодо замовлення в редакторі, ви побачите, як виглядатиме ваш лист із підставленими даними.

Попередній перегляд підстановки даних

Важливо:

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

Для SMS-повідомлень використовуйте такий самий код. Наприклад, номер замовлення можна підставити в повідомлення такою змінною: $!data.get('externalOrderId'), сума заказу $!data.get('totalCost').

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

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

Перегляд історії подій

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

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

Важливо!

Якщо в замовленні не передано ані email, ані номер телефону, то система не може пов'язати покупця з контактом; такому покупцеві неможливо відправляти повідомлення, тому події для таких замовлень не створюються.

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

Як створити сценарій в eSputnik

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

Створення структури сценарію

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

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

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

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

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

Як запустити сценарій

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

Вибір умов запуску сценарію

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

Як виглядає активний сценарій

Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email