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

Дані користувача

Email

Омніканальність

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

Відстеження подій та поведінки

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

Щоб додати нові контакти, використовуйте потокову передачу даних у форматі 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": "Android",
                "locale": "uk-UA",
                "clientVersion": "native",
                "appVersion": "4.1.7",
                "active": true
            }
        },
        {
            "type": "email",
            "value": "john.contact@gmail.com"
        }
    ],
    "fields": [
        {
            "id": 12345,
            "value": "writer"
        },
        {
            "id": 12346,
            "value": "1990-03-09"
        }
    ]
}

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

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

Ім'я

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

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

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

Прізвище

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

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