Единый шаблон: макет в CogaSystem, запуск из вашей системы
Как устроена отправка по единому шаблону: создание макета в кабинете, передача параметров через API и проверка сообщения.
Единый шаблон разделяет оформление и запуск отправки. Команда готовит письмо в интерфейсе, а внешняя система инициирует отправку через API и передаёт нужные параметры. Это подходит для повторяющихся сообщений, содержание которых зависит от события в вашей системе.
Где находится функция
Откройте «Автоматизация» → «Единый шаблон». Страница объясняет последовательность: подготовить шаблон, настроить использование API и передавать параметры.
Порядок действий
- Опишите событие. Решите, какая система и в какой момент должна отправлять письмо. Не смешивайте этот запуск с отдельным триггером на то же событие.
- Создайте шаблон. В форме заполните название, тему, отправителя и организацию, затем перейдите к макету.
- Подготовьте переменные. Согласуйте перечень передаваемых значений и поведение при их отсутствии. Используйте поддерживаемый синтаксис.
- Передайте настройки разработчику. Нужны идентификатор готового шаблона, список параметров и актуальная API-документация.
- Проверьте контрольный запрос. Используйте тестовый адрес и данные, не содержащие секретов или информации реального клиента.
- Проверьте результат. Сопоставьте ответ API, запись об отправке и фактическое письмо. Затем подключайте рабочее событие.
Что проверить по результату
Не переносите автоматически пример обычной массовой кампании в запрос единого шаблона. Названия методов, параметры и способ авторизации берите из действующей документации. Ключи храните на стороне сервера, а не в HTML сайта или письме.
Проверка перед завершением
- Один бизнес-сигнал не запускает два независимых письма.
- Обязательные параметры согласованы.
- Заполненные и пустые значения проверены.
- Ошибка API не считается успешной отправкой.