Соединитель Unisender синхронизирует контакты электронной почты и метаданные списков из Unisender в базу знаний. Каждый контакт преобразуется в документ, содержащий электронную почту, имя, пользовательские поля и статус подписки.
Аутентификация
API-ключ — требуется:
- Корректный API-ключ Unisender с доступом к контактам и спискам
Конфигурация
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| ID списка | Ввод | Да | ID списка Unisender для синхронизации контактов |
| Включить пользовательские поля | Переключатель | Нет | Включить значения пользовательских полей в документы |
| Макс. контактов | Ввод | Нет | Ограничить количество синхронизируемых контактов (по умолчанию: неограниченно) |
| Фильтр статуса | Выпадающее меню | Нет | Фильтровать по статусу подписки (активный/неактивный/все) |
Как это работает
- Получение списка — Получает выбранный список и метаданные его пользовательских полей
- Получение контактов — Извлекает контакты с разбиением на страницы (100 на странице)
- Генерация документов — Каждый контакт отображается как
email: name (custom_fields) - Нормализация полей — Пользовательские поля нормализуются с префиксом
Формат документа
Email: user@example.com
Имя: John Doe
Статус: Активный
Пользовательское поле 1: ЗначениеТеги метаданных
| Тег | Тип | Описание |
|---|---|---|
| ID списка | Текст | Идентификатор исходного списка |
| Статус подписки | Категория | активный, неактивный или неподтвержденный |
Разбиение на страницы
Использует разбиение на страницы на основе смещения. Формат курсора: offset:{contact_offset}.
Ограничения
- Максимум 100 контактов на странице API
- Пользовательские поля должны быть предварительно настроены в Unisender
- Неактивные контакты могут быть отфильтрованы, но не удалены