Держите списки и кампании Unisender в порядке из чата

Агент работает с Unisender через https://api.unisender.com/ru/api, где каждый вызов — это имя метода, а ключ уходит параметром запроса. Читает он списки рассылки и контакты с их полями и тегами, письма и шаблоны, кампании и статистику доставок, открытий, переходов и отписок. Из этого собираются разбор кампании по кликам, картина по спискам и регулярная сводка по приросту базы за период.

Часть данных Unisender считает не сразу: экспорт контактов и статистику доставки он ставит в очередь и возвращает идентификатор задачи, а не готовый ответ. Агент опрашивает такую задачу до готовности и показывает уже посчитанные цифры, а не полупустую выгрузку. Вторая тонкость — размер списка: отписавшиеся и невалидные адреса остаются в нём со своим статусом, поэтому число контактов и число реальных адресатов у вас не совпадут, и агент разделяет их явно.

На запись агент заводит списки и дополнительные поля, подписывает и исключает контакты, собирает письма из шаблонов и готовит кампании. Массовую отправку он не запускает сам: сначала тестовая отправка на проверку, затем ваше подтверждение с названным списком и числом адресатов — и только потом старт кампании. Транзакционные письма и SMS уходят тем же порядком, а результат агент перечитывает после отправки.

Ключ один на аккаунт и не делится по разделам, поэтому агент видит весь кабинет — узкий доступ здесь выдать нельзя, а отзывается он только перевыпуском ключа. Уходит ключ параметром каждого запроса, так что перевыпуск обрывает доступ мгновенно, и агент скажет об этом, а не вернёт молча ноль. Контакты и статистику Unisender отдаёт порциями, и длинную выборку агент дочитывает до конца сам. Частоту он держит в пределах десяти запросов в секунду, а при нехватке данных или прав говорит об этом прямо.