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

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

Сравнение шаблонов

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

Требования

    Токен доступа пользователя или системного пользователя .Разрешение whatsapp_business_management .

    Ограничения

      Одновременно можно сравнивать только два шаблона.Оба шаблона должны находиться в одном и том же аккаунте WhatsApp Business.Шаблоны должны быть отправлены не менее 1000 раз в течение указанного периода времени.Периоды ретроспективного анализа ограничены 7, 30, 60 и 90 днями с момента подачи запроса.

      Сравнение шаблонов

      Используйте «Сравнение шаблонов сообщений WhatsApp», чтобы выбрать один шаблон и сравнить его с другим.

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

      ПОЛУЧАТЬ /<WHATSAPP_MESSAGE_TEMPLATE_ID> /compare ?template_ids=[ <TEMPLATE_IDS] &start=<START> &end=<END>

      Параметры запроса

      Заполнитель Описание
      <WHATSAPP_MESSAGE_TEMPLATE_ID>
      Идентификатор шаблона сообщения WhatsApp, на который следует нацелить сообщение.
      <TEMPLATE_IDS>
      Идентификатор шаблона сообщения WhatsApp для сравнения с целевым сообщением.
      <START>
      Временная метка UNIX, указывающая на начало временного интервала. См. раздел «Временные интервалы» .
      <END>
      Временная метка UNIX, указывающая на окончание временного интервала. См. раздел «Временные интервалы» .

      Временные рамки

      Временные рамки (окна ретроспективного анализа) ограничены 7, 30, 60 и 90 днями с момента запроса. Чтобы определить временную рамку, установите конечную дату в текущее время в формате UNIX, а затем вычтите из этого значения количество дней в секундах для желаемой временной рамки:
        Вычтите 604800 , чтобы получить 7-дневный период.Вычтите 2592000 , чтобы получить 30-дневный период.Вычтите 5184000 , чтобы получить 60-дневный период.Вычтите 7776000 , чтобы получить 90-дневный период.

        Ответ

        В случае успеха API вернет список сравнения бизнес-шаблонов WhatsApp, описывающих процент блокировки каждого шаблона, количество отправленных сообщений и основную причину блокировки.
        { "data": [ { "metric": "BLOCK_RATE", "type": "RELATIVE", "order_by_relative_metric": [<ORDER_BY_RELATIVE_METRIC> ] }, { "metric": "MESSAGE_SENDS", "type": "NUMBER_VALUES", "number_values": [<NUMBER_VALUES> ] }, { "metric": "TOP_BLOCK_REASON", "type": "STRING_VALUES", "string_values": [<STRING_VALUES> ] } ] }
        Содержание ответа
        
Заполнитель

Описание

        <ORDER_BY_RELATIVE_METRIC>
        Массив строковых идентификаторов шаблонов, расположенных в порядке возрастания частоты блокировок (отношение блокировок к отправкам).
        <NUMBER_VALUES>
        Массив объектов, содержащих числовые значения, отправляемые в сообщениях. Объекты обладают следующими свойствами:
          key — Строка. ID шаблона сообщения WhatsApp.value — Целое число. Количество раз, отправленное в шаблонном сообщении.
          <STRING_VALUES>
          Массив объектов, содержащих строковые значения причин верхнего блока. Объекты обладают следующими свойствами:
            key — Строка. ID шаблона сообщения WhatsApp.Значение — строка. Причина верхнего блока.
            Причинами блокировки могут быть:
              БОЛЬШЕ НЕ НУЖНОНЕТ ПРИЧИНЫНЕ ПРЕДОСТАВЛЕНОРегистрация не требуетсяОскорбительные сообщенияДРУГОЙOTP_DID_NOT_REQUESTСПАМНЕИЗВЕСТНАЯ_ПРИЧИНА_БЛОКИРОВКИ
              Описание этих причин см. в разделе « Просмотр метрик для шаблона сообщения WhatsApp Business» 
              Пример запроса
              curl -X GET 'https://graph.facebook.com/v25.0/5289179717853347/compare?template_ids=[1533406637136032]&start=1674844791182&end=1674845395982' \ -H 'Авторизация: Bearer EAAJB...'

              Пример ответа
              { "data": [ { "metric": "BLOCK_RATE", "type": "RELATIVE", "order_by_relative_metric": [ "1533406637136032", "5289179717853347" ] }, { "metric": "MESSAGE_SENDS", "type": "NUMBER_VALUES", "number_values": [ { "key": "5289179717853347", "value": 1273 }, { "key": "1533406637136032", "value": 1042 } ] }, { "metric": "TOP_BLOCK_REASON", "type": "STRING_VALUES", "string_values": [ { "key": "5289179717853347", "value": "UNKNOWN_BLOCK_REASON" }, { "key": "1533406637136032", "value": "UNKNOWN_BLOCK_REASON" } ] } ] }
              
    
                      
              
        
              
    
              
        
              
            
              
                
                
              
                    
                    
                
              
            
              
            
            
              
                                            
              
        
              
    
              

    

              
    
              

    
            
              
            
              

    
              
        
              
            
             
         
              
            
              

    
              
        
              
                    
              

        
              Комментарии отсутствуют
              

            
              

    

    

                          
              
        
              
                
              
        
              
    
              

    
              

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