Добавление новых контактов | Support eSputnik

Пользовательские данные

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