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

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

Группы шаблонов

Обновлено: 27 февраля 2026 г
В этом документе описывается, как создавать, управлять и измерять группы шаблонов.
Группы шаблонов позволяют связать набор шаблонов, чтобы это'это'Отслеживать их производительность как единого целого проще при запросе метрик шаблонов.

Ограничения

    Шаблон может одновременно входить только в одну группу шаблоновНазвания групп шаблонов должны быть уникальнымиУдаление шаблона из группы шаблонов не приводит к удалению каких-либо метрик шаблона, которые он мог внести в группу

    Создавать группа шаблонов

    Используйте ПОЧТА /<WABA_ID> /template_groups Конечная точка для создания группы шаблонов.

    Запрос

    curl 'https://graph.facebook.com/<API_VERSION> /<WABA_ID> /template_groups' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "name": "<TEMPLATE_GROUP_NAME> ", "описание": "<TEMPLATE_GROUP_DESCRIPTION> ", "whatsapp_business_templates": [<TEMPLATE_IDS> ] }'
    Параметры запроса
    
Заполнитель

Описание

Пример значения

    <API_VERSION>
    Нить
    Необязательный.
    Версия Graph API.
    v25.0
    <WABA_ID>Нить
    Необходимый.
    Идентификатор бизнес-аккаунта WhatsApp.
    102290129340398
    <ACCESS_TOKEN>
    Нить
    EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
    <TEMPLATE_GROUP_NAME>Нить
    Необходимый.
    Название группы шаблонов. Должно быть уникальным.
    Максимальное количество символов: 256.
    Чёрная пятница 2024 года
    <TEMPLATE_GROUP_DESCRIPTION>Нить
    Необязательный.
    Описание группы шаблонов.
    Максимальное количество символов: 512.
    Шаблоны для распродаж «Черная пятница» 2024 года в США.
    <TEMPLATE_IDS>Массив целых чисел
    Необходимый.
    Массив идентификаторов шаблонов для добавления в группу.
    278077987957091,1945418102598215,1035843174854974
    Ответ
    В случае успеха:
    { "идентификатор": "<TEMPLATE_GROUP_ID> " }
    Параметры отклика
    
Заполнитель

Описание

Пример значения

    <TEMPLATE_GROUP_ID>
    Идентификатор группы шаблонов.
    9020555671393375
    Пример запроса
    curl 'https://graph.facebook.com/v25.0/102290129340398/template_groups' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "name": "Black Friday 2024", "description": "US-based Black Friday sale 2024 templates."", "whatsapp_business_templates": [278077987957091,1945418102598215,1035843174854974] }'

    Пример ответа
    { "id": "9020555671393375" }
    Получить группу шаблонов
    Используйте ПОЛУЧАТЬ /<TEMPLATE_GROUP_ID> Конечная точка для получения данных о группе шаблонов, а также данных о каждом шаблоне в этой группе.
    Запрос
    curl 'https://graph.facebook.com/<API_VERSION> /<TEMPLATE_GROUP_ID> ' \ -H 'Авторизация: Предъявитель<ACCESS_TOKEN> '
    Параметры запроса
    
Заполнитель

Описание

Пример значения

    <ACCESS_TOKEN>
    Нить
    EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
    <API_VERSION>
    Нить
    Необязательный.
    Версия Graph API.
    v25.0
    <TEMPLATE_GROUP_ID>
Нить
    Необходимый.
    Идентификатор группы шаблонов.
    9020555671393375
    Ответ
    В случае успеха:
    { "имя": "<TEMPLATE_GROUP_NAME> ", "описание": "<TEMPLATE_GROUP_DESCRIPTION> ", "creation_time": "<TEMPLATE_GROUP_CREATION_TIMESTAMP> ", "update_time": "<TEMPLATE_GROUP_LAST_UPDATE_TIMESTAMP> ", "whatsapp_business_account": {<WABA_DETAILS> }, "whatsapp_business_templates": { "data": [<TEMPLATE_DETAILS> ], "пагинация": {<PAGING_CURSORS> } }, "идентификатор": "<TEMPLATE_GROUP_ID> " }
    Параметры отклика
    
Заполнитель

Описание

