Channel object

Используется в API-запросах, связанных c добавлением и обновлением шаблонов сообщений.

JSON
XML

{
	"sid": "email",
	"fields": {
		"text": "Hello, world!",
		"html": "<html>Hello, world!</html>",
		"subject": "Welcome"
	}
},
{
	"sid": "sms",
	"fields": {
		"sms": "Hello, world!"
	}
},
{
	"sid": "push",
	"fields": {
 		"title": "Welcome",
		"body": "Hello, world!",
		"icon": "https://example.com/images/picture.jpg",
		"click_url": "https://example.com"
	}
}

<channels>
  <sid>email</sid>
  <fields>
    <text>Hello, world!</text>
    <html>&lt;html&gt;Hello, world!&lt;/html&gt;</html>
    <subject>Welcome</subject>
  </fields>
</channels>
<channels>
  <sid>sms</sid>
  <fields>
    <sms>Hello, world!</sms>
  </fields>
</channels>
<channels>
  <sid>push</sid>
  <fields>
      <body>Hello, world!</body>
      <click_url>https://example.com</click_url>
      <icon>https://example.com/images/picture.jpg</icon>
      <title>Welcome</title>
  </fields>
</channels>

Описание

Параметр	Тип	Пример	Описание
sid	string	"email" "sms" "push" "telegram_bot" "telegram_group" "custom_channel" "inapp"	Название канала
fields	object	"fields": { "text": "Hello, world", "html": "Hello, world!", "subject": "Welcome" }	Настройки шаблона для конкретного канала

Fields object

Каждый объект channel содержит объект fields:

Email fields

JSON
XML

{
  "sid": "email",
  "fields": {
    "text": "Текстовая версия письма",
    "html": "<html>HTML версия письма</html>",
    "subject": "Тема письма",
    "from_email": "test@example.com",
    "from_name": "Jenny's List",
    "replyto_email": "test_reply@example.com",
    "replyto_name": "Jenny",
    "is_not_inline": true
  }
}

<xml>
  <sid>email</sid>
  <fields>
    <text>Текстовая версия письма</text>
    <html>&lt;html&gt;HTML версия письма&lt;/html&gt;</html>
    <subject>Тема письма</subject>
    <from_email>test@example.com</from_email>
    <from_name>Jenny&apos;s List</from_name>
    <replyto_email>test_reply@example.com</replyto_email>
    <replyto_name>Jenny</replyto_name>
    <is_not_inline>true</is_not_inline>
  </fields>
</xml>

Описание

Параметр	Тип	Пример	Описание
text	string	"Hello, world!"	Текстовая версия письма
html	string	`"<html>Hello, world!</html>"`	HTML версия письма
is_amp	bool	false	Есть ли в шаблоне amp-версия
amp	string	`"<html>Hello, world!</html>"`	AMP HTML версия письма
subject	string	"Weather alert"	Тема сообщения
from_email	string	"test@example.com"	Перезаписать from-email
from_name	string	"Jenny's List"	Перезаписать from-name
replyto_email	string	"test_reply@example.com"	Перезаписать replyto_email
replyto_name	string	"Jenny"	Перезаписать replyto_name
is_not_inline	bool	true	Не конвертировать CSS в inline

SMS fields

JSON
XML

{
  "sid": "sms",
  "fields": {
    "sms": "Содержание SMS сообщения",
    "sms_max_count": 0,
    "add_sms_url_scheme": true
  }
}

<xml>
  <sid>sms</sid>
  <fields>
    <sms>Содержание SMS сообщения</sms>
    <sms_max_count>0</sms_max_count>
    <add_sms_url_scheme>true</add_sms_url_scheme>
  </fields>
</xml>

Описание

Параметр	Тип	Пример	Описание
sms	string	"Hello, world!"	Текст сообщения
sms_max_count	int	0	Лимит на количество частей SMS
add_sms_url_scheme	bool	true	Добавлять "http://" в ссылки

Push fields

JSON
XML

