Додавання нових контактів

Щоб додати нові контакти, використовуйте потокову передачу даних у форматі JSON через Public API.

Використовуйте метод Add Contact, щоб створити або оновити профіль контакту в eSputnik.

📘

Важливо

  • Цей метод не генерує події, тому не підходить для запуску сценаріїв.
  • Метод створює контакти з підтвердженими email-адресами, як і у разі їхнього імпорту з файлу. Тому налаштувати подвійну підписку (DOI) не можна.
  • Якщо потрібно записати кастомні дані про підписників, створіть додаткові поля перед завантаженням контактів.
  • Щоб додати/оновити велику кількість контактів, використовуйте метод Add Contacts. Цей ресурс дозволяє одним запитом додавати/оновлювати до 3000 контактів.

Зразок тіла запиту у форматі JSON

У запиті Add Contact потрібно надсилати канали; інші поля необов'язкові. Формат та опис усіх полів доступні за посиланням.

{
  "firstName": "John",
  "lastName": "Smith",
  "channels": [
    {
      "type": "mobilepush",
      "value": "8900-7654-6456-9876-0012",
      "device": {
        "appId": "83b77a49-fc28-409b-aeaa-68c9d544ab9d",
        "deviceModel": "iPhone 13",
        "os": "iOS",
        "locale": "uk-UA",
        "clientVersion": "native",
        "appVersion": "4.1.7",
        "active": true
      }
    },
    {
      "type": "email",
      "value": "[email protected]"
    }
  ],
  "fields": [
    {
      "id": 12345,
      "value": "writer"
    },
    {
      "id": 12346,
      "value": "1990-03-09"
    }
  ]
}

Валідація імен та прізвищ контактів

eSputnik валідує контактні дані, отримані через API, за такими правилами:

Ім'я

Максимальна довжина значення в полі — 40 символів. Допускаються літери будь-якого алфавіту (unicode), та до 3 цифр.
Спеціальні символи заборонені, винятки:

  • апострофи ' (в середині слова)
  • дефіси - (в середині слова або між словами без пробілів)
  • крапка в кінці короткого(до 3-х символів) слова (наприклад, Jr.)

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

Прізвище

Правила валідації такі ж, як і для поля Ім'я, за винятком того, що допускається будь-яка кількість слів будь-якої довжини (але сумарно не більше 40 символів).