Миграция шаблонов | Документация для разработчиков
миграция шаблона
Обновлено: 14 ноября 2025 г
В этом документе описывается, как перенести шаблоны из одного аккаунта WhatsApp Business (WABA) в другой. Обратите внимание, что миграция не перемещает шаблоны, а создает их заново в целевом аккаунте WABA.
Ограничения
Для миграции подходят только шаблоны со статусом APPROVED и оценкой качества GREEN или UNKNOWN Синтаксис запроса
WhatsApp Business Account в другую используйте
curl -X POST "https://graph.facebook.com/<API_VERSION> /<DESTINATION_WABA_ID> /migrate_message_templates" \ -H "Авторизация: Bearer"<ACCESS_TOKEN> " \ -H "Content-Type: application/json" \ -d ' { "source_waba_id": "<SOURCE_WABA_ID> ", "page_number":<PAGE_NUMBER> , "считать":<COUNT><!-- only if migrating specific templates that failed to migrate --> "template_ids": [<TEMPLATE_IDS> ] }'Параметры
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ACCESS_TOKEN>Нить | Необходимый. Системный токен или бизнес-токен . | |
<API_VERSION>Нить | Необязательный. Версия Graph API. | v25.0 |
<COUNT>Целое число | Необязательный. Заменяет стандартный размер пакета, устанавливая максимальное количество в 500 элементов. Если выполнение запроса занимает более 30 секунд и происходит таймаут, уменьшите значение счетчика. | 200 |
<DESTINATION_WABA_ID>Идентификатор бизнес-аккаунта WhatsApp | Необходимый. Идентификатор целевого бизнес-аккаунта WhatsApp. | 104996122399160 |
<PAGE_NUMBER>Целое число | Необязательный. Указывает количество шаблонов для миграции, которые следует переносить группами по 500. Индексация производится с нуля. Например, чтобы перенести 1000 шаблонов, отправьте один запрос с этим значением, равным 0 , и еще один запрос с этим значением, равным 1 , параллельно. | 0 |
<TEMPLATE_IDS>Массив строк | Необязательный. Используйте эту функцию только для миграции определенных идентификаторов шаблонов с максимальной длиной массива 500. Например, чтобы мигрировать неработающие идентификаторы шаблонов, добавьте конкретный идентификатор шаблона в массив. | ["35002248699842","351234565148","54382248699842"] |
<SOURCE_WABA_ID>Идентификатор бизнес-аккаунта WhatsApp | Необходимый. Исходный идентификатор бизнес-аккаунта WhatsApp. | 102290129340398 |
Ответ
{ "migrated_templates": [<MIGRATED_TEMPLATES> ], "failed_templates": [<FAILED_TEMPLATES> ] }Свойства отклика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<MIGRATED_TEMPLATES>Список | Список идентификаторов шаблонов, которые были успешно скопированы в целевой бизнес-аккаунт WhatsApp. | "1473688840035974","6162904357082268","6147830171896170" |
<FAILED_TEMPLATES>Карта | На карте отображаются шаблоны, которые не были продублированы в целевом бизнес-аккаунте WhatsApp. Ключами являются идентификаторы шаблонов, а значениями — причины ошибок. | "1019496902803242":"Неверная категория", "259672276895259":"Ошибка форматирования - висячий параметр", "572279198452421":"Неверная категория" |
Пример запроса
curl -X POST 'https://graph.facebook.com/v25.0/104996122399160/migrate_message_templates?source_waba_id=102290129340398&page_number=0' \ -H 'Авторизация: Bearer EAAJB...'
Пример ответа
{ "migrated_templates": [ "1473688840035974", "6162904357082268", "6147830171896170" ], "failed_templates": { "1019496902803242": "Неверная категория", "259672276895259": "Ошибка форматирования - висячий параметр", "572279198452421": "Неверная категория" } }
Комментарии отсутствуют
Комментарии отсутствуют