{
  "sid": "push",
  "fields": {
    "title": "Заголовок push уведомления",
    "body": "Содержание push уведомления",
    "icon": "https://example.com/images/icon.jpg",
    "click_url": "https://example.com",
    "custom_push_json_raw": "{\"order_id\": \"12345\"}",
    "android_settings": {
      "background_color": "#ff3333",
      "vibro": true,
      "soundless": false,
      "banner": "https://example.com/images/banner.jpg",
      "deliver_prior": 1,
      "expir_time": 3600,
      "silent_push": false,
      "custom_json_raw": "{}",
      "click_link": {
        "adaptive": {
          "android_link": "https://example.com",
          "web_link": "https://example.com/web"
        }
      },
      "actions": [
        { "label": "Открыть", "action": { "adaptive": { "android_link": "https://example.com" } } }
      ]
    },
    "ios_settings": {
      "subtitle": "Подзаголовок",
      "soundless": false,
      "media": "https://example.com/images/media.jpg",
      "silent_push": false,
      "expir_time": 3600,
      "custom_json_raw": "{}"
    }
  }
}

<xml>
  <sid>push</sid>
  <fields>
    <title>Заголовок push уведомления</title>
    <body>Содержание push уведомления</body>
    <icon>https://example.com/images/icon.jpg</icon>
    <click_url>https://example.com</click_url>
    <custom_push_json_raw>{"order_id": "12345"}</custom_push_json_raw>
    <android_settings>
      <background_color>#ff3333</background_color>
      <vibro>true</vibro>
      <soundless>false</soundless>
      <banner>https://example.com/images/banner.jpg</banner>
      <deliver_prior>1</deliver_prior>
      <expir_time>3600</expir_time>
      <silent_push>false</silent_push>
      <custom_json_raw>{}</custom_json_raw>
    </android_settings>
    <ios_settings>
      <subtitle>Подзаголовок</subtitle>
      <soundless>false</soundless>
      <media>https://example.com/images/media.jpg</media>
      <silent_push>false</silent_push>
      <expir_time>3600</expir_time>
      <custom_json_raw>{}</custom_json_raw>
    </ios_settings>
  </fields>
</xml>

Описание

Общие параметры, присутствующие у всех push-уведомлений:

Параметр	Тип	Пример	Описание
title	string	"Welcome"	Заголовок сообщения
body	string	"Hello, world!"	Текст сообщения
icon	string	"https://example.com/images/test.jpg"	URL-адрес, по которому расположена иконка для уведомления
click_url	string	"https://example.com"	Ссылка для перехода по клику (обобщённая)
click_url_new	object	`{...}`	Адаптивная ссылка для перехода по клику (см. ниже)
custom_push_json_raw	string	""	Общий Custom JSON (плоская карта ключ–значение), который добавляется к полезной нагрузке всех push-провайдеров. Строка, содержащая JSON-объект; значения могут содержать плейсхолдеры Go-шаблона
is_rich_push	bool	false	Использовать rich-уведомление (расширенный push)

Параметр body обязателен; остальные — опциональные.

Блоки настроек по платформам. В fields можно передать один или несколько блоков настроек конкретного провайдера — уведомление будет доставляться на устройства, чей провайдер совпадает:

Параметр	Тип	Описание
android_settings	object	Настройки push для Android (см. ниже)
ios_settings	object	Настройки push для iOS (см. ниже)
chrome_settings	object	Настройки Web Push для Chrome
opera_settings	object	Настройки Web Push для Opera
yandex_settings	object	Настройки Web Push для браузера Яндекс
samsung_settings	object	Настройки Web Push для Samsung
firefox_settings	object	Настройки Web Push для Firefox
safari_settings	object	Настройки push для Safari
mailru_settings	object	Настройки Web Push для Mail.ru

Все Web-платформы (Chrome, Opera, Yandex, Samsung) используют одинаковую структуру; Firefox и Mail.ru — упрощённую.

Адаптивная ссылка (click_link / click_url_new). Поле ссылки имеет тип push_link и может содержать:

Поле	Тип	Описание
uniq	bool	Генерировать уникальную ссылку
legacy	object	`{ "url": string, "no-track": bool, "confirm-link": bool }` — классическая ссылка
adaptive	object	`{ "web_link": string, "android_link": string, "ios_link": string, "confirm-link": bool }` — разные ссылки для Web, Android и iOS
deep_link	object	`{ "deep_link": string }` — ссылка для прямого открытия в приложении

