Разбирайте рассылки Sendsay по открытиям и кликам в чате

Агент обращается к Sendsay по единому JSON-адресу https://api.sendsay.ru/general/api/v100/json: имя действия и ключ уходят в теле запроса, отдельных ручек под каждый раздел здесь нет. Через него он читает подписчиков и их поля, группы и сегменты, выпуски и шаблоны, триггерные сценарии и статистику доставок, открытий, кликов, отписок и возвратов, а из этого собирает разбор выпуска и динамику базы за период.

Статистика рассылки не окончательна в момент отправки: доставки, открытия и клики продолжают дописываться часами и днями после выпуска, поэтому агент называет период, за который снял цифры, и не выдаёт свежий выпуск за подведённый итог. Отписки и возвраты он смотрит отдельно от открытий — по ним видно не оформление письма, а состояние базы, и именно они объясняют, почему доставляемость падает от выпуска к выпуску.

На запись агент обновляет карточки подписчиков и состав групп, собирает выпуск из шаблона и готовит A/B-тест. Порядок здесь один: сначала тестовое письмо на проверку, и только по вашему явному подтверждению — отправка на живую базу; сам он рассылку не запускает. Перед отправкой агент называет сегмент, на который уходит выпуск, и число адресов в нём, потому что отозвать ушедшее письмо уже нельзя.

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