Что такое шаблон сообщения
Шаблоны сообщений в IBA Platform — типы по каналам, ограничения, использование в рассылках и API
Коротко: шаблон — это готовое сообщение, которое можно использовать многократно. Создаётся в разделе «Активы» → «Шаблоны сообщений».
Кому подходит
- Роль: Клиент, Маркетолог
- Уровень: Новичок
Что это
Шаблон сообщения — заранее подготовленное содержимое для отправки получателям. Шаблоны хранятся в разделе Активы → Шаблоны сообщений и используются в рассылках, диалогах, чат-ботах и через API.
Где создаются
В левом меню: Активы → Шаблоны сообщений.
Шаблоны можно создавать не только в личном кабинете, но и через API. Подробнее — в статье Broadcasts API →.
Типы шаблонов по каналам
Что поддерживает: текст.
Ограничения:
- 70 символов (Unicode).
- Поддерживаются сегментированные сообщения.
- Персонализация через атрибуты контакта.
Что поддерживает: ричкарта, карусель, текст, файл.
Ограничения:
- Ричкарта: заголовок до 200 символов, текст до 2000 символов, до 4 действий во внутренней панели и до 11 во внешней.
- Карусель: до 12 карт, на каждой до 10 кнопок.
- Текст: до 2000 символов.
- Файл: pdf, jpeg, png, gif, jpg, mp4, mpeg, webm, h263, m4v, mpeg4, mp3.
Что поддерживает: только текст, файл, текст + кнопка, текст + медиа + кнопка.
Ограничения:
- Только текст: до 1000 символов.
- Файл: до 200 МБ.
- Форматы файлов: изображения (.jpg, .jpeg, .png, .bmp, .gif, .svg, .webp), видео (.mp4), документы (.pdf, .doc, .docx и др.).
Что поддерживает: сообщение (карточка, список, текст, файл, локация) или шаблон.
Ограничения:
- Карточка: заголовок до 20 символов, сообщение до 1024 символов, подпись до 60 символов.
- Список: до 10 вариантов, каждый до 24 символов.
- Текст: до 4096 символов.
- Файл: изображения (JPG, JPEG, PNG, WEBP), аудио (OGG, AMR, 3GP, AAC, MPEG), документы (PDF, DOC, DOCX, PPTX, XLSX), видео (MP4).
- Шаблон: требует предварительного одобрения. Подробнее — Обзор шаблонов WhatsApp →.
Что поддерживает: текст, файл.
Ограничения:
- Только текст: до 2000 символов.
- Файл: изображения (.jpg, .jpeg, .png, .gif), до 10 МБ.
Что поддерживает: HTML, текст, изображения.
Конструктор сообщений:
- Text — текстовый блок.
- Image — изображение.
- Button — кнопка с текстом и ссылкой.
- Social — ссылки на соцсети.
- Divider — разделитель.
- Spacer — разделитель-прямоугольник.
- Wrapper — рамка для группы элементов.
Поля: тема, подзаголовок.
Что поддерживает: текст, медиафайл с подписью, документ с подписью.
Ограничения:
- Текст: до 2000 знаков.
- Подпись к медиа: до 1000 символов.
Что поддерживает: заголовок, текст сообщения, изображение.
При создании Push-сообщения настройте хотя бы один из блоков: изображение, заголовок или текст.
Что поддерживает: голосовое сообщение (текст в речь).
Поля:
- Язык: Русский, Английский, Испанский, Немецкий, Французский, Узбекский.
- Количество повторов: 1, 2 или 3 раза.
- Текст сообщения.
При написании текста используйте тот же язык, который выбрали в поле «Язык».
Что поддерживает: заголовок и текст.
И заголовок, и текст сообщения не должны быть пустыми.
Шаги создания
Кнопка в правом верхнем углу раздела Шаблоны сообщений (Активы → Шаблоны сообщений).
Понятное имя, например «Скидки на торты».
Из списка: SMS, RCS, Viber, WhatsApp, WeChat, Email, Telegram, Push, TTS, Mobile Push.
Содержимое зависит от канала — см. раздел «Типы шаблонов по каналам» выше.
Нажмите Сохранить изменения.
Перед сохранением проверьте длину сообщения — для SMS важен лимит 70 символов, для WhatsApp карточек — 20/1024/60. Превышение лимита может привести к ошибке.
Что в таблице шаблонов
| Колонка | Что показывает |
|---|---|
| ID | Цифровой идентификатор шаблона |
| Название шаблона | Имя шаблона |
| Канал | SMS, RCS, Viber, WhatsApp, WeChat, Email, Telegram, Push, TTS, Mobile Push |
| Дата последнего изменения | Когда редактировали шаблон |
| Действия | Редактировать или Удалить |
Как использовать шаблон
- В рассылках — выберите шаблон при настройке сообщения.
- В диалогах — через быстрые ответы.
- В чат-ботах — в узлах с сообщениями.
- Через API — с параметром
template.id.
При отправке через Omni API в теле запроса указывается template с id и params. Если шаблон без переменных — передаётся пустой params: {}.
Отдельные типы шаблонов
Шаблоны WhatsApp
Создаются отдельно в разделе Активы → Шаблоны WhatsApp. Требуют предварительного одобрения.
Быстрые ответы
Создаются в разделе Активы → Быстрые ответы. Используются в диалогах.
Частые проблемы
Причина: шаблон не сохранён.
Решение: убедитесь, что нажали Сохранить изменения.
Причина: неверный ID шаблона в запросе.
Решение: проверьте ID шаблона в разделе Активы → Шаблоны сообщений.
Причина: неверный ключ атрибута.
Решение: проверьте формат — attribute.name, attribute.phoneNumber и другие.
Причина: шаблон не прошёл проверку.
Решение: проверьте содержимое шаблона и отправьте на повторную проверку.
Причина: текст превышает допустимый лимит канала.
Решение: проверьте лимиты в разделе «Типы шаблонов по каналам».
Причина: не заполнено обязательное поле или неверный формат данных.
Решение: проверьте все обязательные поля. Если ошибка повторяется — обратитесь в поддержку сервиса.
См. также
Нужна помощь?
- OTP-коды: support@otpcod.ru
- Multi API: support@multiapi.ru
- Мой диалог: support@mydialogi.ru