Настройки Android (android_settings)

Параметр	Тип	Описание
click_link	object	Адаптивная ссылка (тип `push_link`)
background_color	string	Цвет фона баннера в hex-формате, например `#ff3333`
vibro	bool	Вибрация
soundless	bool	Без звука
banner	string	URL большого изображения (баннера) в уведомлении
deliver_prior	int	Приоритет доставки: `0` — обычный, `1` — высокий
expir_time	int	Время жизни уведомления, сек
silent_push	bool	Тихий push (без отображения в уведомлении)
custom_json_raw	string	Custom JSON конкретно для Android (дополняет/переопределяет общий)
actions	array	Кнопки действий: `{ "label": string, "action": push_link }`

Настройки iOS (ios_settings)

Параметр	Тип	Описание
click_link	object	Адаптивная ссылка (тип `push_link`)
subtitle	string	Подзаголовок уведомления
soundless	bool	Без звука
media	string	URL изображения в медиа-уведомлении
silent_push	bool	Тихий push (без отображения в уведомлении)
expir_time	int	Время жизни уведомления, сек
custom_json_raw	string	Custom JSON конкретно для iOS (дополняет/переопределяет общий)
actions	array	Кнопки действий: `{ "label": string, "action": push_link }`

Настройки Web-платформ (chrome_settings / opera_settings / yandex_settings / samsung_settings)

Параметр	Тип	Описание
click_link	object	Адаптивная ссылка (тип `push_link`)
large_image	string	URL большого изображения в уведомлении
actions	array	Кнопки действий: `{ "label": string, "action": push_link }`
expir_time	int	Время жизни уведомления, сек
custom_json_raw	string	Custom JSON для данного браузера (дополняет/переопределяет общий)

Настройки Firefox / Mail.ru (firefox_settings / mailru_settings)

Параметр	Тип	Описание
click_link	object	Адаптивная ссылка (тип `push_link`)
custom_json_raw	string	Custom JSON (дополняет/переопределяет общий)

Настройки Safari (safari_settings)

Параметр	Тип	Описание
click_link	object	Адаптивная ссылка (тип `push_link`)
button_label	string	Текст кнопки в уведомлении

примечание

Safari — единственный провайдер, для которого Custom JSON не поддерживается: общие и платформенные custom_json_raw при отправке на Safari игнорируются.

Custom JSON. Параметр custom_push_json_raw задаёт плоскую карту ключ–значение, которую платформа добавляет в полезную нагрузку уведомления (для Android — объект data FCM, для iOS — кастомные поля APNs, для Web — webpush.data). Блок конкретного провайдера (custom_json_raw внутри <platform>_settings) дополняет общий: при совпадении ключей значение провайдера имеет приоритет. Кроме того, платформа всегда добавляет в полезную нагрузку служебные ключи: ak_uid (идентификатор сообщения), hub_link (ссылки отслеживания открытий/прочтения) и, при наличии кнопок, ak_actions.

Notify fields

JSON
XML

{
  "sid": "notify",
  "fields": {
    "template": {
      "id": 1,
      "name": "message_after_purchase",
      "type": "NOTIFY",
      "status": "NOT_SENT",
      "is_draft": true,
      "edna_account_id": "",
      "notify_service_name": "altcraft_testing",
      "vk_data": {
        "body": "Содержание Notify сообщения",
        "buttons": [],
        "attachments": [],
        "enabled": true,
        "inline_keyboard": false,
        "hide_keyboard": false,
        "reply_enabled": false
      },
      "ok_data": {
        "enabled": true,
        "body": "Содержание Notify сообщения"
      },
      "sms_data": {
        "enabled": true,
        "body": "Содержание Notify сообщения",
        "type": "advert"
      },
      "routes": [
        {
          "route": "vk",
          "deliv_timeout": 86400,
          "read_timeout": 86400
        },
        {
          "route": "ok",
          "deliv_timeout": 86400,
          "read_timeout": 86400
        },
        {
          "route": "sms"
        }
      ]
    },
    "info": {
      "is_obsolete": false,
      "not_found": false
    },
    "params": {
      "name": "{{$.Lead._fname}}",
      "order_number": "{{$.Lead.order_number}}"
    }
  }
}