Пример значения

    <TEMPLATE_GROUP_NAME>
    Название группы шаблонов.
    Чёрная пятница 2024 года
    <TEMPLATE_GROUP_DESCRIPTION>
    Описание группы шаблонов.
    Шаблоны для распродаж «Черная пятница» 2024 года в США.
    <TEMPLATE_GROUP_CREATION_TIMESTAMP>
    Метка времени ISO 8601, указывающая на дату создания группы шаблонов.
    2025-01-06T23:05:12+0000
    <TEMPLATE_GROUP_LAST_UPDATE_TIMESTAMP>
    Метка времени ISO 8601, указывающая, когда группа шаблонов была обновлена ​​в последний раз.
    2025-01-06T23:05:12+0000
    <WABA_DETAILS>
    Объект, описывающий бизнес-аккаунт WhatsApp, которому принадлежит группа шаблонов.
    Видеть пример ответа ниже.
    <TEMPLATE_DETAILS>
    Массив объектов. Каждый объект описывает шаблон и его компоненты в рамках группы шаблонов.
    Видеть пример ответа ниже.
    <PAGING_CURSORS>
    Объект с изображениями «до» и «после» курсоры постраничной навигации Это можно использовать для получения следующего (после) или предыдущего (до) набора объектов в результирующем наборе.
    Видеть пример ответа ниже.
    <TEMPLATE_GROUP_ID>
    Идентификатор группы шаблонов.
    9020555671393375
    Пример запроса
    curl 'https://graph.facebook.com/v25.0/9020555671393375' \ -H 'Авторизация: Bearer EAAJB...'

    Пример ответа
    В приведенном ниже примере результаты ответа для краткости обрезаны многоточием (...).
    { "name": "Черная пятница 2024", "description": "Шаблоны распродажи Черной пятницы 2024 в США."", "creation_time": "2025-01-06T23:05:12+0000", "update_time": "2025-01-06T23:05:12+0000", "whatsapp_business_account": { "id": "102290129340398", "name": "Счастливый кустарник", "currency": "USD", "timezone_id": "1", "message_template_namespace": "ba30dd89_2ebd_41e4_b805_f2c05ae04cc9" }, "whatsapp_business_templates": { "data": [ { "name": "black_friday_2024_carousel_media_header_cards", "parameter_format": "POSITIONAL", "components": [ { "type": "BODY", "text": "Редкие черные суккуленты в продаже! {{1}}, добавить...", "example": { "body_text": [ [ "Pablo" ] ] } }, { "type": "CAROUSEL", "cards": [ { "components": [ { "type": "HEADER", "format": "IMAGE", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29..." ] } }, { "type": "BODY", "text": "Добавить немного..." }, { "type": "BUTTONS", "buttons": [ { "type": "QUICK_REPLY", "text": "Пришлите мне еще подобные!" }, { "type": "URL", "text": "Shop", "url": "https://www.luckyshrub.com/rare-succulents/{{1}}", "example": [ "BLUE_ELF" ] } ] } ] }, ... ] } ], "language": "en_US", "status": "APPROVED", "category": "MARKETING", "id": "1945418102598215" }, ... ], "paging": { "cursors": { "before": "QVFIU...", "after": "QVFIU..." } } }, "id": "9020555671393375" }
    Обновить группу шаблонов
    Используйте ПОЧТА /<TEMPLATE_GROUP_ID> Эталонная точка для обновления имени или описания группы шаблонов, а также для добавления или удаления шаблонов из группы.
    Обратите внимание, что удаление шаблона из группы не приводит к удалению каких-либо данных, связанных с метриками, которые удаленный шаблон мог уже внести в общие метрики группы шаблонов.
    Запрос
    curl 'https://graph.facebook.com/<API_VERSION> /<TEMPLATE_GROUP_ID> ' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "name": "<TEMPLATE_GROUP_NAME> ", "описание": "<TEMPLATE_GROUP_DESCRIPTION> ", "add_templates": [<TEMPLATE_IDS> ], "remove_templates": [<TEMPLATE_IDS> ] }'
    Параметры запроса
    
Заполнитель

Описание

Пример значения

    <API_VERSION>
    Нить
    Необязательный.
    Версия Graph API.
    v25.0
    <TEMPLATE_GROUP_ID>Нить
    Необходимый.
    Идентификатор группы шаблонов.
    102290129340398
    <ACCESS_TOKEN>
    Нить
    EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
    <TEMPLATE_GROUP_NAME>Нить
    Необязательный.
    Название группы шаблонов. Должно быть уникальным.
    Максимальное количество символов: 256.
    Чёрная пятница 2024 года
    <TEMPLATE_GROUP_DESCRIPTION>Нить
    Необязательный.
    Описание группы шаблонов.
    Максимальное количество символов: 512.
    Шаблоны для распродаж «Черная пятница» 2024 года в США.
    <TEMPLATE_IDS>Массив целых чисел
    Необязательный.
    Массив идентификаторов шаблонов для добавления в группу.
    278077987957091,1945418102598215,1035843174854974
    Ответ
    В случае успеха:
    { "успех":<SUCCESS> }
    Параметры отклика
    
Заполнитель

Описание

Пример значения

    <SUCCESS>
    Значение установлено на истинный если запрос на обновление группы шаблонов будет успешным, в противном случае будет установлено значение ЛОЖЬ.
    истинный
    Пример запроса
    В этом примере в группу шаблонов добавляются два шаблона, а третий шаблон удаляется из группы.
    curl 'https://graph.facebook.com/v25.0/9020555671393375' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "add_templates": [844006344365270,1188657612184382], "remove_templates": [1035843174854974] }'

    Пример ответа
    { "success": true }
    Удалить группу шаблонов
    Используйте УДАЛИТЬ /<TEMPLATE_GROUP_ID> Конечная точка для удаления группы шаблонов. Удаление группы шаблонов не приводит к удалению связанных с ней шаблонов.
    Запрос
    curl -X DELETE 'https://graph.facebook.com/<API_VERSION> /<TEMPLATE_GROUP_ID> ' \ -H 'Авторизация: Предъявитель<ACCESS_TOKEN> '
    Параметры запроса
    
Заполнитель

Описание

Пример значения

    <API_VERSION>
    Нить
    Необязательный.
    Версия Graph API.
    v25.0
    <TEMPLATE_GROUP_ID>Нить
    Необходимый.
    Идентификатор группы шаблонов.
    102290129340398
    <ACCESS_TOKEN>
    Нить
    EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
    Ответ
    В случае успеха:
    { "успех":<SUCCESS> }
    Параметры отклика
    
Заполнитель

Описание

Пример значения

    <SUCCESS>
    Значение установлено на истинный если удаление прошло успешно, в противном случае будет установлено значение ЛОЖЬ.
    истинный
    Пример запроса
    curl -X DELETE 'https://graph.facebook.com/v25.0/9020555671393375' \ -H 'Авторизация: Bearer EAAJB...'

    Пример ответа
    { "success": true }
    Аналитика групп шаблонов
    

    
    
            
    
    
    

            
    
        
    
    
    

    
    

    
    
    
        
    
             Вернуться наверх