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

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

Управление шаблонами

Обновлено: 14 ноября 2025 г
Узнайте о распространенных конечных точках, используемых для управления шаблонами.

Получить шаблоны

Используйте GET/ /message_templates для получения списка шаблонов в бизнес-аккаунте WhatsApp.

Получить все шаблоны

Пример запроса для получения всех шаблонов (полей по умолчанию):
curl
 'https://graph.facebook.com/v23.0/102290129340398/ message_templates' \ -H
 'Авторизация: Bearer EAAJB...'
Пример ответа, сокращенный ( ... ) для краткости:
{
 "data"
 : [ {
 "name"
 : "reservation_confirmation" , "parameter_format"
 : "NAMED" , "components"
 : [ {
 "type"
 : "HEADER" , "format"
 : "IMAGE" , "example"
 : { "header_handle"
 : [ "https://scontent.whatsapp.net/v/t61..."
 ]
 }
 },
 {
 "type"
 : "BODY" , "text"
 : "*Все готово!*\n\nВаше бронирование для {{ number_of_guests}} в Lucky Shrub Eatery на {{day}}, {{ date}}, в {{time}} подтверждено. До встречи!" , "example"
 : { "body_text_named_params"
 : [ {
 "param_name"
 : "number_of_guests" , "example"
 : "4" },
 {
 "param_name"
 : "day" , "example"
 : "Saturday" },
 {
 "param_name"
 : "date" , "example"
 : "August 30th, 2025" },
 {
 "param_name"
 : "time" , "example"
 : "7:30 pm" }
 ]
 }
 },
 {
 "type"
 : "FOOTER" , "text"
 : "Lucky Shrub Eatery: The Luckiest Eatery in Town!" },
 {
 "type"
 : "BUTTONS" , "buttons"
 : [ {
 "type"
 : "URL" , "text"
 : "Изменить бронирование" , "url"
 : "https://www.luckyshrubeater.com/reservations" },
 {
 "type"
 : "PHONE_NUMBER" , "text"
 : "Позвоните нам" , "phone_number"
 : "+16467043595" },
 {
 "type"
 : "QUICK_REPLY" , "text"
 : "Отменить бронирование" }
 ]
 }
 ],
 "language"
 : "en_US" , "status"
 : "APPROVED" , "category"
 : "UTILITY" , "id"
 : "1387372356726668" },
 {
 "name"
 : "coupon_expiration_reminder_number_vars" , "parameter_format"
 : "POSITIONAL" , "components"
 : [ {
 "type"
 : "HEADER" , "format"
 : "TEXT" , "text"
 : "Действуй быстро, {{1}}!" , "example"
 : { "header_text"
 : [ "Pablo"
 ]
 }
 },
 {
 "type"
 : "BODY" , "text"
 : "Напоминаем, что ваш эксклюзивный купон, {{1}}, *действителен всего {{2}} дня!* Не пропустите наши специальные предложения. Используйте свой код при оформлении заказа, пока не поздно.\n\nПриятных покупок! 😃" , "example"
 : { "body_text"
 : [ [
 "SUMMER20"
 , "10"
 ]
 ]
 }
 },
 {
 "type"
 : "FOOTER" , "text"
 : "Lucky Shrub Succulents" },
 {
 "type"
 : "BUTTONS" , "buttons"
 : [ {
 "type"
 : "URL" , "text"
 : "See deals" , "url"
 : "https://www.luckyshrub.com/deals" },
 {
 "type"
 : "QUICK_REPLY" , "text"
 : "Unsubscribe" }
 ]
 }
 ],
 "language"
 : "en" , "status"
 :  APPROVED" , "category"
 : "MARKETING" , "sub_category"
 : "CUSTOM" , "id"
 : "1304694804498707" },

 ...

 ],
 "paging"
 : { "cursors"
 : { "before"
 : "QVFIU..." , "after"
 : "QVFIU..." },
 "next"
 : "https://graph.facebook.com/v23.0/10229..." }
 }
Получите все шаблоны и отдельные поля
Пример запроса для получения названия, категории и статуса всех шаблонов в бизнес-аккаунте WhatsApp, с ограничением количества шаблонов в каждом наборе результатов до 5:
curl
 'https://graph.facebook.com/v23.0/102290129340398/ message_templates?fields=name,category,status&limit =5' \ -H
 'Авторизация: Bearer EAAJB...'
Пример ответа:
{
 "data"
 : [ {
 "name"
 : "reservation_confirmation" , "category"
 : "UTILITY" , "status"
 : "APPROVED" , "id"
 : "1387372356726668" },
 {
 "name"
 : "coupon_expiration_reminder_number_vars" , "category"
 : "MARKETING" , "status"
 : "APPROVED" , "id"
 : "1304694804498707" },
 {
 "name"
 : "coupon_expiration_reminder_named_vars" , "category"
 : "MARKETING" , "status"
 : "APPROVED" , "id"
 : "1625063511800527" },
 {
 "name"
 : { "address_update" , "category"
 : "UTILITY" , "status"
 : "PENDING" , "id"
 : "1137051647947973" },
 {
 "name"
 : "reservation_confirmation_short_banner" , "category"
 : "UTILITY" , "status"
 : "REJECTED" , "id"
 : "1166414785519855" }
 ],
 "paging"
 : { "cursors"
 : { "before"
 : "QVFIU..." , "after"
 : "QVFIU..." },
 "next"
 : "https://graph.facebook.com/v23.0/10229..." }
 }
Получите все утвержденные и отклоненные шаблоны
Пример запроса для получения всех утвержденных шаблонов, их названия, категории и статуса (замените status=approved на status=rejected , чтобы получить отклоненные шаблоны):
curl 'https://graph.facebook.com/v23.0/102290129340398/message_templates?fields=name,category,status&status=approved
 ' \ -H 'Авторизация: Bearer EAAJB...'
Пример ответа:
{
 "data"
 : [ {
 "name"
 : "reservation_confirmation" , "category"
 : "UTILITY" , "status"
 : "APPROVED" , "id"
 : "1387372356726668" },
 {
 "name"
 : "coupon_expiration_reminder_number_vars" , "category"
 : "MARKETING" , "status"
 : "APPROVED" , "id"
 : "1304694804498707" },
 {
 "name"
 : "coupon_expiration_reminder_named_vars" , "category"
 : "MARKETING" , "status"
 : "APPROVED" , "id"
 : "1625063511800527" },
 {
 "name"
 : { "calling_permission_request" , "category"
 : "MARKETING" , "status"
 : "APPROVED" , "id"
 : "1092999222892024" },
 {
 "name"
 : "location_request_v1" , "category"
 : "MARKETING" , "status"
 : "APPROVED" , "id"
 : "3373761659571648" },
 {
 "name"
 : "order_confirmation" , "category"
 : "UTILITY" , "status"
 : "APPROVED" , "id"
 : "1667696820637468" }
 ],
 "paging"
 : { "cursors"
 : { "before"
 : "QVFIU..." , "after"
 : "QVFIU..." },
 "next"
 : "https://graph.facebook.com/v23.0/10229..." }
 }
Редактировать шаблоны
Используйте POST / Для редактирования шаблона можно использовать конечную точку. Также для редактирования шаблонов можно использовать  Шаблоны сообщений » в WhatsApp Manager.
Ограничения
    Редактировать можно только шаблоны со  «ОДОБРЕНО» , «ОТКЛОНЕНО» или «ПРИОСТАНОВЛЕНО» Вы можете редактировать только категорию шаблона, его компоненты или время жизни.Вы не можете редактировать отдельные компоненты шаблона; все компоненты будут заменены компонентами из полезной нагрузки запроса на редактирование.Вы не можете редактировать категорию утвержденного шаблона.Утвержденные шаблоны можно редактировать до 10 раз в течение 30 дней или 1 раз в течение 24 часов. Отклоненные или приостановленные шаблоны можно редактировать неограниченное количество раз.После редактирования утвержденного или приостановленного шаблона он будет автоматически утвержден, если только не пройдет проверку шаблона.
    Редактировать категорию шаблона
    Пример запроса:
    curl
     'https://graph.facebook.com/v23.0/1252715608684590 ' \ -H
     'Content-Type: application/json' \ -H
     'Authorization: Bearer EAAJB...' \ -d
     ' {
     "category": "MARKETING"
     }'
    Пример ответа:
    {
     "success"
     : true }
    Редактировать компоненты шаблона
    Пример запроса на перезапись существующих компонентов шаблона новыми компонентами.
    curl
     'https://graph.facebook.com/v23.0/564750795574598' \ -H
     'Content-Type: application/json' \ -H
     'Authorization: Bearer EAAJB...' \ -d
     ' {
     "components": [
     {
     "type": "HEADER",
     "format": "TEXT",
     "text": "Наша распродажа {{1}} началась!",
     "example": {
     "header_text": [
     "Весенняя распродажа"
     ]
     }
     },
     {
     "type": "BODY",
     "text": "Покупайте сейчас через {{1}} и используйте код
     {{2}}, чтобы получить скидку {{3}} на все товары.", "example": {
     "body_text": [
     [
     "конец апреля",
     "25OFF",
     "25%"
     ]
     ]
     }
     },
     {
     "type": "FOOTER",
     "text": "Используйте кнопки ниже для управления вашим
     маркетингом подписки" },
     {
     "type": "КНОПКИ",
     "кнопки": [
     {
     "type": "БЫСТРЫЙ ОТВЕТ",
     "text": "Отписаться от рекламных акций"
     },
     {
     "type": "БЫСТРЫЙ ОТВЕТ",
     "text": "Отписаться от всех"
     }
     ]
     }
     ]
     }'
    Удалить шаблоны
    Используйте кнопку УДАЛИТЬ /  Конечная точка для удаления шаблона по имени или идентификатору.
    Ограничения
      Если вы удалите шаблон, отправленный в шаблонном сообщении, но еще не доставленный (например, потому что телефон клиента выключен), статус шаблона изменится на PENDING_DELETION , и мы будем пытаться доставить сообщение в течение 30 дней.Если вы удалите утвержденный шаблон, вы не сможете создать новый шаблон с тем же именем в течение 30 дней.Шаблоны, находящиеся в отключенном состоянии, удалить нельзя.
      Удалить шаблон по имени
      Удаление шаблона по имени приводит к удалению всех шаблонов, соответствующих этому имени (то есть шаблоны с одинаковым именем, но на разных языках, также будут удалены).
      Пример запроса:
      curl
       -X DELETE 'https://graph.facebook.com/v23.0/102290129340398/ message_templates?name=order_confirmation' \ -H
       'Авторизация: Bearer EAAJB...'
      Пример ответа:
      {
       "success"
       : true }
      Удалить шаблон по ID
      Чтобы удалить шаблон по идентификатору, укажите в запросе идентификатор шаблона вместе с его именем; будет удален только тот шаблон, идентификатор которого совпадает с идентификатором шаблона.
      Пример запроса:
      curl
       -X DELETE 'https://graph.facebook.com/v23.0/102290129340398/ message_templates?hsm_id=1407680676729941&name=ord er_confirmation' \ -H
       'Авторизация: Bearer EAAJB...'
      Пример ответа
      {
       "success"
       : true }
      
    
              
      
    
      

            
      
        
      
    
      

    
      

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