Типы заголовков в шаблонных сообщениях
:::tip
Заголовок сообщения является не обязательным параметром
:::
В шаблонных сообщениях допускаются следующие виды заголовков:
- text — Текст, с возможностью подставить одну переменную
- image — Изображение
- video — Видео
- document — Документ
- location — местоположение
:::info
Заголовок передается в теле основного запроса в формате:
:::
"header": {
"type": "image",
"url": "https://kazinfoteh.kz/img/display.png"
}
Заголовок - тип text
Заголовки типа text могут иметь статичный текст (например, Привет) и текст с одной переменной (например, имя абонента), для каждого абонента вы можете подставить свое имя (например, Привет, Алекс)
Допустим вы зарегистировали шаблон с заголовком text и он имеет переменную.
:::highlight orange 💡
Пример вашего зарегистированного шаблона: Привет, {{1}}. Для тебя новость!
:::
Для передачи переменной в шаблон используйте следующий формат:
"header": {
"type": "text",
"param": "Алекс"
}
type
- тип text | обязательный параметрparam
- текст только переменной, не всего текста с шаблона | обязательный параметр
:::danger
Если у вас статический шаблон и в нем нет переменных, а только постоянный текст, например, "Привет", то обьект "header" в обще заполнять и передавать не надо.
:::
Заголовок - тип image
Позволяет передавать изображение в заголовке.
Ваше изображение должно быть размещено на общедоступном ресурсе и соответствовать требованиям.
:::tip
Поддерживаемые форматы WhatsApp Media
:::
Для передачи используйте следующий формат:
"header": {
"type": "image",
"url": "https://kazinfoteh.kz/img/display.png"
}
type
- тип image | обязательный параметрurl
- адрес вашего изображения | обязательный параметр
Заголовок - тип video
Позволяет передавать видео в заголовке.
Ваше видео должно быть размещено на общедоступном ресурсе и соответствовать требованиям.
:::tip
Поддерживаемые форматы WhatsApp Media
:::
Для передачи используйте следующий формат:
"header": {
"type": "video",
"url": "https://kazinfoteh.kz/videoplayback.mp4"
}
type
- тип video | обязательный параметрurl
- адрес вашего видео | обязательный параметр
Заголовок - тип document
Позволяет передавать документ в заголовке.
Ваше документ должно быть размещено на общедоступном ресурсе и соответствовать требованиям.
:::tip
Поддерживаемые форматы WhatsApp Media
:::
Для передачи используйте следующий формат:
"header": {
"type": "document",
"url": "https://kazinfoteh.kz/schet.pdf"
}
type
- тип document | обязательный параметрurl
- адрес вашего документа | обязательный параметр
Заголовок - тип location
Позволяет передавать местоположение (долгота, широта), название и адрес в заголовке.
Для передачи используйте следующий формат:
"header": {
"type": "location",
"latitude": "111.5454522",
"longitude": "-223.112323",
"name": "Моя компания",
"address": "г. Алматы, ул. Абая, 16"
}
type
- тип location | обязательный параметрlatitude
- широта | обязательный параметрlongitude
- долгота | обязательный параметрname
- название на карте | не обязательный параметрaddress
- адрес на карте | не обязательный параметр