API Sendsay позволяет осуществить интеграцию вашией системы (CRM, ERP, CMS, SAP) и сервиса рассылок Sendsay.
С помощью API возможен автоматизировнный доступ ко всем функциям Sendsay.
Вся работа с API ведётся только по шифрованным соединениям (https).
Возмонжно использование канала с шифрованием ГОСТ.
Основное API позволяет производить массовые и транзакционные выпуски, управлять всеми имеющимися объектами и настройками, получать статистику.
Доступна клиентская библиотека на языке JavaScript для интеграции с основным API.
Может быть использована как прототип для вашей реализации на других языках.
API | Версия | Дата | Описание |
основное | 0.227 | 2023-09-17 |
НОВОЕ ! Обогащение данных подписчиков
Новые параметры в ответе group.filter.get для оценки сложности фильтра: usage,depth,max_usage
member.sendconfirm параметр unsubsendercancel это 0|1, а не адрес
|
основное | 0.226 | 2023-08-17 |
НОВОЕ ! Рассылки VK Notify
Новое действие send.confirm в триггерах - выслать письмо подтверждения
|
основное | 0.225 | 2023-07-17 |
НОВОЕ ! Подробный лог действий с формами stat.uni formfilling.*
Переработанное описание как транзакционные письма группируются в выпуски
Новый параметр лент новостей - время последнего использования lenta.list/get : issued
Новые параметры sys.setting.get: issue.personal.groupby invite.month.limit invite.month.rest
|
основное | 0.224 | 2023-06-17 |
НОВОЕ ! Получение ответа на письмо рассылки через callback
НОВОЕ ! Указание нескольких групп для внесения/исключения при импорте
НОВОЕ ! Фильтр исключения из последовательности не связанный с группой-фильтром
Возможность самостоятельно указывать защитный интервал от повторов важных вызовов
При удалении формы удаление связанной анкеты
Ответ 406 при передаче callback считается успехом
Уточнение асинхронности для вызовов sequence.member.*
Уточнение асинхронности для вызовов stoplist..*
|
основное | 0.223 | 2023-05-17 |
НОВОЕ ! Тригерное событие "random"
НОВОЕ ! Возможность про импорте в явном указать на какие триггерные последовательни запустить участников импорта, а по каким остановить их прохождение
Група не допуска на триггерную последовательность теперь может быть не только группой-списком, но и группой-фильтром
Возможность при удалении из стоп-листа указать "сразу и из глобального и из всех по отправителю"
|
потоковое | 1.10 | 2024-04-24 |
Поддержка care_vars для защиты от не верных значений данных персонализации
Группировка писем по черновику, если использутся
Общее описание правил группировки
Новая ошибка wrong_too_many_labels
|
основное | 0.222 | 2023-04-17 |
НОВОЕ ! Свойство protected - Защита объектов от непренамеренного изменения/удаления
НОВОЕ ! Для создания чат-ботов - события от Telegram в триггерах
Количество меток выпуска увеличено до 10
Уточнение описания проксирования команд для Telegram
|
основное | 0.221 | 2023-03-17 |
В issue.send описание нового способа выпуска с помощью третьих лиц без разглашения им адресов
Новый параметр импорта member.import: no_member для поддержания нового способа выпуска
В результатах пробного импорта member.import.probe дополнительная полезная информация про колонки - quest.type/subtype/width
Параметры управления перелинковкой ссылок переименованы из x-* в data-*, прежние варианты продолжают работать
Новый справочный параметр "start.winner.at" для вариантов АБ-тестирования
|
основное | 0.220 | 2023-02-17 |
НОВОЕ ! Автоматическая отмена письма с не правильной персонализацией
Параметр care_vars у выпуска и черновика позволяет указать какие переменные персонализации не должны быть пустыми.
Интеграция с Тильдой теперь позволяет работать с формами с любым названием
В трекере импорта теперь доступен изначальный запрос api
|
основное | 0.219 | 2023-01-17 |
НОВОЕ ! Правила выполнения команд Telegram
НОВОЕ ! Проксирование вызовов от Telegram
НОВОЕ ! Inline-клавиатура в сообщениях Telegram
НОВОЕ ! Reply-клавиатура в сообщениях Telegram
НОВОЕ ! Запрос номер телефона в сообщениях Telegram
НОВОЕ ! Запрос гео-положения в сообщениях Telegram
|
потоковое | 1.9 | 2022-12-20 |
Содержимое атача не обязательно кодировать base64 если он текстовый
Параметр ignore_stoplist
Ошибка wrong_letter теперь может выдаваться и сразу при приёме
|
основное | 0.218 | 2022-12-17 |
В события от формы код формы теперь не обязателен, но тогда обязателен источник
Вызов переименования файлов rfs.rename поддерживает до 100 переименований за раз
Вызов удаления файлов rfs.file.delete поддерживает до 100 удалений за раз
Вызов удаления каталогов rfs.dir.delete поддерживает до 100 удалений за раз
Учточнение описания label для Источников
Исправление описания token для Внешней авторизации с типом 0
|
основное | 0.217 | 2022-11-17 |
НОВЫЙ способ получения данных callback/webhook - сохранение в Отчёты
НОВАЯ сущность "Источник" - вызовы origin.*
Формы поддерживают назначение Источника
- параметр origin вызовах form.*
- form.origin.* в Универсальной статистике
- origin.id в callback
- origin.id в тригерных событиях форм
Новый код недоставки sms: -2013 blacklisted
|
основное | 0.216 | 2022-10-17 |
Уточнение описания null для read.duration
Уточнение описания datakey autotedect для Импорта подписчиков
Уточнение, что по умолчанию для высылки результата на почту используется адрес владельца акаунта
Уточнение описание ошибки canno_import
|
основное | 0.215 | 2022-09-17 |
НОВОЕ. Возможность ограничить срок действия логина sys.user.* - not_before/not_after
НОВОЕ. Управление интервалом накопления для навыпусков с накоплением - месяц, неделя, день
- issue.send - accumulate_by
- issue.draft.* - accumulate_by и accumulate
- sys.settings.* - issue.accumulate_by
Новый параметр конфигурации sys.settings.get - issue.limit.join
Новый параметр скрипта отслеживания пути по сайту target.script: keeputm
Уточнение, что content-type для вызоов callback в формате json-stream это application/x-ndjson
|
потоковое | 1.8 | 2022-08-22 |
Уточнение что количество заданий в batch ограничено 1024
Уточнение что jwt-токен отложеных писем должен быть валиден на момент выпуска
|
основное | 0.214 | 2022-08-17 |
Новые данные в Универсальной Статистике: member.confirm.time/host
Новый код недоставки sms: -2012 wrong recepient phone number
Новый параметр member.list: answers
Новый параметр group.filter.get: with_check
|
потоковое | 1.7 | 2022-08-07 |
Новые кода ошибок account_not_activated и account_phone_not_confirmed
Уточнение кода ESMTP для адрес "имеет постоянные ошибки доставки или в стоп-листе"
Уточнение что API отдельно, а HTTP - отдельно
|
основное | 0.213 | 2022-07-17 |
Триггерные события member.change могут предавать информацию об изменении в выпускаемое письмо
Расширенное сравнение данные в триггерном событии member.change
Универсальная статистика - member.(create|update|import)* могут быть null
|
основное | 0.212 | 2022-06-17 |
Возможность импортировать уже имеющиеся контакты Телеграм
В member.set/member.import возможно вносить дату как текущее время со сдвигом
В member.list.count новый параметр with_minmax
|
потоковое | 1.6 | 2022-06-06 |
Новые кода ошибок и учтонённые описания прежних
weak_draft должен находиться в корне вызова
|
основное | 0.211 | 2022-05-17 |
Новые счётчики в статистике импорта: needconfirm, datarows, upserted, uniqs
Новый код завершения прохождения тригера: -9 - с шага не уйти
Новый параметр снимка группы - sequence.event
Новые параметры в трекерах большинтства вызовов работающих со списками подписчиков: records, method, filter, url, query
Новые параметры issue.get: letter, with_archive, with_name
Новый параметр issue.get.attach: letter
Правильное название параметров group.get - create.time и update.time
|
основное | 0.210 | 2022-04-17 |
Возможность не подтверждать адрес отправителя если он совпадает с доменом DKIM выпуска
Новый параметр черновика basegroup.id
Новые параметры выпуска ignore_stoplist, unsub_list, issue_memeber_list
Новый статус недоставки -100023 - адрес в спам-листе
Вызов group.snapshot поддерживает параметр addr_type
Единообразное название параметров фильтра и объекта create|update.time для вызовов cron.list, group.list, issue.draft.list, issue.class.list
Исправленное описание параметра weak_draft вызова issue.send
Уточнение какие параметры имеют целочисленный тип в колбеках
|
основное | 0.209 | 2022-03-17 |
Возможность глобально отключить проверку ссылок при выпуске: sys.settings.get параметр issue.link.notest
Устаревшие вызововы stat.activity, stat.issue, stat.group.portrait, stat.group.common будут удалены 01 июля 2022
|
потоковое | 1.5 | 2022-02-18 |
транзакционное api переименовано в потоковое api с сохранением совместимости
|
транзакционное | 1.5 | 2022-02-18 |
Длина uuid до 240 символов
|
основное | 0.208 | 2022-02-17 |
Удаление саблогина имеющего api-ключ не возможно без предварительного удаления api-ключа
Новые параметры Универсальной Статистики для выпуск issue.*_rate - заранее расчитанные стандартные статистические показатели
Новый способ указания обработки ошибок персональный атачей - "!?" - не ошибка если урл пустой
Триггеры / Событийные действия
- Новое свойство триггера "тип адресов" - addr_type
- Новое способ работы действия member.update - через datakey
Callback/Webhook
- для form новая причина вызова - "Подтверждение формы" - event.type = confirm
- для draft добавлены variables - используемые в черновике переменные
- для read добавлен duration - длительность чтения
- для read и clik добавлены geo.id и geo.name - код и название географии
- для issue добавлено dkim.id
- для track добавлено track.id в более удобном месте
- учтонены статусы null для многих полей
Исправлено описание issue.draft.get - variables возвращается в корне ответа
Явно описан формат чисел с плавающей точкой
Уточнено использование в Экспресс-Выпуске параметров issue_exclude и include_filter
|
основное | 0.207 | 2022-01-17 |
Возможность указать предпочитаемый час по умолчанию при выпуске в наилучшее время
Возможность указать предпочитаемый час по умолчанию при выпуске с учётом поясного времени
Новый фильтра списка в sequence.list
Возможность получить фильтр группы с развёрнутыми условиями in_group: group.filter.get - expand
Новые статусы доставки -100020, -100021, -100022
Возможность шаблонизировать урл для callback - SS_EVENT_TYPE
|
основное | 0.206 | 2021-12-17 |
Триггерные события member.change и memeber.match теперь понимают произвольный фильтр в параметрах was.cond,new.cond, match.cond
Новый тип Внешней Авторизации - telegram
Расширенная информация об ошибке в параметр еrror.info трекера выпуска
Вызов ручного выпуска победителя сплит тестирования теперь возвращает трекер выпуска
Новые объект custid.* - Клиентские метки письма - в Универсальной статистике
Проверка ссылок теперь игнорирует домены apps.apple.com itunes.apple.com play.google.com
Проверка ссылок теперь считает успешными кода ответа 307 и 308
Исправление описания group.filter.get - фильтр возвращатеся в ключе obj
|
формы | 1.02 | 2021-12-10 |
Специальное разъяснение для особо одарённых
|
транзакционное | 1.4 | 2021-11-18 |
Авторизация с помощью JWT
Параметр weak_draft
Заголовок Authorization
Новые ошибки с кодом 6.7.8
|
основное | 0.205 | 2021-11-17 |
Новые параметры при получении фильтра группы group.filter.get: in_group и update.time
Подсчёт количества участников member.list.count: возможность указать фильтра прямо в вызове
Метка отписки unsub.label - произвольный параметр для собственной классификации отписок
Webhook/Callback - новый параметр issue.login
|
основное | 0.204 | 2021-10-17 |
Триггерные последовательности - список исключения - те кто не попадут на последовательность
track.info - передача произвольной информации в трекер для последующего использования
|
основное | 0.203 | 2021-09-17 |
Новый формат json-stream передачи событий для Callback/Webhook
Тригерное событие "Всегда" заменено событием "Иначе"
Уточнено поведение параметра limit.usage.raw для тиражей транзакционных писем
Описаны новые проверки при изменении шагов тригерных событий
|
основное | 0.202 | 2021-08-17 |
НОВОЕ ! Параметр next в вариантах Тригерных Действий позволяет организовать схемы исполнения любой сложности
НОВОЕ ! Параметр выпуска weak_draft для возможности переопределить при выпуске параметры содержимого черновика
НОВОЕ ! Возможно использование фильтра have Универсальной Статистики в фильтрах групп подписчиков.
НОВОЕ ! Вызов "Выслать письмо подтверждения" теперь можно использоватьне и для отправки ссылок самостоятельного удаления из стоп-листа
Новое событие "Всегда" для Триггерных действий
Параметр info Триггерных действий для хранения сопутствущей информации
Параметры issue.split.id/variant/winner в Трекера выпуска рассылки для более полной информации о ней
Параметре issue.weak_draft в Параметрах Системы для управления настройкой "Слабый черновик" для всего черновика
|
основное | 0.201 | 2021-07-17 |
НОВЫЕ триггерные события unsub.all, unsub.sender, unsub.topic
Вместо события member.unsubscribe используйте unsub.all
НОВЫЙ параметр customer.id для стандартизации параметра клиентской идентификации письма
|
транзакционное | 1.3 | 2021-07-01 |
Параметр customer.id для дополнительной идентификации письма
Третья метка дял группировки писем в кампании
Новые кода ошибок и уточнение описания старых
|
основное | 0.200 | 2021-06-17 |
НОВОЕ. Системные настройки (sys.settings.get) limit.ratio и limit.usage.raw для получения значение описывающих текущие лимиты тиражей и адресов и их использование.
НОВОЕ. Вызов изменения данных подписчика без автосоздания (if_exists : must)
НОВОЕ. Импорт подписчитков без автосоздания (if_exists : must)
Новое свойства выпуска issue.feature_fast
Изменить время отложенного выпуска на уже прошедшее время не возможно, используйте "now" для выпуска "сейчас"
Уточнение описания настройки issue.month.limit.excess
|
основное | 0.199 | 2021-05-17 |
НОВОЕ. Системные настройки (sys.settings.get) limit.ratio и limit.usage.raw для получения значение описывающих текущие лимиты тиражей и адресов и их использование.
НОВОЕ. Вызов изменения данных подписчика без автосоздания (if_exists : must)
НОВОЕ. Импорт подписчитков без автосоздания (if_exists : must)
Новое свойства выпуска issue.feature_fast
Изменить время отложенного выпуска на уже прошедшее время не возможно
Уточнение описания настройки issue.month.limit.excess
|
основное | 0.199 | 2021-05-17 |
НОВОЕ ! Рассылки через Telegram
Возможность использовать cron.runonce для тестового/внеочередного импорта YML
Новые свойства выпуска issue.feature_csid и issue.feature_pte
|
основное | 0.198 | 2021-04-17 |
НОВОЕ ! Транзакцинные письма для ВКонтакте: issue.send basegroup.id
issue.dkim.list - возможность использования филтрации
Получить данные подписчика member.get: уточнение поведения параметра missing_too
|
основное | 0.197 | 2021-03-17 |
НОВОЕ ! Аутентификация с помощью JWT
НОВОЕ ! История операций с головами подписчика stat.uni:niptuck
Возможность использовать шифрование ГОСТ
Уточнение что время отложенного выпуска не должно быть в прошлом
|
основное | 0.196 | 2021-02-17 |
БУДУЩЕЕ НЕ СОВМЕСТИМОЕ ИЗМЕНЕНИЕ - Протоколы TLSv1/TLSv1.1 будут отключены 15 апреля 2021 года
Используйте https://test12.sendsay.ru/ для тестирования режима "только TLS 1.2".
Новый параметр Универсальной статистики unsub.reason - текст причины написаный подписчиком при отписке
А/Б-тестировние. Новое состояние -1 варианта тестирования для сигнализации об ошибке при выпуске
Список трекеров для вызова issue.send не возвращает letter->message. Используйте track.get
Добавлено забытое описание параметра about.user.name в получении настроек
|
основное | 0.195 | 2021-01-17 |
НОВОЕ ! Экспресс-Импорт - импортируйте сотни тысяч подписчиков за пару минут
Универсальная Статистика (stat.uni) - новый объект email.*
Вызов sys.use.get - параметр id не обязателен
основное | 0.194 | 2020-12-17 |
Возможность получения бухгалтерских документов
Возможность использовать формат csv для внешних данных выпуска (external_extra)
Описание прав доступа к различным областям Хранилища (rfs.*)
основное | 0.193 | 2020-11-17 |
Параметр выпуска рассылки users.url.remove теперь поддерживает http(s)
Возможность для события чтения письма триггерных последовательностей быть начальным в тригере
Вызов member.send.confirm теперь контролируется по request.id
Возможность ограничить доступность DKIM-настроек выпуска одним саблогином - issue.dkim.create : sublogin
Новые поля доступные через Универсальную Статистику
- draft.* поля настроек черновика
- issue.unsub_list.*
основное | 0.192 | 2020-10-17 |
Фильтрация по черновику в событии чтения письма триггерных последовательностей
issue.split.list/get новые параметры в ответе: winner.at и ariants.at
issue.split.list новые параметры фильтрации и пагинации
member.sendconfirm - возможность указать название создаваемого выпуска через параметр issue_name
основное | 0.191 | 2020-09-17 |
Новое событие триггерных последовательностей - чтение письма
Сallback/Webhook для трекера теперь сообщает и о завершения импорта
Вызов записи файла в хранилище дополнительно возвращает размер и дату изменения файла
основное | 0.190 | 2020-08-17 |
Пуш-выпуски - специальное значение для ссылки actions что бы не дублировать click.url
Скрипт пуш-подписки - возможность указать дополнительные данные подписки не только динамически, но и статически при инициализации
Тригеры - персонализация действия "вызвать урл" любыми данными анкеты
Вызов получения файла из хранилища дополнительно возвращает размер и дату изменения файла
основное | 0.189 | 2020-07-17 |
Расширение фильтрации получателей выпуска
- новый фильтр issue_include_filter
- в фильтрах issue_exclude_filter и issue_include_filter можно указать условие фильтрации непосрественно, а не кодом группы
- фильтры issue_exclude_filter и issue_include_filter можно указать в самом выпуске, а не только в черновике
Новый параметр autodecode в описании колонки данных при импорте по ключам данных
Новый тип трекера sys.message
Актуализировано описание параметра head_attach вызова member.set
основное | 0.188 | 2020-06-17 |
Новые параметры для push-выпусков: actions и require_interaction
Новавя интеграция - GPA - Gmail Promotions tab
Новые разделы category, promo и gift в интеграции с YML
Раздача промо-кодов - не только из стандартного файла - get_promocode("url")
Новый параметр перелинковки ссылок - x-do-link-same
Импорт подписчиков - забытое описание параметра head_attach
Новая (предсказуемая) схема названия файлов-отчётов об ошибках Экспресс-Выпуска
основное | 0.187 | 2020-05-17 |
Возможность удалить реестр по окончании Экспресс-выпуска - users.url.remove
AMP-формы - form.source
Новый callback - изменение черновика
Введён лимит на 100 одновременно ожидающих отложенных выпусков
При выпуске с rss-лентой её источники буду автоматически проверены на свежие новости
Новые ошибки доставки SMS - -2010 и -2011
Добавлено забытое описание полей stat.common.(active_)csids|push|vks|vibers
основное | 0.186 | 2020-04-17 |
Интеграция с календарными событиями
основное | 0.185 | 2020-03-17 |
Интеграция с сервисом EmailOnAcid
Интеграция со смарт-карточками Mail.Ru
Из трекера вызова group.snapshot теперь можно узнать код и название группы в которую делается снимок группы
основное | 0.184 | 2020-02-17 |
А/Б-тестирование теперь по умолчанию выпускается без проверки ссылок
Новый параметр трекера cronid позволяющий понять от какого действия по расписанию работал запрос
Список отложеных выпусков - используйте новый параметр channel для определения куда предназначен выпуск
Универсальная статистки - трекер теперь содержит сам запрос статистики и request.id api-запроса
Выпуск раассылки- описано когда параметр выпуска link не учитывается и берётся из черновика
Подстановка QR-кодов - по умолчанию используется Version = 0 - автоматическая адаптация размера
Вариант A/Б-текстирования - новый параметр state для лучшего понимания состояния
основное | 0.183 | 2020-01-17 |
Улучшенная фильтрация в Универсальной Статистике - фильтр have для условий по результатам функций агрегирования
Новые параметры при загрузки файла в хранилище
- append - пополнение файла, а не его замена
- error_if_exists - не менять файл если он уже существует
Универсальная Статистика - параметр groupby переименован в joinby. Совместимость поддерживается.
основное | 0.182 | 2019-12-17 |
Подстановка QR-кодов в письма - команда [% qr_code() %]
Новые параметры передаваемые в Callback/Webhook: gate.name и gate.uniq
основное | 0.181 | 2019-11-17 |
Новые режимы *.copy внесения/изменения данных в member.set и member.import - копирование значения из другого ключа данных
Новая интеграция - принимайте данные форм из Tilda
Дополнительны шаг поиска DKIM для подписи выпуска - по субдомену
Параметр выпуска tz_best теперь требует включения через Службу Поддержки
основное | 0.180 | 2019-10-17 |
Новый синтаксис фильтра списка с пагинацией и признаком последней страницы для вызова track.list
Расширено определение устройств подписчиков
- браузер Edge (ранее учитывался в составе IE)
- браузер Yandex (ранее учитывался в составе Chrome)
- браузер Outlook
- устройство Proxy - обращение за картинками веб-почты вместо браузера подписчика (ранее учитавалось в составе Robot)
Новые параметра статистики работы импорта подписчиков listadd и counter
Новые свойства группы в Универсальной Статистике *.group.type и *.group.addr_type
Уточнение описания вызовов issue.running.*
основное | 0.179 | 2019-09-17 |
Новый синтаксис фильтров списков с пагинацией и признаком последней страницы для вызовов: cron.list, authext.list, issue.draft.list, issue.class.list, infolett.list, group.list, anketa.list
Новый способ фильтрации "процент аудитории" в фильтрах по ключам данных: percent(XX)
Трекер для member.list: поле filter - фильтр использованный при расчёте
Трекер для member.list.count: statistic - копия результата расчёта, поле filter - фильтр использованый при расчёте
основное | 0.178 | 2019-08-17 |
НОВОЕ ! Раздача промо-кодов
Поддержка стоп-листа по отправителю в ответе вызовов email.get и member.get : with_stoplist = 2
Колбек выпуска теперь приходит дважды - первый раз как-только выпуску назначен номер, второй раз - по окончании формирования выпуска
Универсальная статистика (stat.uni)
- новый объект promocode.
- новые параметры issue.features_*
- новые параметры unsub.sender.id и unsub.sender.id|email
Вызов stoplist.erase теперь асинхронный
Ограничение на колчество одновременно работающих вызовов stoplist.add и stoplist.delete
Вызовы stoplist.add и stoplist.delete теперь асинхронны при использовании list
основное | 0.177 | 2019-07-17 |
НОВОЕ ! Рассылки через ВКонтакте
Новый способ передать данные авторизации - заголовок Authorization:
Новый способ передать номер запроса - заголовок X-Request-ID:
Выпуски СМС переведены на стандартный общий способ органичения скорости доставки tz_limit/tz_observance
Новые параметры create.date и update.date для Тригеров
Уточнение описания stat.uni: issue.wrongline
основное | 0.176 | 2019-06-17 |
НОВОЕ ! Стоп-лист по отправителю
- описание
- поддержка в вызовах stoplist.*
- параметры stoplist.sender.* в вызове stat.uni
- параметр sender.email в событии unsub для Callback/Webhook
Ограничение времени работы вызова member.where
Уточнённое описание представления чисел и дат
основное | 0.175 | 2019-05-17 |
НОВАЯ схема построения урла вызова API
Новый параметр клика (click.source) и чтения (read.source) позволяющий узнать что они от AMP-версии письма
Возможноть получить email (about.user.email) и имя (about.user.name) саблогина текущей сессии
основное | 0.174 | 2019-04-17 |
НОВОЕ ! Поддержка AMP-писем
Ответ 204 принимается тоже как успешный в Callback/Webhook
Через трекер теперь доступен параметр request.id оригинального вызова
Новая причина отписки "По ссылке тематической отписки" (unsub.why = 5)
Уточнено описание вызова issue.get.attach
Уточнено описание параметра caption в stat.uni
основное | 0.173 | 2019-03-17 |
Новые параметры для Сallback/Webhook в события read и click передают описание устройства пользователя - gadget.*
Новые параметры в свойствах ошибки доставки позволяют определить при доставке какого письма ошибка произошла - member.error.(lock).issue|letter
Возможность подключить в выпуск более одного YML-файла - параметр prefix команды шаблонизатора external_extra
Добавка забытого паарметра add_type в group.clean
Уточнение описания http-ответа и запроса api
основное | 0.172 | 2019-02-17 |
НОВОЕ ! Сплит-тестирование теперь для любых каналов
НОВОЕ ! Возможность ограничить длительность попыток доставки письма
Новый вызов sys.rights.list - списков всех прав
основное | 0.171 | 2019-01-17 |
НОВОЕ ! Отдельный тип идентификатора подписчика для Viber
НОВОЕ ! Дата внесения адреса в группу-список
Уточнение что код группы может содержать символ подчёркивания
основное | 0.170 | 2018-12-17 |
НОВОЕ ! Вызов member.merge - объединение данных двух подписчиков
Универсальная статистика (stat.uni)
- новый параметр issue.features
- параметр issue.ispdf будет удалён 01.02.2019. используйте issue.features == 1
Прочитать выпуск (issue.get) - более подробный ответ про атачи при source = 2
основное | 0.169 | 2018-11-17 |
Добавлены ссылки на готовые библиотеки работы с api на python и java-script
Вызов выпуска рассылки issue.send теперь тоже поддердивает параметр letter.zip
Предпросмотр черновика issue.draft.preview теперь позваляет задать всю персонализацию в параметре email {} и поддерживает параметр extra
Новые параметры вызова issue.draft.get: входной - novars, выходной - channel
Уточнено описание deliv.letter.dt в вызове stat.uni
Более детельное описание события tracker
основное | 0.168 | 2018-10-17 |
НОВОЕ! Автоматическая информация о временной зоне подпиcчика (member.get: member.last.tz)
Выпуск рассылки с учётом временной зоны может использовать member.last.tz
Для Сallback/Webhook
- новый параметр api.request.id в событии tracker
- уточнение описания события tracker
- информация о количестве и размере вызовов callback
Универсальная статистика
- новые функци md5_hex() и md5_base64()
- временная зона подписчика member.last.tz
- уточнение описания *.issue.users_slice
основное | 0.167 | 2018-09-17 |
НОВОЕ! Возможность загрузить черновик выпуска из zip-архива - issue.draft.set : letter.zip
НОВОЕ! Вызов issue.send.test - специально для случаев когда сотрудник должен мочь высылать тестовые выпуски, но не моч реальные
Вызов "Проверить адреса"
- возможность сохранить результат в отчёт
- возможность учесть накопленные ошибки доставки delivery.error
- новые поля total и email.id в ответе
Ссылки в с доменом t.me по умолчанию не проверяюся на существование
основное | 0.166 | 2018-08-17 |
Для Сallback/Webhook
- уточнение интервала попыток при неудачных отправках события
- уточнение что у события unsub параметры issue.id/letter.id могут быть null
Новый параметр формирования результат в csv: always_quite
Для сохранённых адресов email-отправителей (issue.emailsender.*) теперь возмоно указать и их имя - параметр label
!!! НЕ СОВМЕСТИМОЕ ИЗМЕНЕНИЕ у функции шаблонизатора: С 17 СЕНТЯБРЯ 2018 ГОДА для работы с RSS-лентами новые названия news()/lenta() => news_get()/lenta_get()
основное | 0.165 | 2018-07-17 |
!!! НЕ СОВМЕСТИМОЕ ИЗМЕНЕНИЕ в выпуске рассылки: С 17 АВГУСТА 2018 ГОДА изменяется значение по умолчанию параметра relink вызова issue.send. Новое значение будет "1" для не sms-выпусков. Таким образом, по умолчанию БУДЕТ производиться учёт перехода по ссылкам.
Выпуск рассылки: возможность задания contact_rate от начала календарного дня contact_rate.interval : XXXd
Сallback/Webhook: расширенная информация о выпуске
Универсальная статистика: новое issue.excludecontactrate - количество адресов отсеянных из выпуска из-за contact_rate
Возможность фильтрации списка групп по типу группы и типу адресов группы
Действия по расписанию
- Новые поля action, create.date, update.date
- Возможность фильтрации списка по action
Черновик выпуска: новый параметр users.url
Прочесть выпуск: новый параметр extra
Отложенные выпуски: новый статус status = now
основное | 0.164 | 2018-06-17 |
Снимок группы group.snapshot: парамерт to.resync для синхронизации участия в обеих группах
Уточнение, что рассчёт contact_rate проводится среди выпусков с тем же классом, а не всего тиража выпусков
track.get: новые параметры в ответе issue.name, group.name
Callback/Webhook: новый передаваемый параметр issue.label
основное | 0.163 | 2018-05-17 |
Callback/Webhook
- Новое событие member.confirm
- Новый параметр в вызовах event.dttz
- Новое параметр в вызовах unsub.comment
Получить черновик - новый параметр в ответе format
Список черновиков - фильтр отбора по format
основное | 0.162 | 2018-04-17 |
Новые поля системной анкеты
- member.dataset - номер набора данных
- member.import.time - дата изменения при импорте
"Прочитать набор данных" - cпециализированный вариант вызова member.get по номеру dataset
основное | 0.161 | 2018-03-17 |
Дополнительная расширенная информация при ошибке repeated_request.id
Отчёты в формате csv сохраняются в utf-8 для новых аккаунтов. Старые могут использовать для этого дополнительный параметр.
Данные для прикрепляемого файла для вызова sys.message должны быть в base64
основное | 0.160 | 2018-02-17 |
Возможность создания самостоятельного пользователя при отсоединении идентификатора (member.head.detach, параметр split)
Предпросмотр черновика не только для email и sms (новый параметр addr_type в issue.draft.preivew)
Новая ошибка доставки -100018
Универсальная статистика
- новый ключ issue.unsub_list.gid
- ключи issue.source вместо issue.smtpd
sys.setting.get: push.script: новые значения в ответе для самостоятельной сборки скрипта
основное | 0.159 (admir) | 2018-01-17 |
НОВОЕ ! Интеграция с Flocktory.com - sys.settings.get: integration.flocktory
НОВОЕ ! Интеграция с amoCRM - member.import и sys.settings.get: integration.flocktory
НОВОЕ ! Интеграция с Bitrix24 - member.import и sys.settings.get: integration.flocktory
НОВОЕ ! Раздел "Интеграция"
member.list: уточнение описания caption
Явное указание что в отчёте не скаляные величины сохраняются как json-строка
основное | 0.158 | 2017-12-17 |
НОВОЕ ! Работа с api с помощью apikey - вызовы sys.user.apikey.*
Webhook/Callback
-Передача события о завершении трекера
-Новый формат вызовов - application/json
Выпуск рассылок
-issue.send:accumulate - объединяет выпуски только в текущем месяце
-Возможность задать глобально tz_observance через sys.settings.set/get
Замена вызвов: user.* на sys.user.*, rights.* на sys.user.rights.*
В вызове sys.user.set старое поведение password+email до 01.02.2018
Улучшеный ответ member.find, но не совместим со старым
Список отложены выпусков issue.later.list - добавлена информация о users.slice, tz_best, tz_limit, tz_observance
Универсальная статистик stat.uni: новые данные о выпуске - issue.istest/sublogin/track.id/cron.id
Уточнение описания system в ответе anketa.get
основное | 0.157 | 2017-11-17 |
Получение данных подписчика member.get: новые параметры with_stoplist, with_heads, missing_too позволяющие получить больше информации за одни вызов
WebPush
- Приветственный пуш для подписавшися. Настройка через sys.settings.*:issue.push.welcome
- Время попыток доставки по умолчанию 12 часов
Доступ с списку черновиков через Универсальную Статистику - stat.uni: draft.*
Выпуск рассылки
- описан араметр x-no-qsid="0|1" для явного отключения/включения добавления к ссылке параметра для отслеживания переходов по ссылкам через сторонние сервисы
- tz_limit действует на personal-sms только если явно задан
Описан лимит одновременных выполнений member.delete и member.update
основное | 0.156 | 2017-10-17 |
Вызов member.set: новая полезная всегда возвращаемая информация в "member"
Передача событий из системы клиенту: новое событие заполнение формы
Новые условия в фильтрах по ключам данных: is empty и!is empty
Универсальная статистика stat.uni:
- доступ к новым свойствам выпуска *.issue.users_slice/multiple/contact_rate/tz_best/tz_limit/tz_observance/smtpd
- уточнение описания полей issue.excludefilter и issue.unsublist
Новый формат изображений предпросмотра в параметре thumbnail -вызовы stat.uni, issue.*, issue.later.*, issue.draft.*
основное | 0.155 | 2017-09-17 |
НОВОЕ ! Учёт длительности чтения письма
Растянутые выпуски - возможность увеличение размера пачки со временем tz.limit: increase
Новый вызов issue.later.set для изменения отложенного выпуска
Перенос отложенного выпуска issue.later.send: теперь можно перенести на хранение hold
Трекинг ошибочных действий по расписанию для получения информации о том что была ошибка
Сохранение оригинального вызовав трекере и его получение через track.get: api.request
Для транзакционных писем указание в трекере адреса получателя и ошибки если она случилась track.get: email и error
Универсальная статистика stat.uni: issue.ispdf - признак выпуска с автоконвертацией в PDF
Уточнение порядка событий form_filled в паре с form_completed
Описание ошибок -10001x
Новые параметры sys.settings.get: about.manager.account/sale
основное | 0.154 | 2017-08-17 |
НОВОЕ ! Веб-пуш
НОВОЕ ! Учёт переходов из sms
НОВОЕ ! Высылка сообщений в лучшее время - issue.send: tz_best
НОВОЕ ! Ограничение на частоту контактов с получателем - issue.send: contact_rate
Новое понятие "Класс выпуска" issue.class.* - набор параметров выпуска для упрощения их назначения и изменения, средство классификации выпуска
Клиентские метки выпуска - issue.send/issue.draft.* : label - гибкое средство классификации и отбора выпусков
При растянутом выпуске минимальный batch.number теперь всего 200
Предпросмотр черновика issue.draft.preview - новый формат ответа. Старый поддерживается до 01 октября 2017 года.
Новый тип адреса addr_type = "id" для возможности работы с подписчиками по их системным номерам
Новое поле выборки в списке подписчиков "Список голов" - member.head.list в format.* и member.list
Новый параметр "Формат выпуска" в списке отложеных выпусков - issue.late.list : format
Новое событие в тригерах - "Никогда" - sequence.* : never
Уточнение, что в batch игонорируются параметры аутентификации и не работают вызовы login/logout
основное | 0.153 | 2017-07-17 |
!! С 17 июля 2017 года для member.list вступает в действие ограничение размера выдачи для result=response
Новый вызов email.get - информация об адресе
Новый формат ответа вызова issue.get (старый формат поддерживается)
Webhook/Callback - новый параметр issue.draft.id
Выпуск рассылки
- Viber: правильное название параметра button.label это button.text
- Возможность указать mime-type/charset для не персонализированных атачей
- Ссылки для external_extra/external_anketa можно указать в issue.send->extra, а не в тексте выпуска
- Ссылки со схемой skype:// участвуют в учёте переходов и всегда без проверок на существование
Вызов issue.later.list - новый параметр в ответе: name - название выпуска
Вызов track.get: параметр filter.action - может быть массивом
основное | 0.152 | 2017-06-17 |
!! С 17 июля 2017 года для member.list - ограничение размера выдачи для result=response
Новый вызов member.find
Фильтр по ключам данных - новые условия between / !between
Универсальная статистика - условия группировки AND/!AND/OR/!OR на замену прежним вариантам (прежние варианты остаются работоспособными)
Улучшение получения внешних анкетных данных external_anketa - новый параметр dk
Тригерные последовательности
- Удаление пользователя из базы прекращает его прохождение последовательностей
- Новые состояния -7 и -8 прохождения последовательности
основное | 0.151 | 2017-05-17 |
НОВОЕ ! Интеграция c Google Big Data / Google Big Query
- заносите данных о событиях в Google Big Data
- используйте в импорте данные Google Big Query
- используйте в выпуске рассылок данные Google Big Query
Ссылки со схемой viber:// и fb-messenger:// участвуют в учёте переходов и всегда без проверок на существование
Ссылки в с доменом telegram.me по умолчанию не проверяются на существование
основное | 0.150 | 2017-04-17 |
Новый вызов group.filter.match
Работа с данными по sftp
основное | 0.149 | 2017-03-17 |
Черновики issue.draft.* для совпадения по структуре с issue.send:
- поля link.qsid, dkim.id, campaign.id перенесены из letter в obj (совместимость сохранена)
- новые поля в obj: only_unique, group, relink, relink.param, multiple, tz_limit, tz_observance, users.slice ,extra
Передача событий из системы клиенту callback: добавлена передача пользовательских идентификаторов письма letter.custid
Новый вызов email.cleanerror - очистить ошибки доставки
Во всех урлах можно исползьзовать объект authext что бы не засвечивать постоянно данные аутентификации
Подстановка внешних даннных [% external_xxx %] - новые настройки ignore_error, timeout
Выпуск рассылки issue.send: уточнена совместная работа tz_observance и tz_limit
Импорт подписчиков member.import: новый дополнительный отчёт в csv со всеми ошибками
Ключи данных: как экранировать точку в сегменте ключа данных если она значима, а не разделитель сегментов
Исправлен пример вставки штрихкода [% barcode %]
основное | 0.148 | 2017-02-17 |
Фильтры по ключам данных - условия группировки AND/!AND/OR/!OR на замену прежним вариантам (прежние варианты остаются работоспособными)
Универсальная статистика
- stoplist.* - доступ к стоп-листу
- новые поля member.type, member.create|update.time|host
sys.storage.get - новый параметр datakey для выборочного получения данных
Список не проверяемых по умолчанию ссылок дополнен fb.com, а так же вариантами c www для всех числящихся там сайтов
основное | 0.147 | 2017-01-17 |
Фильтры по ключам данных
- большинство условий теперь позволяют сопоставить значения одного ключа данных с другим ключом данных, а не только с константой
- новые условия "has each/any of"
Универсальная статистика - дополнительны параметр addr_type при фильтрации по member.email, так как клиентские идентификаторы (csid) могут посимвольно быть похожы на адреса или телефоны
основное | 0.146 | 2016-12-17 |
Контроль request.id для вызовов issue.send* и member.import*
Передача событий из системы клиенту - события доставки/недоставки
Расширение правил побора DKIM по домену отправителя
Параметр mute вызова issue.send упразнён
основное | 0.145 | 2016-11-17 |
Передача событий из системы клиенту (Callback, WebHook)
Экспресс-Выпуск с накоплением - issue.send: accumulate
В событии sequence member.change можно указывать Ключ Данных
Доступны дополнительные параметры из при использовании YML в выпуске
sys.storage.get - получение записей по шаблону
основное | 0.144 | 2016-10-17 |
Управление альтернативными идентификаторами подписчика
- добавление при member.set - параметр head.attach
- новый вызов "Замена альтернативного идентификатора" - member.head.replace
Расширение использования DKIM при выпуске
- dkim по домену отправителя
- dkim.id = 0
Универсальная статистика
- источник и номер DKIM использованные в выпуске
- новый синтаксис получения значение элемента пользовательской метки - custid(element_name)
основное | 0.143 | 2016-09-17 |
Возможность ведения статистики по ответам получателей на письма рассылок - "Перехват ответов на письма выпуска" и stat.uni: deliv.replyed.*
При импорте в форматах Ключей Данных возможно присоединени-отсоединени альтернативных идентификаторов подписчика
Константы на базе текущего времени в Универсальной Статистике - stat.uni: const.current
Формы: дата создания и изменения
Исправление issue.emailsender.*: параметр называется не email, а name
основное | 0.142 | 2016-08-17 |
НОВОЕ ! Полная поддержка национальны доменов и имён получателей на национальных алфавитах.
Такие адреса могут использовать "как-есть", например
проверка@тест.рф
企业@企业.企业
без всяких ухищрений типа xn--кодирования.
НОВОЕ ! API-форм для полного управления формами на стороне клиента
НОВОЕ ! Мультиканальные триггеры - с шага триггера можно выслать не только email, но и sms и viber
Универсальная статистика - issue.archive бессмысленен для personal и теперь возвращает null
основное | 0.141 | 2016-07-17 |
Переработаный вызов email.test - не только проверка, но и внесение в группу-список и блокировка
Ссылки в с доменом odnoklassniki.ru и ok.ru по умолчанию не проверяюся на существование
Описан лимит на размер запроса POST и наличие у доменного имени нескольких ip-адресов
Учточнение бесполезности параметра name вызова issue.send при Транзакционных Письмах
основное | 0.140 | 2016-06-17 |
НОВОЕ ! Приостановка/возобновление формирующихся выпусков рассылки
- Вызовы issue.running.*
- Парамер issue.paused для sys.settings.*
- Новое состояние трекера -7 - "Приостановлено"
Целевые странцы - новый варант скрипта и внесение данные в подписчика - target.script: js и datakey
Новые форматы сжатия для отчётов - gzip и bzip2
Формы - Настройка only_once - "Заполняется один раз"
member.where: новый параметр group
rfs.rename: правильное название парамера path, а не path.from
основное | 0.139 | 2016-05-17 |
НОВОЕ ! Выпуски через Viber
НОВОЕ ! Выпуск рассылки - выпуск только части тиража (users.slice)
Выпуск рассылки - параметр "Название выпуска"
Универсальная статистика - тема выпуска теперь в issue.subject, а issue.name - название выпуска
Универсальная статистика - deliv.letter.start_dt - запланированная дата доставки письма растянутого тиража
Возможность кастомизация ссылки или имени файла отчёта случайным числом - метка {RND}
Событие "Целевая страница достигнута" для тригерных действий
Новые настройки DMARC mail.ru не позволяют больше использовать их адреса как адрес отправителя выпуска
основное | 0.138 | 2016-04-17 |
НОВОЕ ! csid - клиентский идетификатор подписчика
НОВОЕ ! stat.uni: order при использовании join
Параметры reltype/relref для форм
Вызовы sequence.member.start/pause/resume/stop - теперь асинхронны
Ссылки в с доменом linked.in по умолчанию не проверяюся на существование
member.exists выдаёт null для синтаксически неверного идентификатора
stat.uni: уточнение описания groupby
issue.send: уточнение описания tz_observance
основное | 0.137 | 2016-03-17 |
НОВОЕ ! Мультиканальные выпуски
- issue.send.multi
- issue.multi.*
- stat.uni::issue.multi.*
- issue.get:multi,channel
НОВОЕ ! Выпуск с учётом временной зоны
- issue.send: tz_observance
- sys.settings.get: tz.delta
Улучшение форм
- form.source: получение версии формы для письма - параметр channel
- Отслеживание письма из которого заполнено - stat.uni: member.form.issue.* member.form.letter.* form.issue.* form.letter.*
- Доступ как ответам через Универсальную Статистику - stat.uni: member.form.*
Автоматическая генерация текстовой версии рассылки - параметр autotext в issue.send и issue.draft.preview
Последовательности - новый вариант срабатывания события member.change - вариант "просто изменились данные"
Список подпиcчиков: быстрая сортировка по member.create.time и member.update.time
Параметры reltype/relref для track.*
Параметр вызова jsonp отменён
основное | 0.136 | 2016-02-17 |
Сохранение отчётов теперь доступно в формате json
Универсальная статистика - *.member.geo.* и *.member.geo.gender.* могут быть null
Группы - новые поля create.time, update.time, reltype, relref
issue.get - новое поле draft.alias
основное | 0.135 | 2016-01-17 |
Черновики выпуска
- Тематическая отписка - unsub_list
- Список участвоваших в выпуске - issue_member_list
- Фильтр исключения из выпуска - issue_exclude_filter
- Список используемых переменных персонализации - variables
- Альтернативный буквенный идентификатор - alias
Универсальная статистика - выборка константы через сonst()
Отложенные выпуски - новое поле track.id что бы простым образом узнать номер трекера выпуска
Выпуск рассылок: ссылки на домен vkontakte.ru тоже по умолчанию без проверки
основное | 0.134 | 2015-12-17 |
Сохранение отчётов теперь доступно в формате html
Черновики выпусков: новые поля - dkim.id, reltype и relref
Универсальная статистика: новые параметры для выпуска - issue.to/from/reply_email/name
Тригеры: в cобытии time.happened формат времени изменён на "YYYY-MM-DD hh:mm"
Новый вызов member.exists - проверка сущестовования подписчика
Выпуск рассылок: уточнение, что имена прикрепляемых файлов начинающиеся с _ зарезервированы
Тригеры: уточнение описания работы события "Изменения данных"
Выпуск рассылок: ссылки на домены rutube.com и youtube.com тоже по умолчанию без проверки
основное | 0.133 | 2015-11-17 |
Статус 6 у track.get - "антиспам проверка"
Возможность при импорте прибавлять или вычитать значение столбца
основное | 0.132 | 2015-10-17 |
Мультиканальность. Присоеднение/Отсоединение идентификаторов при импорте
Возможность кодирования в base64 при указании данных импорта прямо в вызове
Отменены "права доступа" к архиву выпуска" так как все ссылки на него и так индивидуальны
основное | 0.131 | 2015-09-17 |
Мультиканальность - один подписчик - несколько идентификаторов
- новые вызовы member.head.*
- поддержка в member.* и issue.send
- улучшен member.delete
При подготовке данных для импорта для вопросов с выбором можно теперь указать название вопроса вместо его кода
Часть доменов по умолчанию не проверяется при проверке существования ссылок (issue.send)
Возвращаемые значения
- новые параметры compress и separator
- срок хранения отчётов - 90 дней
основное | 0.130 | 2015-08-17 |
Новая схема сохранения результатов статистики - возможность загрузить на http/ftp, получить по почте, получить уведомление по sms
Возможность заново потребовать подтверждения регистрации адреса - member.set или member.update с установкой member.lockconfirm в "1"
Доступна дата изменения статуса доставки sms - stat.uni: deliv.letter.dt
Дата создания и последнего изменения объектов - create.time и update.time в вызовах *.list и *.get для issue.draft, issue.dkim, issue.smssender, issue.emailsender, webpage, sys.storage
Возможность получить атач выпуска в base64 - issue.get.attach: encoding
основное | 0.129 | 2015-07-17 |
Установка своего DKIM-ключа по умолчанию. sys.settings.*: issue.dkim.id
Указание DKIM-ключа для конкретного выпуска. issue.send: dkim.id
основное | 0.128 | 2015-06-17 |
Улучшение Целевых страниц - внесение в группу-список, внесение любого адреса
Расширение Универсальной статистики - group.stat.* - статистика группы по её рассылкам
Новые вызовы для настройки DKIM - issue.dkim.*
Новый вызов переименования файла в хранилище - rfs.rename
Новый параметр notify при работе с Формами form.set/get
Новые состояния трекера -5 и-6
Новые системные настройки issue.email.moderation, issue.sms.moderation
Импорт подписчиков: параметр newbie.letter.confirm больше не поддерживается
Список доступных хранилищ - rfs.list с параметром domain=""
основное | 0.127 | 2015-05-17 |
Новый урл вызова и набор протоколов шифрования
member.get возвращает member.haslock для согласованности с stat.uni
stat.uni: новый объект sequence.* для замены отдельных вызовов sequence.stat и sequnce.member.list
Устарели и будут удалены 01.09.2015 вызовы sequence.stat и sequnce.member.list
основное | 0.126 | 2015-04-17 |
Клиентские метки(данные) для каждого письма рассылки deliv.letter.custid.*
Выпуск рассылки с исключением по одной или нескольким группам-спискам
Расширенная кастомизация ссылок датой - шаблон {DT}
Возможность указание количества и интервала попыток получения данных по ссылке
Включение выпуска рассылки сразу в несколько кампаний - campaign.id может быть массивом
Уточнение как сравниваются данные типа дата-время в АВО-фильтре
Универсальная статистика: поля letter и letter_dt переменованы и теперь доступны в других объектах
Новая причина отписки - 4 - по кнопке "Отписаться"
При использовании кэша в режиме refresh подсказка "cache" так же возвращается
основное | 0.125 | 2015-03-17 |
C 15 мая 2015 года новый урл вызова и набор протоколов шифрования
Интеграция с Яндекс.Маркет - используйте в персонализации писем данные о товарах
Поддержка клиентского уникального идентификатора подписчика - сustomerid:
Выпуск рассылки - возможность указать желаемый mime-type и charset для прикрепляемого файла
Точная дата-время транзакционного письма - stat.uni: deliv.letter_dt
Модерация адреса отправителя писем - issue.emailsender.* и sys.settings.get: issue.email.sender.moderation, issue.sms.sender.moderation
Кэш гео-данных для выпуска и кампании - stat.uni: issue.stat.geo.*, campaign.stat.geo.*
Статус доставки -4 - "отменено"
Хранение "прочих данных" - sys.storage.*
основное | 0.124 | 2015-02-17 |
Получение данных для импорта и выпуска рассылки через SOAP
Интеграция c Siebel
Универсальная статистика
- конвертация результата через map/map.missing
- большой набор статистики для кампаний campaign.stat.*
- определение был ли выпуск рассылки связан с формой *.issue.form.*
Список отложенных выпусков - фильтр по черновику
Отслеживание действий
- параметр economed в результатах member.import
- поддержка вызова member/activate
Получение настроек
- issue.month.*
- member.hard.rest
- часть настроек теперь не выдаётся по умолчанию
В выпусках personal проверка ссылок теперь не производится по умолчанию.
Её необходимость для personal надо задавать явно.
основное | 0.123 | 2015-01-17 |
Выпуск рассылки issue.send
- расширено описание уникального идентификатора каждого письма
- параметр users.list может быть в base64
- минимальный batch.size для email - 2000
- отложеный выпуск той же рассылки (кроме masssending и personal) на тоже время теперь ошибка
- атрибуты x-do-link-relink и x-do-link-test тегов A и IMG для индивидуального управления перелинковкой и проверкой ссылок
Список отложенных выпусков issue.later.list
- sendwhen не выдаётся - есть status
- старые параметры больше не выдаются
Получить отложенный выпуск issue.later.get
- выдача оригинального api-запроса вместо его некой "очень похожей" версии;
- старые параметры больше не выдаются
Высылка приглашений member.sendconfirm при использовании group, group.filter, url или stat.uni
оформляется выпуском рассылки personal и возвращается его issue.id - можно отследить статистику
основное | 0.122 | 2014-12-17 |
Новый функцинал - Трекинг каждого Транзакционного Письма
- issue.send - параметры ответа track.id и letter
- stat.uni - параметр letter для read,link,deliv,unsub
Новый раздел Хранилища Файлов "Загрузки" для приватных данных рассылок и импорта
Метод доступа rfs:// для указания файлов из "Загрузок" при рассылке и импорте
Действия по расписанию - ограничение общего количества выполнений - totalrate/totalruns
Универсальная статистика - ip-адрес открытия письма - read.ip
Новый статус доставки sms -2009
основное | 0.121 | 2014-11-17 |
Новый функционал "Персональные прикрепляемые файлы"
Новый функционал ftp доступ к хранилищу файлов и отчётов
Новые настройки sys.settings.get
- dt.now - текущее время системы
- spec_att.* - доступность специальных приложений
основное | 0.120 | 2014-10-17 |
Новый функционал "Рекламные кампании"
- вызовы campaign.*
- поддержка в вызовах stat.uni, issue.send, issue.draft.*, infolett.*
Новый функционал "Персонализированные PDF-документы"
Новый функционал "Персонализированные Excel-документы"
Новый функционал "Вставка штрих-кодов"
Новая глава "Персонализация выпусков"
Новый функционал "метки в условиях" для фильтров групп по ключам-данных
Улучшена работа с хранилищем файлов
- rfs.list - параметр type
- rfs.list - параметры date и url для каталогов тоже
- rfs.dir.delete - работает и в домене report тоже
Улучшеные отчёты через member.list
- формат вывода можно указать на ходу прямо в вызове
- формат вывода поддерживает ключи данных
- расширен параметр caption - свои названия для каждой колонки
Вызов lenta.* работает теперь и с инфописьмами и с шаблонами оформления
В объекте Действие по расписанию появились параметры reltype/relref
Вызов datarow.list теперь возвращает и ga.bind
основное | 0.119 | 2014-09-17 |
Новый формат данных для вызовов issue.draft.* / infolett.* - расширение возможностей и совместимость с issue.send. Старый формат продолжает поддерживаться.
Функции агрегации в фильтрах на основе Ключей Данных - min, max, sum, avg
Новые поля в Универсальной статистике
- issue.draft.name - название черновика
- read/click/deliv.member.geo.* - информация о географии
- read/click/deliv.member.gadget.* - информация об устройстве
Уточнения описания
- Фильтр групп при указании не существующего КД условике in не совпадёт ни когда
- Автоматическая загрузка рядов данных привязанных к GA должна производиться через cron
- Идентификатор отслеживания выпуска не выдаётся для рассылок personal
- Уточнение правил выпуска с черновиком нового формата
|
основное | 0.118 | 2014-08-17 |
Новый функционал "Ключи Данных" - способ хранения и использования данных любой сложности
Условие ИЛИ и скобки в stat.uni
issue.send: personal можно выпускать для телефонов указывая его номер в email
Ссылки могут быть кастомизированные датой
member.list поддерживает group.filter - фильтр задаваемый прямо в запросе
Уточнение описания stoplist.add/delete
stat.activity: правильное название параметра не "to" а "upto"
Действия по расписанию
- новые параметры dt.from и dt.upto
- правильное название параметра lastrun, а lastran
- уточнение что действие запускается от имени sublogin
|
основное | 0.117 | 2014-07-17 |
Новый функционал "Действия по расписанию" - вызовы cron.*
Выпуск рассылки: содержимое прикрепляемого файла можно передать в base64
Поддержка вызова с JSONP
|
основное | 0.116 | 2014-06-17 |
Новый функционал "Формы опросов"
- реализуется через вызовы form.*
- вспомогательны объекты "Шаблоны веб-страниц" webpage.*
- новые события тригеров form.filled и form.completed
- статистка доступна через stat.uni: form.*
- набор свойств form у вопроса анкеты для поддержки трансляции данных
- вызов decor.siteform удалён как устаревший
Уточнение формата даты для datarow.load
Новый параметре attach вызова sys.message
Вызов sequence.member.membership: правильное название параметра с адресом это email
Забытое описание вызова link.delete
Расширенные кода недоставки
- сбор по умолчанию отключён
- доступны через stat.uni deliv_elim
- изменены номера статусов -1x на -10001x
|
основное | 0.115 | 2014-05-17 |
Логические операции с группами (объединиие, пересечение и прочие) и получение группы-списка из группы-фильтра с помощью вызовов group.snapshot и group.clean
Расширенные кода недоставки -1x
Список адресов из разового фильтра с помошью group.filter для member.update/delete/sendconfirm и stoplist.add/delete
|
основное | 0.114 | 2014-04-17 |
Определение географии и устройства подписчика
Ряды данных - сбор данных о конверсии. Как напрямую от вас, так и импорт из Google Analitics
Несколько запросов за один вызов
sequence.member.start теперь игнорирует закрытость последовательности. полезно при тестировании
target.script - новые параметры noqs и url
authext - вспомогательный объект для рядов данных
|
основное | 0.113 | 2014-03-17 |
Целевые страницы. Проследите путь подписчика по сайту после перехода из письма !
Для удаления блокировки из-за ошибок доставки следует использовать member.set или member.update явно указывая установку поля member.error в "0"
Новое состояние трекера запросов: -4 - отложенное на будущее действие
Выпуск транзакционной рассылки с указанием получателя в параметре email сразу закончится с ошибкой, если адрес синтаксически не верен или не возможен для рассылки (отписан, в стоп-листе, ошибки доставки)
Адрес отправителя обязателен в черновике или информационном письме для использования их в других вызовах
Пользовательские метки объектов. Первые кто поддреживает link и linkgroup (+ соответствующие изменения в stat.uni,link.*, link.group.*)
sys.settings.get - возможность задания параметров для настроек
|
основное | 0.112 | 2014-02-17 |
Внешние данные для персонализации (external_anketa(),external_extra()) позволяют творить чудеса (раздача личных кодов скидок малая их часть)
Выпуск рассылки issue.send:
- новый параметр reply.name - имя для обратного адреса для ответа
- from.email - теперь обязателен для email
- from.name - теперь обязателен для sms
Универсальная статистика
- member.error.* - информация об ошибках доставки адреса
- stat.common.* - общая статистика по дням
- dt:CW1D - модификатор получения первого дня недели
- dt:DOW - модификатор получения номера дня недели
- dt:DOY - модификатор получения номера дня в году
- dt:WOY - модификатор получения номера недели в году
- unsub.dt - описано забытое ранее поле
Для member.update/delete/sendconfirm и stoplist.add/delete источником адресов может служить Универсальная статистика
Удаление нескольких черновиков за раз в issue.draft.delete
|
основное | 0.111 | 2013-12-17 |
Специальный вызов для отправки пожеланий Деду Морозу sys.dedmoroz
Универсальная статистка stat.uni
- issue.hourly.* - Кэш быстрого получения значений параметров выпуска (клики,чтения,отписки) с группировкой по каждому часу
- issue.daily.* - Кэш быстрого получения значений параметров выпуска (доставки,клики,чтения,отписки) с группировкой по каждому дню для каждого домена
- deliv.oper/size/cost - Детальная статистика каждого получателя sms-рассылки - оператор, количество sms, цена за эти sms
- issue.double, issue.wrongline, issue.onlyunique - полезная инфомация о статистике Экспресс-выпуска
- deliv.result - Исход доставки. Вспомогательное значение для облегчения некоторых выборок
- вычитание day из current округляет время до 0:0:0
- указание round позволяет округлить часы и минуты
- при использовании join можно указать groupby равным 0 - это тоже имеет смысл
- забытое описание member.haslock = 4
Общая статистика группы stat.group.common - новая информация об операторах
Учточнение правил экранирования для списков в CSV
Список зарезервированных имён для приложений к письмам
Тест ленты lenta.send ещё удобнее с параметром decor
|
основное | 0.110 | 2013-10-30 |
Выпуск рассылки issue.send
- новый параметр to.name - имя отправителя
- новый параметр reply.email - обратный адрес для ответа
- поддержка выпуска с растягиванием по времени для email - tz_limit
- параметры отвечающие за содержимое выпуска перенесены в letter (совместимость сохранена)
- параметр grp переименован в group (совместимость сохранена)
- уточнение значений по умолчанию для relink.param
Вызовы issue.later.list/get - расширение и совместимость с issue.send
Результат issue.later.get теперь можно использовать для issue.send
Поддержка to.name и reply.email в issue.split.variant.create/set/get, infolett.set/get. issue.draft.set/get
Новая тарификация sms
- новое значение в stat.issue - sms.cost
- новая переменная в stat.uni - issue.cost
- значения sys.settings.get(sms.byed,sms.used) теперь в копейках
|
основное | 0.109 | 2013-10-17 |
Новые вызовы stoplist.add и stoplist.delete с поддержкой трекинга и большими возможностями для замены вызова stoplist.set
Новый вызов member.where - список групп фильтров в которых состоит адрес
Универсальная статистика stat.uni
- объединение результатов нескольких запросов в один - join
- новый параметр caption для красивого оформления результатов
- новые переменные issue.access.* - получения прав доступа к выпуску
- исправление описание переменной unsub.why - 1 и 2 были перепутаны местами
Работа с файловым хранилищем rfs.file.put/get
- новый параметр encoding для указания что данные не двоичные, а base64
- замечание о кодировке двоичных данных для rfs.file.get/put
anketa.quest.delete - возможность удалить несколько вопросов за раз
anketa.create - теперь всегда возвращает id новой анкеты
Уточнение что wget() пока понимает только константы
|
основное | 0.108 | 2013-09-20 |
Новые возможности динамического контента из RSS и социальных сетей - lenta.*
Выпуск sms c ограничением частоты, времени дня и учётом временной зоны получателя - параметр tz_limit вызова issue.send
Параметры шаблонизатора общие для всех - параметр extra вызова issue.send
Забытое описание параметра email в issue.draft.preview и infolett.preview
Окончание совместимости со старым способом возврата ошибок
Окончание совместимости со старым способом указания уведомлений
|
основное | 0.107 | 2013-08-01 |
Получение анкетных данных из Универсальной статистки через member.anketa.*
Новые переменные в Универсальной статистике
- issue.archive - адрес архива выпуска
- issue.thumbnail_* - адреса изображений предпросмотра выпуска
- issue.hardbounce, issue.stoplist, issue.lockunsub, issue.lockconfirm - количество адресов не допущенных в выпуск с разбивкой по причинам
- member.haslock = 4 - информация о новой блокировке адреса - из-за фатальных ошибок доставки
Отчёты со статистикой и об ошибках в результатах отслеживания асинхронного вызовы issue.send при рассылке "Экспресс-Выпуск"
Новые статистические данные в member.list.count: locked.stoplist и locked.hardbounced
Указание списка для member.update/delete/sendconfirm с помощью ссылки
Получение адреса изображений предпросмотра выпуска рассылки в issue.get
track.list - в фильтре по статусу можно указать список статусов, а не только один
issue.get ссылка на архив теперь возвращается в параметре archive вместо url
Отменены ни где не используемые параметры:
- Анкета - member_fill
- Вопрос анкеты - listsubtype, mustselect, onetime, defval
- Параметр subtype - только для вопросов dt
- Параметр width - только для вопросов free
Окончание поддержки старого вызова issue.running "Список выпусков формируемых прямо сейчас"
|
основное | 0.106 | 2013-07-04 |
Модерация имени отправителя sms - вызовы issue.smssender.*
Дополнительный параметр "report_file.json" в результате асинхронного вызова member.import
Новый параметр в ответе member.set - newbie
Новые состояния асинхронного запроса - "Отменено" и "Генерация отчёта"
Новые события тригерных действий - "Регистрация с подтверждением" и "Регистрация без подтверждения"
Новый способ выбора победителя сплит-тестирования - "меньше отписок"
Новое состояние сплит-тестирования - "Победитель выбран"
Новый параметр в свойствах варианта сплит-тестирования - is_winner
Новые настройки sms.used, sms.byed и sms.unlimited в вызове sys.setting.get
Окончание совместимости со старыми параметрами вызовов member.import/member.import.probe/anketa.quest.add/anketa.quest.set
!!! Изменился способ указания высылаемых уведомлений в вызовах member.import, member.set, member.sendconfirm
!!! ПОДРОБНОСТИ В РАЗДЕЛЕ "Общие замечания"
!!! ПЕРЕЙДИТЕ НА НОВЫЙ СПОСОБ ДО 15 СЕНТЯБРЯ 2013 ГОДА
|
основное | 0.105 | 2013-06-07 |
Новая возможность - Отслеживания состояния и хода асинхронных вызовов - track.*
Измененения в вызовах issue.send, member.* и stat.* для поддержки отслеживания
Новое статистическое поле "отписок" в объекте Выпуск (issue) вызова Универсально Статистики stat.uni
Новая настройка about.user в вызове sys.setting.get
Уточнение формата параметров sys.log
Уточнение описания параметра newbie.confirm и названия вызова member.set
Уточнение описания параметра users.list для member.import
Правильное написание параметра clean_group для member.import
!!! ВЫЗОВ issue.running "Список выпусков формируемых прямо сейчас" УСТАРЕЛ.
!!! ИСПОЛЬЗУЙТЕ ЗАМЕНУ "Список асинхронных вызовов"
!!! ПЕРЕЙДИТЕ НА НОВЫЙ СПОСОБ ДО 01 АВГУСТА 2013 ГОДА
|
основное | 0.104 | 2013-05-07 |
Уточнение поведения issue.send c отложеным выпуском
|
основное | 0.103 | 2013-04-29 |
Универсальная статистика stat.uni
- резко повышенное быстродействие при использовании новых полей
- новые статистические поля доставки/кликов/чтений в объекте Выпуск (issue) вызова stat.uni и примеры с их использованием
- новый объект domain - домен подписчика
Новый движок импорта подписчиков. Из видимых изменений:
- у вызовов member.import(.probe) изменился способ возврата ошибок и предупреждений
- новый параметр cleangroup - очистить группу-список перед импортом
- JSON-объект можно использовать как источник данных
Новая настройка "Не высылать на отсутствующие адреса" issue.dontsend.550 в вызовах sys.settings.get/set
Модерация информационных писем и поле onmoderation в вызовах infolett.*
Работа с анкетами
- anketa.quest.add/anketa.quest.set -- описание параметра id в ответе
- anketa.quest.set - изменение нескольких вопросов сразу. новый способ передачи параметров
- anketa.quest.add - создание нескольких вопросов за раз. новый способ передачи параметров
Вызовы rfs.*
- новый параметр url
- уточнение описания
Замечание про тестирование с локальным адресам
Замечание про последовательность обработки
!!! ИЗМЕНИЛСЯ СПОСОБ ВОЗВРАТА ОШИБОК И ПРЕДУПРЕЖДЕНИЙ В ИМПОРТЕ !!!
!!! НОВЫЙ СПОСПОБ ПЕРЕДАЧИ ПАРАМЕТРОВ В anketa.quest.add И anketa.quest.set !!!
!!! ПЕРЕЙДИТЕ НА НОВЫЕ ФОРМАТЫ ДО 15 ИЮНЯ 2013 ГОДА !!!
|
основное | 0.102 | 2013-03-15 |
Новый вызов member.list.count - Количество участников в группе
Список подписчиков member.list: новый параметр member.haslock
Список групп group.list: вставлено забытое описание параметров type и addr_type
Прочитать группу group.get
- новый параметр with_filter
- параметр id позволяет задавать список групп
Универсальная статистика stat.uni
- новый параметр "cache" - подсказки как в итоге использовался кэш
- уточнения про временную зону, 61ю секунда, 23 и 25 часов
- исправление в примерах
кэширование ответов - уточнение описания режима cache : "fetch"
!!! ИЗМЕНИЛСЯ СПОСОБ ВОЗВРАТА ОПИСАНИЯ ОШИБОК !!!
!!! ПЕРЕЙДИТЕ НА НОВУЮ СХЕМУ ДО 15 СЕНТЯБРЯ 2013 ГОДА !!!
|
основное | 0.101 | 2013-01-25 |
система кэширования результатов вызовов
Универсальная статистика stat.uni
- поддержка кэширования и специальный ответ result = "none"
- поддержка вычитания годов и месяцев из текущей даты и полезны к этому примеры
- информация об отписках
- полностью переработаное и расширеное описание всех доступных данных
кэширование условий stat.uni в условиях отбора группы
уточнения описания полей с массивами аресов в sys.settings.*
уточнение описания параметра sort вызова member.list
|
основное | 0.100 | 2012-12-18 |
issue.send: возможность задания данных произвольной сложной структуры для "Экспресс-Выпуска"
новый вызов issue.later.get
новый вызов sys.password.set
новые специальные ответы "Перенаправление" и "Смена пароля"
member.import/member.import.probe: новые поля в ответе rows и queue_position
sys.settings.*: новые параметры redirect.member.join.exists и sec.*
decor,siteform: новый параметр redirect_exists_to
issue.send: возможность указать время отложенного выпуска с точностью до минуты
issue.later.send: возможность указать новое время отложенного выпуска с точностью до минуты
issue.later.list: новое поле draft.id
email.test: новые поля ip и ptr
уточнение описания как работать с сессией авторизации
|
основное | 0.99 | 2012-11-13 |
Описаны лимиты внесения без подтверждения для импорта адресов списком (member.import) и внесения по одному адресу (member.set)
Новый параметр sequence.event в member.import
issue.send: исправлено неверное название параметра draft на верное draft.id
Отслеживание переходов в сплит-тестирования: link.qsid для issue.split.variant.*
Вызовы decor.issue.* (Общее оформление) удалены
issue.later.list - изменения и новые поля в ответе format, group, status.reason, issue.date, status
sys.settings.get - новые значения
- trial, trial.issue.limit, trial.issue.rest
- allow.email, allow.sms
- member.tarif.limit, member.hard.limit,
- member.noconfirm.limit, member.noconfirm.limit
|
основное | 0.98 | 2012-10-02 |
Группы по результатам статистических запросов (group.filter.set/get)
Прочитать выпуск (issue.get):
- параметр draft переименован в draft.id
- новые параметры sequence.id и variant.id
Универсальная статистика (stat.uni)
- новые поля - issue.draft.id, issue.sequence.id, issue.variant.id, member.haslock
- новые операции в фильтре - is_null и !is_not
- сравнение значения поля с текущим временем
|
основное | 0.97 | 2012-09-06 |
Сплит-тестирование / А-B тестирование
|
основное | 0.96 | 2012-08-06 |
Cобытийные действия / Триггерные рассылки
|
основное | 0.95 | 2012-07-23 |
Новый вызов issue.running
Новый параметр format в вызове issue.list
Новые параметры from,upto,group,format в вызове issue.later.list
|
основное | 0.94 | 2012-06-26 |
Транзакционные выпуски.
Описание различия между четырмя способами выпуска.
|
основное | 0.93 | 2012-04-19 |
Добавление поддержки списка email или одного email в вызове member.update
Добавлен параметр addr_type для уточнения типа адреса в вызове member.set.
Вызов issue.draft.set - division стало необязательно.
В вызовах issue.draft.get,issue.draft.set,issue.draft.list для использользования предустановленных черновиков добавлены параметры "template", "template.thumbnail".
Форматирование, уточнения (group.create, issue.draft.get).
|
основное | 0.92 | 2012-02-15 |
Формат данных подписчиков для импортирования и экспресс выпуска изменен.
Добавлен новый формат XLSX.
Предыдущий формат CSV ограничен до стандартной версии (разделитель колонок - запятая, допускается заключение текста ячейки в кавычки).
|
основное | 0.91 | 2012-01-31 |
Во всех запросах использующих параметр "result" добавлен параметр "result.format" для возможности выбора формата XLSX, если "result" равен "save" или "e-mail".
Добавлена поддержка параметра "result" для вызовов stat.issue и stat.uni.
Сам параметр "result" стал необязательным, со значение по умолчанию "response".
|
основное | 0.90 | 2012-01-20 |
Поддержка авторизация с помощью биометрических карт AGSES
|
основное | 0.89 | 2011-11-11 |
Исправления stat.issue (описание, добавлен итог по выпускам и получателям), stat.activity (добавлена возможность сохранения и высылки,обратная сортировка, изменения в описании), stat.uni (добавлены типы статистики deliv_ok deliv_bad deliv_unk и пример их использования в сводной статистике)
|
основное | 0.88 | 2011-10-26 |
Возможность влиять на код группы-списка создваемой при внесении списка подписчиков
|
основное | 0.87 | 2011-10-20 |
Не совместимое изменение работы member.get и member.set с участием в группах-списках.
|
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |