Интеграция¶
Для получения данных снаружи и внесения их в систему Sendsay можно использовать импорт данных (вызов member.import) или callback (настройка через sys.settings.get)
Для выгрузки данных из системы Sendsay можно использовать выгрузку данных подписчиков (вызов member.list), массовую выгрузку статистических данных (вызов stat.uni) и информирование внешней системы о событиях в реальном времени через Callback/Webhook (смотрите соответствующий раздел)
Традиционные источники¶
Используйте обычные ссылки (http, https, ftp, ftps, soap, soaps) на внешние данные для вызова member.import для импорта данных и при выпуске рассылки для формирования списка получателей.
Siebel¶
Используйте вызов member.import со схемой soap:// для импорта данных.
Google Big Query¶
Используйте вызов member.import со схемой gbd:// для импорта данных и при выпуске рассылки для формирования списка получателей.
Используйте Callback/Webhook со схемой gbd:// для передачи данных о событиях в Google Big Query.
Flocktory¶
Получите ссылку через параметр integration.flocktory вызова sys.settings.get и указывайте её в настройках Flocktory, чтобы данные передавались в Sendsay в реальном времени.
Tilda¶
Получите ссылку ссылку через параметр integration.tilda вызова sys.settings.get и указывайте её в настройках форм Tilda, чтобы данные передавались в Sendsay в реальном времени.
Можно настроить как все формы Tilda на одну и ту же ссылку, так и индивидуально каждую форму на свою ссылку.
Индивидуальный вариант лучше, так как регистрируемые адреса можно собирать в разные группы-списки и высылать им разные приветственные письма.
Сохранение в ключах данных¶
Дополнительные данные, получаемые от формы, запоминаются в подписчике в ключе данныхtildaforms.названиеформы, где "название формы" это её название в Tilda.
Настоятельно рекомендуется, что бы название состояло только из символов a-zA-Z0-9, "-" и "_" - это позволит без дополнительных действий напрямую использовать такие ключи в персонализации писем.
Названия содержащие прочие символы будут нормализованы - все не буквы (любого языка) и не символы 0-9, "-" и "" будут заменены на символ "".
Например, данные формы с названием "Данные от клиенты" будут сохранены в ключе данных "tildaforms.Данные_от_клиента". Их без проблем можно будет просматривать и использовать в фильтрах, но вместо просто подстановки персонализации[% tildaforms.Данные_от_клиента %]придётся конструировать имя ключа данных в промежуточной переменной языка персонализации ProScipt и работать далее с ним.
Формы без названия записываются в tildaforms.default.
Новое заполнение формы полностью заменяет в данных подписчика старое.
Сохранение и подтверждение заполнения с помощью форм¶
Дополнительные данные, получаемые от формы Tilda, могут быть сохранены в форме Sendsay если её создать с названиемм"tilda_названиеформывтильде",
Форма Tilda без названия сопоставляется форма Sendsay c именем"tilda_default".
Форма Sendsay заполняется данными формы Tilda как если бы происходило обычное заполнение формы Sendsay подписчиком
Ищется соответствие названий полей из формы Tailda ответам формы Sendsay по значению из name или id формы Senday, пробелы в названии Tilda заменяются на подчерки.
Данные, для которых не найдены соответствующие поля в форме Sendsay, записаны не будут.
Форма не записывается, если она определена как не валидная. Например, пришедшие данные в поле типа список содержат отсутствующее значение.
При этом работают стандартные механизмы верификации заполнения формы Sendasay - в форме можно указать необходимость верификации для отправки запроса для подтверждения заполнения подписчиком - таким образом вы получите подтверждения заполнения формы Tilda с помощью Sendsay.
Если подтверждения заполнения в форме Sendsay включено и успешно произошло, то стандартные механизмы форм Sendsay работают дальше и произойдёт трансляция ответов формы Sendsay в данные подписчика, если такая трансляция настроена в форме Sendsay.
amoCRM¶
Используйте вызов member.import со схемой amocrom:// для импорта данных.
Или получите ссылку ссылку через параметр integration.amocrm вызова sys.settings.get и указывайте её в настройках amoCRM, чтобы данные передавались в Sendsay в реальном времени.
Bitrix24¶
Используйте вызов member.import со схемой bitrix24:// для импорта данных.
Или получите ссылку ссылку через параметр integration.bitrix24 вызова sys.settings.get и указывайте её в настройках Bitrix24, чтобы данные передавались в Sendsay в реальном времени.
Яндекс.Маркет¶
Для использования данных о товарах из Яндекс.Маркет (формат YML) для персонализации писем воспользуйтесь интерфейсом. Или обратитесь в Службу поддержки (ask@sendsay.ru) для разовой настройки регулярного автоматического получения данных от вас.
Для тестирования разбора вашего файла или его импорта вне расписания используйте вызов cron.runonce.
Примеры использования описаны ниже в разделе подключения внешних данных.
Mail.Ru Смарт-карточки¶
Для подстановки в письмо кода смарт-карточки Mail.Ru (https://help.mail.ru/developers/jsonld/smartcards/) используйте команду шаблонизатора[% mailru_smartcard(...) %]
Обратите внимание, что в данный момент код валюты подставляется автоматически как RUB.
Значения параметров должны соответствовать требованиям Mail.Ru.
Возможны два способа передачи параметров:
- по значению:
[% mailru_smartcard("type", "Order", "name", "Симулякр", "offer_name", "Заказ", "order", "123-4567890-1234567", "price", "539.00") %]
- готовой структурой:
[% data = { "type" => "Order", "name" => "Симулякр", "offer_name" => "Заказ", "order" => "123-4567890-1234567", "price" => "539.00" } %]
[% mailru_smartcard(data) %]
Далее описаны возможные для генерации смарт-карточки в формате "Название параметра в шаблонизаторе" => Описание параметра [ Генерируемый путь в шаблоне mail.ru ]
Счёт (Invoice)¶
Параметр "type" должен иметь значение "Invoice".
Обязательные параметры:
Дополнительные параметры:
Заказ (Order)¶
Параметр "type" должен иметь значение "Order".
Обязательные параметры:
Дополнительные параметры:
EmailOnAcid¶
Сервис EmailOnAcidhttps://www.emailonacid.com/позволяет посмотреть, как будет выглядеть ваше письмо в разных почтовых клиентах и сервисах.
Вам необходимо создать свою учётную запись в этом сервисе.
Потом разово создать у нас внешнюю аутентификацию с типом 15 - вызовы authext.*
После чего можно использовать вызов предпросмотра issue.draft.preview для получения результатов от EmailOnAcid.
Календарное событие¶
Добавление в письмо события календаря позволяет настроить письмо так, что получатель сможет легко добавить запись о событии в свой календарь.
Для подстановки в письмо события календаря используйте команду шаблонизатора[% calendar_event(...) %]
Данная команда "визуально" ничего не меняет в письме, но добавляет в него необходимые элементы для того, чтобы совместимые почтовые системы распознали событие.
Возможна также подстановка ссылки на Google Calendar с помощью команды[% calendar_event_gc_url(...) %]
Настроятельно рекомендуется указывать ВСЕ перечисленные параметры - без этого отображение события в разных системах и веб-почтах ведёт себя не предсказуемо.
Есть два способа передачи параметров:
- по значению
- готовой структурой
[% ce = { "name" => "Важное событие", "start_date", "2020-01-01 00:00:00", ....... } %]
[% calendar_event(ce) %]
Параметры:
url - Ссылка на что-то связанное с событием (описание на сайте, индивидуальная страница настройки события)
Gmail Promotional Annotations¶
Для подстановки в письмо блока промо-акций Gmail используйте команду шаблонизатора[% gpa(...) %]
Как обычно, параметры можно передать как списком, так и готовой структурой.
Обязательные параметры:
Дополнительные параметры:
Другое¶
Сообщите нам, если вам не хватает какого-либо источника. Мы изучим, как интегрировать это в систему.