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

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

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

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

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

~~Используйте~~ ПОЛУЧАТЬ/<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates ~~Конечная точка для получения списка шаблонов в бизнес-аккаунте WhatsApp.~~

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

~~Пример запроса для получения всех шаблонов (полей по умолчанию):~~

локон'https://graph.facebook.com/v23.0/102290129340398/message_templates' \
-ЧАС«Авторизация: Предъявитель EAAJB...»

~~Пример ответа, сокращенный (~~...~~Для краткости:~~

{
"данные": [
    {
"имя": "подтверждение_бронирования",
"parameter_format": "ИМЯ",
«компоненты»: [
        {
"тип": "ЗАГОЛОВОК",
"формат": "ИЗОБРАЖЕНИЕ",
"пример": {
"header_handle": [
"https://scontent.whatsapp.net/v/t61..."
            ]
          }
        },
        {
"тип": "ТЕЛО",
"текст": «*Всё готово!*\n\nВаша бронь на {{number_of_guests}} в Lucky Shrub Eatery в {{day}}, {{Дата {{время}} подтверждена. До встречи!,
"пример": {
"body_text_named_params": [
              {
"param_name": "количество_гостей",
"пример": "4"
              },
              {
"param_name": "день",
"пример": "Суббота"
              },
              {
"param_name": "дата",
"пример": «30 августа 2025 года»
              },
              {
"param_name": "время",
"пример": «19:30»
              }
            ]
          }
        },
        {
"тип": «Нижний колонтитул»,
"текст": «Lucky Shrub Eatery: Самое удачливое заведение в городе!»
        },
        {
"тип": "КНОПКИ",
"кнопки": [
            {
"тип": "URL",
"текст": "Изменить бронирование",
"url": "https://www.luckyshrubeater.com/reservations"
            },
            {
"тип": "НОМЕР ТЕЛЕФОНА",
"текст": «Позвоните нам»,
"номер телефона": "+16467043595"
            },
            {
"тип": "БЫСТРЫЙ ОТВЕТ",
"текст": "Отменить бронирование"
            }
          ]
        }
      ],
"язык": "en_US",
«статус»: "ОДОБРЕННЫЙ",
"категория": "Утилиты",
"идентификатор": "1387372356726668"
    },
    {
"имя": "coupon_expiration_reminder_number_vars",
"parameter_format": «ПОЗИЦИОННЫЙ»,
«компоненты»: [
        {
"тип": "ЗАГОЛОВОК",
"формат": "ТЕКСТ",
"текст": "Действуй быстро, {{1}}!",
"пример": {
"header_text": [
"Пабло"
            ]
          }
        },
        {
"тип": "ТЕЛО",
"текст": Напоминаем: ваш эксклюзивный промокод! {{1}}, *срок действия истекает всего через {{2}} дня!* Не пропустите! Воспользуйтесь нашими специальными предложениями. Используйте свой код на Оформите заказ, пока не поздно!\n\nПриятных покупок! 😃",
"пример": {
"body_text": [
              [
"ЛЕТО20",
"10"
              ]
            ]
          }
        },
        {
"тип": «Нижний колонтитул»,
"текст": «Счастливые кустарниковые суккуленты»
        },
        {
"тип": "КНОПКИ",
"кнопки": [
            {
"тип": "URL",
"текст": "Посмотреть предложения",
"url": "https://www.luckyshrub.com/deals"
            },
            {
"тип": "БЫСТРЫЙ ОТВЕТ",
"текст": "Отписаться"
            }
          ]
        }
      ],
"язык": "ен",
«статус»: "ОДОБРЕННЫЙ",
"категория": «МАРКЕТИНГ»,
"подкатегория": "ОБЫЧАЙ",
"идентификатор": "1304694804498707"
    },

    ...

  ],
"пейджинг": {
"курсоры": {
"до": "QVFIU...",
"после": "QVFIU..."
    },
"следующий": "https://graph.facebook.com/v23.0/10229..."
  }
}

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

Пример запроса для получения названия, категории и статуса всех шаблонов в бизнес-аккаунте WhatsApp, с ограничением количества шаблонов в каждом наборе результатов до 5:

локон'https://graph.facebook.com/v23.0/102290129340398/message_templates?fields=name,category,status&limit=5' \
-ЧАС«Авторизация: Предъявитель EAAJB...»

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

{
"данные": [
    {
"имя": "подтверждение_бронирования",
"категория": "Утилиты",
«статус»: "ОДОБРЕННЫЙ",
"идентификатор": "1387372356726668"
    },
    {
"имя": "coupon_expiration_reminder_number_vars",
"категория": «МАРКЕТИНГ»,
«статус»: "ОДОБРЕННЫЙ",
"идентификатор": "1304694804498707"
    },
    {
"имя": "coupon_expiration_reminder_named_vars",
"категория": «МАРКЕТИНГ»,
«статус»: "ОДОБРЕННЫЙ",
"идентификатор": "1625063511800527"
    },
    {
"имя": "address_update",
"категория": "Утилиты",
«статус»: "В ОЖИДАНИИ",
"идентификатор": "1137051647947973"
    },
    {
"имя": "краткий баннер подтверждения бронирования",
"категория": "Утилиты",
«статус»: "ОТКЛОНЕННЫЙ",
"идентификатор": "1166414785519855"
    }
  ],
"пейджинг": {
"курсоры": {
"до": "QVFIU...",
"после": "QVFIU..."
    },
"следующий": "https://graph.facebook.com/v23.0/10229..."
  }
}

Получите все утвержденные и отклоненные шаблоны

~~Пример запроса на получение всех утвержденных шаблонов, их названия, категории и статуса (обмен)~~ статус=одобрено с статус=отклонено ~~(чтобы вместо этого получить отклоненные шаблоны):~~

curl 'https://graph.facebook.com/v23.0/102290129340398/message_templates?fields=name,category,status&status=approved' \
-H 'Авторизация: Предъявитель EAAJB...'

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

{
"данные": [
    {
"имя": "подтверждение_бронирования",
"категория": "Утилиты",
«статус»: "ОДОБРЕННЫЙ",
"идентификатор": "1387372356726668"
    },
    {
"имя": "coupon_expiration_reminder_number_vars",
"категория": «МАРКЕТИНГ»,
«статус»: "ОДОБРЕННЫЙ",
"идентификатор": "1304694804498707"
    },
    {
"имя": "coupon_expiration_reminder_named_vars",
"категория": «МАРКЕТИНГ»,
«статус»: "ОДОБРЕННЫЙ",
"идентификатор": "1625063511800527"
    },
    {
"имя": "calling_permission_request",
"категория": «МАРКЕТИНГ»,
«статус»: "ОДОБРЕННЫЙ",
"идентификатор": "1092999222892024"
    },
    {
"имя": "location_request_v1",
"категория": «МАРКЕТИНГ»,
«статус»: "ОДОБРЕННЫЙ",
"идентификатор": "3373761659571648"
    },
    {
"имя": "order_confirmation",
"категория": "Утилиты",
«статус»: "ОДОБРЕННЫЙ",
"идентификатор": "1667696820637468"
    }
  ],
"пейджинг": {
"курсоры": {
"до": "QVFIU...",
"после": "QVFIU..."
    },
"следующий": "https://graph.facebook.com/v23.0/10229..."
  }
}

Редактировать шаблоны

Используйте ПОЧТА /<TEMPLATE_ID> Конечная точка для редактирования шаблона. Вы также можете использовать Шаблоны сообщений⁠? Панель в WhatsApp Manager для редактирования шаблонов.

Ограничения

Редактировать можно только шаблоны со «ОДОБРЕНО» , «ОТКЛОНЕНО» или «ПРИОСТАНОВЛЕНО» Вы можете редактировать только ~~шаблон'~~шаблон'категория, компоненты или срок службы.Вы не можете редактировать отдельные компоненты шаблона; все компоненты будут заменены компонентами из полезной нагрузки запроса на редактирование.Вы не можете редактировать категорию утвержденного шаблона.Утвержденные шаблоны можно редактировать до 10 раз в течение 30 дней или 1 раз в течение 24 часов. Отклоненные или приостановленные шаблоны можно редактировать неограниченное количество раз.После редактирования утвержденного или приостановленного шаблона он будет автоматически утвержден, если только не пройдет проверку шаблона.

Редактировать категорию шаблона

Пример запроса:

локон'https://graph.facebook.com/v23.0/1252715608684590'

\
~~-ЧАС'Content-Type: application/json'~~ \
~~-ЧАС«Авторизация: Предъявитель EAAJB...»~~ \
-д'
{
~~"категория": "МАРКЕТИНГ"~~
}'

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

{
 "success"
 : true }

Редактировать компоненты шаблона

~~Пример запроса на перезапись существующих компонентов шаблона новыми компонентами.~~

локон'https://graph.facebook.com/v23.0/564750795574598' \
-ЧАС'Content-Type: application/json' \
-ЧАС«Авторизация: Предъявитель EAAJB...» \
-д'
{
  "компоненты": [
    {
      "type": "HEADER",
      "формат": "ТЕКСТ",
      "текст": "Наш {{1}} включен!",
      "пример": {
        "header_text": [
          "Весенняя распродажа"
        ]
      }
    },
    {
      "тип": "ТЕЛО",
      "текст": "Покупайте сейчас через {{1}} и используйте код {{2}} получить {{3}} скидку на все товары.",
      "пример": {
        "body_text": [
          [
            «конец апреля»,
            "25OFF",
            "25%"
          ]
        ]
      }
    },
    {
      "type": "FOOTTER",
      "текст": "Используйте кнопки ниже для управления вамимаркетинговые подписки"
    },
    {
      "тип": "КНОПКИ",
      "кнопки": [
        {
          "type": "QUICK_REPLY",
          "текст": "Отписаться от рекламных акций"
        },
        {
          "type": "QUICK_REPLY",
          "текст": "Отписаться от всех"
        }
      ]
    }
  ]
}'

Удалить шаблоны

Используйте кнопку УДАЛИТЬ / Конечная точка для удаления шаблона по имени или идентификатору.

Ограничения

Если вы удаляете шаблон, который был отправлен в шаблонном сообщении, но еще не доставлен (например, из-за...) ~~клиент'~~клиент'(телефон выключен), ~~шаблон'~~шаблон'статус будет установлен на ОЖИДАЕТ УДАЛЕНИЯ И мы постараемся доставить сообщение в течение 30 дней.Если вы удалите утвержденный шаблон, вы не сможете создать новый шаблон с тем же именем в течение 30 дней.Шаблоны, находящиеся в отключенном состоянии, удалить нельзя.

Удалить шаблон по имени

Удаление шаблона по имени приводит к удалению всех шаблонов, соответствующих этому имени (то есть шаблоны с одинаковым именем, но на разных языках, также будут удалены).

Пример запроса:

локон-X

~~УДАЛИТЬ~~ ~~'https://graph.facebook.com/v23.0/102290129340398/message_templates?name=order_confirmation'~~ \
~~-ЧАС«Авторизация: Предъявитель EAAJB...»~~

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

{
 "success"
 : true }

Удалить шаблон по ID

Чтобы удалить шаблон по идентификатору, укажите следующий код: ~~шаблон'~~шаблон'В вашем запросе укажите ID шаблона вместе с его именем; будет удален только тот шаблон, ID которого совпадает с ID шаблона.

Пример запроса:

локон-X УДАЛИТЬ 'https://graph.facebook.com/v23.0/102290129340398/message_templates?hsm_id=1407680676729941&name=order_confirmation' \
-ЧАС«Авторизация: Предъявитель EAAJB...»

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

{
"успех": истинный
}