<xml>
  <sid>notify</sid>
  <fields>
                <info>
                    <is_obsolete>false</is_obsolete>
                    <not_found>false</not_found>
                </info>
                <params>
                    <name>{{$.Lead._fname}}</name>
                    <order_number>{{$.Lead.order_number}}</order_number>
                </params>
                <template>
                    <edna_account_id/>
                    <id>1</id>
                    <is_draft>true</is_draft>
                    <name>message_after_purchase</name>
                    <notify_service_name>altcraft_testing</notify_service_name>
                    <ok_data>
                        <body>Содержание Notify сообщения</body>
                        <enabled>true</enabled>
                    </ok_data>
                    <routes>
                        <deliv_timeout>86400</deliv_timeout>
                        <read_timeout>86400</read_timeout>
                        <route>vk</route>
                    </routes>
                    <routes>
                        <deliv_timeout>86400</deliv_timeout>
                        <read_timeout>86400</read_timeout>
                        <route>ok</route>
                    </routes>
                    <routes>
                        <route>sms</route>
                    </routes>
                    <sms_data>
                        <body>Содержание Notify сообщения</body>
                        <enabled>true</enabled>
                        <type>advert</type>
                    </sms_data>
                    <status>NOT_SENT</status>
                    <type>NOTIFY</type>
                    <vk_data>
                        <attachments/>
                        <body>Содержание Notify сообщения</body>
                        <buttons/>
                        <enabled>true</enabled>
                        <hide_keyboard>false</hide_keyboard>
                        <inline_keyboard>false</inline_keyboard>
                        <reply_enabled>false</reply_enabled>
                    </vk_data>
                </template>
            </fields>
</xml>

Описание

Параметр	Тип	Пример	Описание
name	string	"message_after_purchase"	Название шаблона
type	string	"NOTIFY"	Тип шаблона
status	string	"NOT_SENT"	Статус отправки шаблона
is_draft	boolean	true	Является ли шаблон черновиком
edna_account_id	string	"123456"	ID аккаунта Edna
notify_service_name	string	"altcraft_testing"	Имя сервиса уведомлений
body	string	«Содержание Notify сообщения»	Текст сообщения для VK
buttons	array	[]	Кнопки в сообщении VK
attachments	array	[]	Вложения в сообщении VK
enabled	boolean	true	Включено ли сообщение VK
inline_keyboard	boolean	false	Используется ли инлайн-клавиатура VK
hide_keyboard	boolean	false	Скрыть ли клавиатуру VK после отправки
reply_enabled	boolean	false	Разрешён ли ответ VK пользователю
enabled	boolean	true	Включено ли сообщение в ОК
body	string	«Содержание Notify сообщения»	Текст сообщения для ОК
enabled	boolean	true	Включено ли SMS-сообщение
body	string	«Содержание Notify сообщения»	Текст SMS-сообщения
type	string	"advert"	Тип SMS-сообщения
route	string	"vk"	Канал доставки
deliv_timeout	integer	86400	Таймаут доставки (в секундах)
read_timeout	integer	86400	Таймаут ожидания прочтения (в секундах)
route	string	"ok"	Второй канал доставки
route	string	"sms"	Третий канал доставки
is_obsolete	boolean	false	Устарел ли шаблон
not_found	boolean	false	Был ли шаблон найден

Telegram fields

JSON
XML

{
  "sid": "telegram_bot",
  "fields": {
    "image": {
      "attach": [
        {
          "content": "/9j/bcvb4234hgdffsd45",
          "filekey": "678636591824633380762bee",
          "name": "example.jpg",
          "size": 65101,
          "type": "image_path"
        }
      ]
    },
    "image_caption": "Описание Telegram bot сообщения",
    "markup_style": "HTML"
  }
}

<xml>
  <sid>telegram_bot</sid>
  <fields>
    <image>
      <attach>
          <content>/9j/bcvb4234hgdffsd45</content>
          <filekey>678636591824633380762bee</filekey>
          <name>example.jpg</name>
          <size>65101</size>
          <type>image_path</type>
      </attach>
    </image>
    <image_caption>Описание Telegram bot сообщения</image_caption>
    <markup_style>HTML</markup_style>
  </fields>
