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

Щоб додати нові контакти, використовуйте потокову передачу даних у форматі 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": "[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 символів).