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

Управление массовыми операциями

Обновлено: 10 ноября 2025 г

Используйте POST / /upsert_message_templates позволяет массово обновлять или создавать шаблоны аутентификации на нескольких языках, включая или исключая необязательные предупреждения о безопасности и истечении срока действия.

Если шаблон с соответствующим именем и языком уже существует, он будет обновлен содержимым запроса; в противном случае будет создан новый шаблон.

Синтаксис запроса

ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> /upsert_message_templates

Тело поста

{ "имя": "<NAME> ", "языки": [<LANGUAGES> ], "category": "AUTHENTICATION", "components": [ { "type": "BODY", "add_security_recommendation":<ADD_SECURITY_RECOMMENDATION> // Необязательно }, { "type": "FOOTER", "code_expiration_minutes":<CODE_EXPIRATION_MINUTES> // Необязательно }, { "type": "КНОПКИ", "кнопки": [ { "type": "OTP", "otp_type": "<OTP_TYPE> ", "supported_apps": [ { "package_name": "<PACKAGE_NAME> ", // Только кнопки с одним нажатием и без нажатия "signature_hash": "<SIGNATURE_HASH> " // Только кнопки с одним нажатием и без нажатия } ] } ] } ] }

Характеристики

Поддерживаются все параметры создания шаблонов

language не поддерживается. Вместо этого используйте languages и установите его значение в виде массива строк с кодами языка и локали . Например: ["en_US","es_ES","fr"] .Текстовое свойство не поддерживается .Свойство autofill_text не поддерживается.

Пример запроса на копирование кода

В этом примере создаются три шаблона аутентификации на английском, испанском и французском языках с кнопками копирования кода. Каждый шаблон называется «authentication_code_copy_code_button» и включает рекомендации по безопасности и время истечения срока действия.

curl 'https://graph.facebook.com/ v25.0 /102290129340398/upsert_message_templates' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "name": "authentication_code_copy_code_button", "languages": ["en_US","es_ES","fr"], "category": "AUTHENTICATION", "components": [ { "type": "BODY", "add_security_recommendation": true }, { "type": "FOOTER", "code_expiration_minutes": 10 }, { "type": "BUTTONS", "buttons": [ { "type": "OTP", "otp_type": "COPY_CODE" } ] } ] }'

Пример запроса на автозаполнение в одно касание

В этом примере (1) обновляется существующий шаблон с именем «authentication_code_autofill_button» и языком «en_US», и (2) создаются два новых шаблона аутентификации на испанском и французском языках с кнопками автозаполнения в одно касание. Оба вновь созданных шаблона называются «authentication_code_autofill_button» и включают рекомендации по безопасности и время истечения срока действия.

curl 'https://graph.facebook.com/ v25.0 /102290129340398/upsert_message_templates' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "name": "authentication_code_autofill_button", "languages": ["en_US","es_ES","fr"], "category": "AUTHENTICATION", "components": [ { "type": "BODY", "add_security_recommendation": true }, { "type": "FOOTER", "code_expiration_minutes": 15 }, { "type": "BUTTONS", "buttons": [ { "type": "OTP", "otp_type": "ONE_TAP", "supported_apps": [ { "package_name": "com.example.luckyshrub", "signature_hash": "K8a/AINcGX7" } ] } ] } ] }'

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

{ "data": [ { "id": "954638012257287", "status": "APPROVED", "language": "en_US" }, { "id": "969725527415202", "status": "APPROVED", "language": "es_ES" }, { "id": "969725530748535", "status": "APPROVED", "language": "fr" } ] }