</xml>

Описание

Параметр	Тип	Пример	Описание
legacy_button_link	string	"https://example.com"	Ссылка, прикреплённая к кнопке
legacy_button_name	string	"button1"	Название кнопки
markdown_type	string	"HTML"	Тип форматирования текста (HTML/Markdown)
text	string	"example"	Основной текст сообщения
content	string	"/9j/bcvb4234hgdffsd45"	Бинарное содержимое файла (base64)
filekey	string	"678636591824633380762bee"	Уникальный идентификатор файла
name	string	"example.jpg"	Название прикреплённого файла
size	integer	65101	Размер файла в байтах
type	string	"image_path"	Тип вложения (например, путь к файлу)
image_caption	string	«Описание изображения»	Подпись к изображению
audio_caption	string	«Описание аудиофайла»	Подпись к аудиофайлу
video_caption	string	«Описание видеофайла»	Подпись к видеофайлу
markup_style	string	"HTML"	Стиль разметки для Telegram (HTML/Markdown)

Whatsapp fields

JSON
XML

{
  "id": 9,
  "sid": "whatsapp",
  "fields": {
    "type": "TEMPLATE",
    "template": {
      "type": "360DIALOG",
      "name": "initiate_message_ru",
      "hsm_external_id": "c466caf6_c340_4d85_8659_6c9685618a9f_ru_initiate_message_ru",
      "language": "ru",
      "wa_account_id": "+79999999999",
      "hsm_hash_sum": "0b7ac0a91b0ba52e961b87c2297d2bd06a3f5bc1",
      "is_invalid": false,
      "hsm_not_found": false,
      "account_not_found": false
    },
    "raw_hsm": {
      "dialog_template": {
        "components": [
          {
            "type": "BODY",
            "text": "Здравствуйте! Благодарю за ожидание, мне понадобилось немного времени, чтобы уточнить информацию по вашему запросу. Подскажите, когда Вам будет удобно обсудить детали? 😃"
          }
        ],
        "name": "initiate_message_ru",
        "namespace": "c466caf6_c340_4d85_8659_6c9685618a9f",
        "category": "ISSUE_RESOLUTION",
        "language": "ru",
        "rejected_reason": "NONE",
        "status": "approved"
      },
      "edna_template": null
    }
  }
}

<xml>
  <id>9</id>
  <sid>whatsapp</sid>
  <fields>
    <type>TEMPLATE</type>
    <template>
      <type>360DIALOG</type>
      <name>initiate_message_ru</name>
      <hsm_external_id>c466caf6_c340_4d85_8659_6c9685618a9f_ru_initiate_message_ru</hsm_external_id>
      <language>ru</language>
      <wa_account_id>+79999999999</wa_account_id>
      <hsm_hash_sum>0b7ac0a91b0ba52e961b87c2297d2bd06a3f5bc1</hsm_hash_sum>
      <is_invalid>false</is_invalid>
      <hsm_not_found>false</hsm_not_found>
      <account_not_found>false</account_not_found>
    </template>
    <raw_hsm>
      <dialog_template>
        <components>
          <component>
            <type>BODY</type>
            <text>Здравствуйте! Благодарю за ожидание, мне понадобилось немного времени, чтобы уточнить информацию по вашему запросу. Подскажите, когда Вам будет удобно обсудить детали? 😃</text>
          </component>
        </components>
        <name>initiate_message_ru</name>
        <namespace>c466caf6_c340_4d85_8659_6c9685618a9f</namespace>
        <category>ISSUE_RESOLUTION</category>
        <language>ru</language>
        <rejected_reason>NONE</rejected_reason>
        <status>approved</status>
      </dialog_template>
      <edna_template xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
    </raw_hsm>
  </fields>
</xml>

Описание

