Перейти к основному содержимому

Последовательности приветственных сообщений — руководство по API | Документация для разработчиков

Последовательности приветственных сообщений — руководство по API

Обновлено: 17 ноября 2025 г
При создании рекламных объявлений Click-to-WhatsApp вы можете подключить последовательность приветственных сообщений из вашего мессенджера. Последовательность может включать текст, предварительно заполненное сообщение и ответы на часто задаваемые вопросы.
В этом руководстве объясняется, как управлять последовательностями приветственных сообщений через конечную точку API.

Требования

Вашему приложению необходимо предоставить whatsapp_business_management .

Изменить существующую последовательность

Последовательность, связанная с активной рекламой, удалить нельзя.
Для обновления существующей последовательности отправьте POST- запрос на WHATSAPP_BUSINESS_ACCOUNT_ID/welcome_message_sequences со следующим содержимым:
Параметр sequence_id задается идентификатором обновляемой последовательности.Другие параметры, такие как name или welcome_message_sequence , также нуждаются в обновлении.

Пример ответа

В ответе содержится сообщение об успехе или об ошибке.

Удалить последовательность

Последовательность, связанная с активной рекламой, удалить нельзя.
Для удаления последовательности отправьте DELETE- запрос на адрес WHATSAPP_BUSINESS_ACCOUNT_ID/welcome_message_sequences параметре sequence_id идентификатор последовательности, которую вы хотите удалить.

Опыт работы с маркетинговым API

После отправки последовательностей приветственных сообщений через API используйте идентификатор последовательности для настройки объявлений через маркетинговый API.
В рекламном креативе идентификатор последовательности можно задать следующим образом:
Для получения дополнительной информации о рекламных сообщениях см. раздел «Рекламные сообщения» в документации по Marketing API.

Пошаговое руководство по работе с Ads Manager

1: В «Шаблон сообщения» рекламного объявления выберите «Партнерское приложение».
Раздел «Шаблон сообщения», отображающий опцию «Партнерское приложение»
Нажмите на «Партнерское приложение» и выберите соответствующее партнерское приложение для обмена сообщениями.
Выбор партнерского приложения в выпадающем меню
3. В разделе «Последовательность сообщений» выберите последовательность приветственных сообщений, которую вы отправили через API.
Выпадающий список выбора последовательности сообщений
Предварительно просмотрите последовательность сообщений и нажмите «Сохранить» .
Предварительный просмотр последовательности сообщений с кнопкой «Сохранить»

коды ошибок

Код Описание Возможные решения
4027001
Неверные входные данные
Часть или все входные данные не соответствуют требуемому формату.
Убедитесь, что все поля и параметры, передаваемые в запрос, имеют правильный тип и формат, а также что все необходимые параметры присутствуют.
4027005
Не удалось создать последовательность приветственных сообщений
Произошла ошибка при попытке создать новую последовательность приветственных сообщений.
Убедитесь, что токен доступа имеет все необходимые разрешения для бизнес-аккаунта WhatsApp.
4027006
Не удалось обновить последовательность приветственных сообщений
Не удалось обновить последовательность приветственных сообщений.
Проверьте правильность всех полей и идентификатора последовательности. Убедитесь, что токен доступа имеет необходимые разрешения для бизнес-аккаунта WhatsApp.
4027007
API недоступен
Доступ к используемому API пока невозможен.
Подождите день-два, пока API станет доступен, и попробуйте снова.
4027010
Отсутствует параметр
Отсутствует один или несколько необходимых параметров.
Проверьте всю документацию и убедитесь в наличии необходимых параметров.
4027012
Последовательность, используемая в рекламе
Последовательность приветственных сообщений связана с активной рекламой и не может быть обновлена ​​или удалена.
Отключите последовательность от рекламы и попробуйте снова.
4027017
Не удалось загрузить последовательность
Не удалось загрузить последовательность, которая обновляется или удаляется.
Последовательность приветственных сообщений либо отсутствует, либо у вас нет разрешения на доступ к ней. Пожалуйста, проверьте токен доступа и убедитесь, что у вас есть необходимые разрешения.