Підключення HTTP-запиту

Як і інші зовнішні джерела даних, HTTP-запит дозволяє автоматизувати створення контенту повідомлення. Цей запит вивантажує та надсилає дані контакту з eSputnik до інших систем, і навпаки, передає до eSputnik дані зі сторонніх систем. З його допомогою ви можете звернутися до власного API, який обробить запит і поверне у повідомлення дані для персоналізації, наприклад — особистий промокод. Для передавання даних використовується мова Velocity.

Створення джерела даних

1. У налаштуваннях облікового запису відкрийте вкладку Джерела даних, натисніть кнопку Нове джерело та виберіть Зовнішні джерела даних.

2. Виберіть HTTP-запит.

Налаштування з'єднання

1. Дайте джерелу даних довільну назву.

2. За потреби додайте його опис.
3. Виберіть тип запиту: GET чи POST.
4. Введіть URL-адресу, до якої буде звертатися запит (це може бути лише захищений протокол HTTPS. Можна звертатися до полів контакту або параметрів події).

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

6. Щоб налаштувати аутентифікацію, активуйте відповідний світчер. Доступно чотири типи аутентифікації:

• Basic,
• Bearer token,
• API key (у заголовках або в рядку запиту),
• OAuth 2.0.

Задайте назву конектора, виберіть потрібний тип аутентифікації, введіть ідентифікаційні дані (логін та пароль/токен/ключ) та натисніть кнопку Готово.

Для типу OAuth 2.0 у формі конектора також є поле Провайдер. Якщо вибрано Інший провайдер, з'являється поле Grant type, яке визначає спосіб авторизації:

• Authorization code — стандартний флоу з входом на боці провайдера: після натискання Підключити відбувається переадресація на сторінку авторизації провайдера (використовується поле URL аутентифікації).
• Client credentials — без входу користувача: токен доступу запитується безпосередньо з Token URL за допомогою Client ID, Client Secret і Scopes, указаних у розділі Розширена конфігурація. Цей тип підходить для інтеграцій сервер–сервер, наприклад із Microsoft Entra ID.

Отриманий токен автоматично додається до заголовка Authorization: Bearer запитів і оновлюється незадовго до завершення строку дії.

7. Якщо ваш застосунок зчитує параметри з тіла запиту, активуйте відповідний світчер, вкажіть формат: JSON, XML або text, та введіть у поле тіло запиту.

Тестування з'єднання

Перед збереженням джерела даних натисніть Надіслати тест, щоб перевірити запит.

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

Під час тестування можна перевірити:

• поля контакту у форматі $firstName або ${firstName};
• email-адресу контакту;
• додаткові поля контакту;
• параметри та ключі події.

Перевірте тестовий запит і переконайтеся, що ці значення підставлено коректно. Це допоможе знайти помилки у виразах Velocity або відсутні дані персоналізації до використання HTTP-джерела даних у робочому середовищі.

Наприклад, у наведеній нижче тестовій події використовуються змінні Velocity для email-адреси та імені контакту:

{
  "eventTypeKey": "productViewed",
  "keyValue": "9d0c163d-cc3b-4f9e-bb03-2f5d1111ef91",
  "params": {
    "customerId": "9d0c163d-cc3b-4f9e-bb03-2f5d4f1def91",
    "email": "${email}",
    "name": "${firstName}",
    "product": [
      {
        "isInStock": 1,
        "name": "Dasmal Decoria, 60x100 cm",
        "price": 9.9,
        "productId": "11111",
        "quantity": 1
      },
      {
        "isInStock": 1,
        "name": "Dasmal Decoria, 60x100 cm",
        "price": 9.9,
        "productId": "139902",
        "quantity": 1
      }
    ],
    "currencyCode": "USD"
  }
}

Про налаштування звернення до зовнішнього джерела у листі читайте тут >