Параметр	Тип	Пример	Описание
type	string	"360DIALOG"	Тип шаблона WhatsApp
name	string	"initiate_message_ru"	Название шаблона
hsm_external_id	string	"c466caf6_c340_4d85_8659_6c9685618a9f_ru_initiate_message_ru"	Внешний ID шаблона
language	string	"ru"	Язык шаблона
wa_account_id	string	"+79999999999"	ID WhatsApp-аккаунта
hsm_hash_sum	string	"0b7ac0a91b0ba52e961b87c2297d2bd06a3f5bc1"	хеш шаблона
is_invalid	boolean	false	Является ли шаблон некорректным
hsm_not_found	boolean	false	Найден ли HSM шаблон
account_not_found	boolean	false	Найден ли аккаунт
name	string	"initiate_message_ru"	Название шаблона в raw_hsm
namespace	string	"c466caf6_c340_4d85_8659_6c9685618a9f"	Namespace шаблона
category	string	"ISSUE_RESOLUTION"	Категория шаблона
status	string	"approved"	Статус шаблона (например, approved, rejected)
rejected_reason	string	"NONE"	Причина отклонения шаблона (если есть)
components.type	string	"BODY"	Тип компонента шаблона
components.text	string	«Здравствуйте! Благодарю за ожидание...»	Текст тела сообщения
edna_template	string	"null"	Шаблон Edna, если присутствует (в данном случае — отсутствует)

Viber™ fields

JSON
XML

"id": 10,
{
  "sid": "viber",
  "fields": {
    "series": [
      {
        "type": "TEXT",
        "text": "текст сообщения"
      },
      {
        "type": "IMAGE",
        "image": "/849074172/3/example.jpg"
      },
      {
        "type": "VIDEO",
        "thumbnail": "/848985842/3/678632345824633380762bee/example.jpg",
        "duration": 6,
        "file_size": 2,
        "action": "https://example.com/lib/preview/mp4/example.mp4"
      },
      {
        "type": "TEXT_BUTTON",
        "text": "Пример текста",
        "caption": "текст кнопки",
        "action": "https://example.com"
      },
      {
        "type": "FILE",
        "file_type": "pdf",
        "file_name": "example.pdf",
        "action": "https://www.example.org/testfiles/resources/pdf/example.pdf"
      }
    ]
  }
}

<xml>
  <id>10</id>
  <sid>viber</sid>
  <fields>
    <series>
      <element>
        <type>TEXT</type>
        <text>текст сообщения</text>
      </element>
      <element>
        <type>IMAGE</type>
        <image>/849074172/3/example.jpg</image>
      </element>
      <element>
        <type>VIDEO</type>
        <thumbnail>/848985842/3/678632345824633380762bee/example.jpg</thumbnail>
        <duration>6</duration>
        <file_size>2</file_size>
        <action>https://example.com/lib/preview/mp4/example.mp4</action>
      </element>
      <element>
        <type>TEXT_BUTTON</type>
        <text>Пример текста</text>
        <caption>текст кнопки</caption>
        <action>https://example.com</action>
      </element>
      <element>
        <type>FILE</type>
        <file_type>pdf</file_type>
        <file_name>example.pdf</file_name>
        <action>https://www.example.org/testfiles/resources/pdf/example.pdf</action>
      </element>
    </series>
  </fields>
</xml>

Описание

Параметр	Тип	Пример	Описание
type	string	"TEXT"	Тип элемента в серии сообщения
text	string	«текст сообщения»	Текстовое содержимое сообщения
image	string	"/849074172/3/example.jpg"	Путь к изображению
thumbnail	string	"/848985842/3/678632345824633380762bee/example.jpg"	Превью для видео
duration	integer	6	Длительность видео в секундах
file_size	integer	2	Размер файла в мегабайтах
action	string	"https://example.com/lib/preview/mp4/example.mp4"	Ссылка действия (для видео, кнопки или файла)
caption	string	«текст кнопки»	Подпись для кнопки
file_type	string	"pdf"	Тип файла (например, PDF)
file_name	string	"example.pdf"	Название прикреплённого файла

* Viber™ является товарным знаком Rakuten Group, Inc. Заблокирован на территории РФ.

Описание​

Fields object​

Email fields​

Описание​

SMS fields​

Описание​

Push fields​

Описание​

Notify fields​

Описание​

Telegram fields​

Описание​

Whatsapp fields​

Описание​

Viber™ fields​

Описание​

Описание

Fields object

Email fields

Описание

SMS fields

Описание

Push fields

Описание

Notify fields

Описание

Telegram fields

Описание

Whatsapp fields

Описание

Viber™ fields

Описание