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><html>Hello, world!</html></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" | Название канала |
fields | object | "fields": { | Настройки шаблона для конкретного канала |
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><html>HTML версия письма</html></html>
<subject>Тема письма</subject>
<from_email>test@example.com</from_email>
<from_name>Jenny'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": "{}"
}
}
<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>{}</custom_push_json_raw>
</fields>
</xml>
Описание
Параметр | Тип | Пример | Описание |
---|---|---|---|
title | string | "Welcome" | Заголовок сообщения |
body | string | "Hello, world!" | Текст сообщения |
icon | string | "https://example.com/images/test.jpg" | URL-адрес, по которому расположена иконка для уведомления |
click_url | string | "https://example.com" | Ссылка для перехода по клику |
custom_push_json_raw | string | "" | Custom JSON для передачи в мобильный push |