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

Миграция шаблонов | Документация для разработчиков

миграция шаблона

Обновлено: 14 ноября 2025 г
В этом документе описывается, как перенести шаблоны из одного аккаунта WhatsApp Business (WABA) в другой. Обратите внимание, что миграция не перемещает шаблоны, а создает их заново в целевом аккаунте WABA.

Ограничения

    Перенос шаблонов возможен только между WABA-серверами, принадлежащими одной и той же компании Meta.Для миграции подходят только шаблоны со статусом 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>
    Нить
    EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
    <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": "Неверная категория" } }