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

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

Аналитика

Обновлено: 12 февраля 2026 г
Начиная с 1 декабря 2025 года максимальный период ретроспективного анализа для анализа сообщений, переписок и ценообразования изменяется с 10 лет до 1 года. Период ретроспективного анализа для анализа шаблонов и групп шаблонов останется без изменений и будет по-прежнему составлять 90 дней.
В этом документе описывается, как получить аналитику по сообщениям, беседам, шаблонам и группам, например, количество сообщений, отправленных с корпоративного номера телефона, количество бесед и их стоимость для бизнес-аккаунта WhatsApp (WABA), или количество прочтений определенного шаблона.
В ответы будут включены только показатели по номерам телефонов компаний и шаблонам, связанным с вашей системой WABA на момент запроса.

Получить данные

Используйте GET / Конечная точка для получения аналитических данных.

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

curl -g 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_ACCOUNT_ID> ?fields=<FIELD> .<FILTERS> ' \ -H 'Авторизация: Предъявитель<ACCESS_TOKEN> '
Параметры запроса

Заполнитель

Описание

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

<FIELD>
аналитика
<FILTERS>
Необходимый.
Параметр фильтрации метрик. Добавьте дополнительные параметры фильтрации, используя точки.
Возможные значения см. в:
    Параметры аналитики сообщенийПараметры анализа разговоровПараметры анализа шаблоновПараметры аналитики групп шаблоновПараметры анализа звонковПараметры групповой аналитики
    .start(1543543200).end(1544148000).granularity(DAY)
    Аналитика сообщений
    В  аналитики отображается количество и тип сообщений, отправленных и доставленных телефонными номерами, связанными с конкретным WABA — показатели разговоров см. в разделе «Аналитика разговоров» . При звонке / ?fields=analytics.{filtering-parameters} , вы можете добавить следующие параметры.
    Параметры аналитики сообщений
    
Имя

Описание

    начинать
    тип: метка времени UNIX
    Необходимый.
    Начальная дата для диапазона дат, за который вы получаете аналитические данные.
    конец
    тип: метка времени UNIX
    Необходимый.
    Конечная дата для диапазона дат, за который вы получаете аналитические данные.
    детализация
    тип: Строка
    Необходимый.
    Уровень детализации, с которым вы хотите получать аналитические данные. Поддерживаемые параметры:
      ПОЛЧАСАДЕНЬМЕСЯЦ
      номера телефонов
      тип: Массив
      Необязательный.
      Массив телефонных номеров, для которых вы хотите получить аналитические данные. Если не указан, будут включены все телефонные номера, добавленные в ваш WABA-архив.
      тип_продукта
      тип: Массив
      Необязательный.
      Типы сообщений (уведомления и/или сообщения службы поддержки клиентов), для которых вы хотите получать уведомления. Если не указано, аналитика будет возвращена для всех сообщений вместе.
      Поддерживаемые значения:
        0 — для шаблонных сообщений, отправляемых пользователям WhatsApp2 — для сообщений, не являющихся шаблонами, отправленных пользователям WhatsApp100 — для входящих сообщений, отправленных вам пользователями WhatsApp
        коды стран
        тип: Массив
        Необязательный.
        Укажите страны, для которых вы хотите получить аналитические данные. Предоставьте массив с двухбуквенными кодами стран, которые вы хотите включить. Если данные не указаны, будут возвращены аналитические данные для всех стран, с которыми вы взаимодействовали.
        Пример
        Задача: Вам необходимо получить количество сообщений, отправленных и доставленных всеми телефонными номерами, связанными с вашей системой WABA.
        Предлагаемое решение: используйте следующие параметры фильтрации: начало , конец , гранулярность .
        curl -i -X ​​GET "https://graph.facebook.com/v25.0/102290129340398 ?fields=analytics .start(1543543200) .end(1544148000) .granularity(DAY) &access_token=BLI8lkj..."

        В случае успешного ответа возвращается аналитический объект с запрошенными данными:
        { "analytics": { "phone_numbers": [ "16505550111", "16505550112", "16505550113" ], "country_codes": [ "US", "BR" ], "granularity": "DAY", "data_points": [ { "start": 1543543200, "end": 1543629600, "sent": 196093, "delivered": 179715 }, { "start": 1543629600, "end": 1543716000, "sent": 147649, "delivered": 139032 }, { "start": 1543716000, "end": 1543802400, "sent": 61988, "доставлено": 58830 }, { "начало": 1543802400, "конец": 1543888800, "отправлено": 132465, "доставлено": 124392 } # больше точек данных ] }, "id": "102290129340398" }
        Аналитика разговоров
        Поле conversation_analytics предоставляет информацию о стоимости и количестве обращений для конкретного WABA. При вызове / ?fields=conversation_analytics.{filtering-parameters} , вы можете добавить следующие параметры.
        Параметры анализа разговоров
        
Имя
Описание (Для просмотра поддерживаемых параметров нажмите стрелку в левой колонке.)
        начинать
        тип: метка времени UNIX
        Необходимый.
        Начальная дата для диапазона дат, за который вы получаете аналитические данные.
        конец
        тип: метка времени UNIX
        Необходимый.
        Конечная дата для диапазона дат, за который вы получаете аналитические данные.
        детализация
        тип: Строка
        Необходимый.
        Уровень детализации, с которым вы хотите получать аналитические данные. Поддерживаемые параметры:
          ПОЛЧАСАЕЖЕДНЕВНОЕЖЕМЕСЯЧНО
          номера телефонов
          тип: Массив
          Необязательный.
          Массив телефонных номеров, для которых вы хотите получить аналитические данные. Если не указан, будут включены все телефонные номера, добавленные в ваш WABA-архив.
          metric_types
          Необязательный.
          Список метрик, которые вы хотели бы получать. Если вы отправите пустой список, мы вернем результаты для всех типов метрик.
          Поддерживаемые параметры: {#supported}
            СТОИМОСТЬ : Включает приблизительные расценки за указанный период времени в валюте WABA.РАЗГОВОРЫ : Включает количество разговоров за указанный период времени.
            Исключение:
            Стоимость не будет возвращена для WABA, использующих кредитную линию партнера по решениям. Если ваш WABA использует кредитную линию партнера по решениям, свяжитесь с вашим партнером по решениям, чтобы уточнить размер ваших расходов. Если вы задаете вопрос о WABA, использующем кредитную линию партнера по решениям:
              Если в вашем запросе не указаны metric_types  возвращается  CONVERSATION Если указан  параметр CONVERSATION  возвращается  параметр CONVERSATION Если указана только переменная COST , возвращается следующее исключение:
                Заголовок: «Стоимость не указана»Сообщение: «Стоимость больше не отображается для компаний, выставляющих счета через партнера (например, BSP). Чтобы узнать подробности о ваших платежах, пожалуйста, свяжитесь со своим партнером»
                Если вы запрашиваете данные за период времени, включающий даты, начинающиеся 1 июля 2023 года или позже (например, с 1 мая 2023 года по 1 августа 2023 года), в ответе будет указано вышеуказанное исключение.
                Это не относится к случаям запроса  conversation_analytics .
                категории_разговора
                Необязательный.
                Список категорий бесед . Если вы отправите пустой список, мы вернем результаты для всех категорий бесед.
                Поддерживаемые параметры:
                  АутентификацияМАРКЕТИНГУСЛУГАКОММУНАЛЬНЫЕ УСЛУГИ
                  conversation_types
                  Необязательный.
                  Список типов диалогов. Если вы отправите пустой список, мы вернем результаты для всех типов диалогов. Поддерживаемые параметры:
                    FREE_ENTRY : Разговоры, начинающиеся с точки свободного входа .FREE_TIER : Беседы в рамках ежемесячного бесплатного уровня .ОБЫЧНЫЙ : Любые беседы, которые не начались с точки зрения бесплатного доступа или превышают ежемесячный лимит бесплатного доступа.
                    направления разговора
                    Необязательный.
                    Список вариантов развития диалога. Если вы отправите пустой список, мы вернем результаты для всех вариантов развития диалога. Поддерживаемые параметры:
                      BUSINESS_INITIATED : Разговоры, инициированные компанией.USER_INITIATED : Диалоги, инициированные конечным пользователем/клиентом.НЕИЗВЕСТНО : Система не может определить направление.
                      размеры
                      Необязательный.
                      Список вариантов разбивки, которые вы хотите применить к своим метрикам. Если вы отправите пустой список, мы вернем результаты без каких-либо вариантов разбивки. Поддерживаемые параметры:
                        КАТЕГОРИЯ_РАЗГОВОРАНАПРАВЛЕНИЕ_РАЗГОВОРАТИП_РАЗГОВОРАСТРАНАТЕЛЕФОН
                        Аналитические данные являются приблизительными и могут отличаться от данных, указанных в счетах-фактурах, из-за небольших расхождений в обработке данных.
                        Примеры
                        Задав временной диапазон, вы можете получить информацию о конверсии и стоимости, связанную с вашей WABA. При желании вы можете отфильтровать и детализировать результаты. Примеры кода приведены ниже.
                        Получайте ежемесячные данные со всеми разбивками
                        Ситуация: Вам необходимо получить информацию о разговорах и стоимости звонков по всем телефонным номерам, связанным с определенным номером WABA, за определенный месяц.
                        Предлагаемое решение: Используйте следующие параметры фильтрации:
                          start : Начало вашего временного диапазона. В данном случае, начало месяца, за который вы хотите получить метрики.конец : Конец вашего временного диапазона. В данном случае, конец месяца, за который вы хотите получить показатели.Детализация : Насколько детализированными вы хотите сделать свои точки данных. В приведенном ниже примере мы используем MONTHLY , поэтому каждая точка данных будет представлять данные за один месяц.phone_numbers : Отправьте пустой массив, и мы вернем информацию обо всех телефонных номерах, связанных с WABA.Размеры : Установите все доступные параметры разбивки: "КАТЕГОРИЯ_РАЗГОВОРА" , "ТИП_РАЗГОВОРА" , "СТРАНА" и "ТЕЛЕФОН" .
                          В этом случае вам не нужно указывать country_codes , metric_types , conversation_types и conversation_categories . Если вы ничего не укажете для этих полей, мы вернем все доступные варианты. После настройки URL-адреса выполните GET-запрос:
                          curl -i -X ​​GET "https://graph.facebook.com/v25.0/102290129340398 ?fields=conversation_analytics .start(1685602800).end(1688194800) .granularity(MONTHLY) .phone_numbers([]) .dimensions(["CONVERSATION_CATEGORY","CONVERSATION_TYPE","COUNTRY","PHONE"]) &access_token=BLI8lkj..."

                          В случае успешного ответа возвращается  conversation_analytics с запрошенными данными. В следующем примере WABA содержит только один номер телефона.
                          { "conversation_analytics": { "data": [ { "data_points": [ { "start": 1685602800, "end": 1688194800, "conversation": 1558, "phone_number": "15550458206", "country": "US", "conversation_type": "REGULAR", "conversation_direction": "UNKNOWN", "conversation_category": "AUTHENTICATION", "cost": 15.58 }, { "start": 1685602800, "end": 1688194800, "conversation": 2636, "phone_number": "15550458206", "country": "US", "conversation_type": "REGULAR", "conversation_category": "MARKETING", "cost": 26.36 }, { "start": 1685602800, "end": 1688194800, "conversation": 2238, "phone_number": "15550458206", "country": "US", "conversation_type": "REGULAR", "conversation_category": "SERVICE", "cost": 22.38 }, { "start": 1685602800, "end": 1688194800, "conversation": 1782, "phone_number": "15550458206", "country": "US", "conversation_type": "REGULAR", "conversation_category": "UTILITY", "cost": 17.82 }, { "start": 1685602800, "end": 1688194800, "разговор": 1568, "номер_телефона": "15550458206", "страна": "США", "тип_разговора": "бесплатный_уровень", "категория_разговора": "аутентификация", "стоимость": 15.68 }, { "начало": 1685602800, "конец": 1688194800, "разговор": 2716, "номер_телефона": "15550458206", "страна": "США", "тип_разговора": "бесплатный_уровень", "категория_разговора": "маркетинг", "стоимость": 27.16 }, { "начало": 1685602800, "конец": 1688194800, "разговор": 2180, { "номер_телефона": "15550458206", "страна": "США", "тип_разговора": "бесплатный_уровень", "категория_разговора": "услуга", "стоимость": 21.8 }, { "начало": 1685602800, "конец": 1688194800, "разговор": 1465, "номер_телефона": "15550458206", "страна": "США", "тип_разговора": "бесплатный_уровень", "категория_разговора": "коммунальные услуги", "стоимость": 14.65 }, { "начало": 1685602800, "конец": 1688194800, "разговор": 1433, "номер_телефона": "15550458206", "страна": "США", "conversation_type": "FREE_ENTRY_POINT", "conversation_category": "SERVICE", "cost": 14.33 } ] } ] }, "id": "102290129340398", }
                          Получите данные по конкретному номеру телефона, используя все варианты и получасовую детализацию
                          Ситуация : Вам необходимо получить всю информацию о разговорах и стоимости звонков для конкретного телефонного номера, связанного с WABA (Weakary Attendance Association). В результатах необходимо использовать все возможные варианты детализации. Каждая точка данных должна представлять данные за полчаса.
                          Предлагаемое решение : Используйте следующие параметры фильтрации:
                            начало : Начало вашего временного диапазона.конец : Конец вашего временного диапазона.Гранулярность : Насколько детализированными вы хотите сделать точки данных. В приведенном ниже примере мы используем HALF_HOUR , поэтому каждая точка данных представляет собой данные за полчаса.phone_numbers : Номер телефона, для которого вам нужна информация.Размеры : Установите значение для всех доступных вариантов: КАТЕГОРИЯ_РАЗГОВОРА , ТИП_РАЗГОВОРА , СТРАНА и ТЕЛЕФОН .
                            В этом случае вам не нужно указывать country_codes , metric_types , conversation_types или conversation_categories . Если вы ничего не укажете для этих полей, мы вернем все доступные варианты. После настройки URL-адреса выполните GET-запрос:
                            curl -i -X ​​GET \ "https://graph.facebook.com/v25.0/102290129340398 ?fields=conversation_analytics .start(1685602800) .end(1685689200) .granularity(HALF_HOUR) .phone_numbers(["19195552584"]) .dimensions(["CONVERSATION_CATEGORY","CONVERSATION_TYPE","COUNTRY,PHONE"]) &access_token=BLI8lkj..."

                            В случае успешного ответа возвращается  conversation_analytics с запрошенными данными:
                            { "conversation_analytics": { "data": [ { "data_points": [ { "start": 1685602800, "end": 1685604600, "conversation": 4, "phone_number": "19195552584", "country": "US", "conversation_type": "REGULAR", "conversation_direction": "UNKNOWN", "conversation_category": "SERVICE", "cost": 0.0232 }, { "start": 1685602800, "end": 1685604600, "conversation": 4, "phone_number": "19195552584", "country": "US", "conversation_type": "REGULAR", "conversation_direction": "UNKNOWN", "conversation_category": "MARKETING", "стоимость": 0.0232 }, # ... больше точек данных ] } ] }, "id": "102290129340398" }
                            Получайте ежемесячные данные с разбивкой по типам разговоров
                            Сценарий : Вам необходимо получить информацию о всех телефонных разговорах и стоимости звонков для всех номеров, связанных с WABA-кодом. В результатах необходимо указать разбивку по типу разговора.
                            Предлагаемое решение : Используйте следующие параметры фильтрации:
                              начало : Начало вашего временного диапазона.конец : Конец вашего временного диапазона.Детализация : Насколько детализированными вы хотите сделать свои точки данных. В приведенном ниже примере мы используем MONTHLY , поэтому каждая точка данных представляет собой данные за половину месяца.phone_numbers : Отправьте пустой массив, и мы вернем информацию обо всех телефонных номерах, связанных с WABA.dimensions : Установите значение CONVERSATION_TYPE .
                              В этом случае вам не нужно указывать country_codes , metric_types , conversation_types , conversation_directions или conversation_categories . Если вы ничего не укажете для этих полей, мы вернем все доступные варианты. После настройки URL-адреса выполните GET-запрос:
                              curl -i -X ​​GET "https://graph.facebook.com/v25.0/102290129340398 ?fields=conversation_analytics .start(1643702400).end(1646121600) .granularity(MONTHLY) .phone_numbers([]) .dimensions([CONVERSATION_TYPE]) &access_token=BLI8lkj..."

                              В случае успешного ответа возвращается  conversation_analytics с запрошенными данными:
                              { "data": [ { "data_points": [ { "start": 1643702400, "end": 1646121600, "conversation": 8500, "conversation_type": "REGULAR", "cost": 88.1010 }, { "start": 1643702400, "end": 1646121600, "conversation": 1000, "conversation_type": "FREE_TIER", "cost": 0.0000 } { "start": 1643702400, "end": 1646121600, "conversation": 250, "conversation_type": "FREE_ENTRY_POINT", "cost": 0.0000 } ] } ] }
                              Получите данные за полчаса, разбитые по категориям разговоров
                              Запрос:
                              curl -i -X ​​GET "https://graph.facebook.com/v25.0/102290129340398 ?fields=conversation_analytics .start(1685527200) .end(1685613600) .granularity(HALF_HOUR) .conversation_categories(["MARKETING","AUTHENTICATION"]) .dimensions(["CONVERSATION_CATEGORY"]) &access_token=BLI8lkj..."

                              Ответ:
                              { "conversation_analytics": { "data": [ { "data_points": [ { "start": 1685529000, "end": 1685530800, "conversation": 2, "conversation_category": "AUTHENTICATION", "cost": 0.0128 }, { "start": 1685527200, "end": 1685529000, "conversation": 3, "conversation_category": "MARKETING", "cost": 0.0432 } ] } ] }, "id": "102290129340398" }
                              Получите данные за полчаса с разбивкой по категориям и типам разговоров
                              Запрос:
                              curl -i -X ​​GET \ "https://graph.facebook.com/v25.0/102290129340398 ?fields=conversation_analytics .start(1685527200) .end(1685613600) .granularity(HALF_HOUR) .conversation_categories(["MARKETING","AUTHENTICATION"]) .dimensions(["CONVERSATION_CATEGORY","CONVERSATION_TYPE"]) &access_token=BLI8lkj..."

                              Ответ:
                              { "conversation_analytics": { "data": [ { "data_points": [ { "start": 1685527200, "end": 1685529000, "conversation": 3, "conversation_type": "REGULAR", "conversation_category": "MARKETING", "cost": 0.0432 }, { "start": 1685529000, "end": 1685530800, "conversation": 2, "conversation_type": "REGULAR", "conversation_category": "AUTHENTICATION", "cost": 0.0128 } ] } ] }, "id": "102290129340398" }
                              Анализ ценообразования
                              Поле pricing_analytics позволяет получить подробную информацию о ценах на любые сообщения, доставленные в указанном диапазоне дат.
                              Синтаксис запроса
                              ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> ?fields=pricing_analytics .start(<START> ) .конец(<END> ) .granularity(<GRANULARITY> ) .phone_numbers(<PHONE_NUMBERS> ) .country_codes(<COUNTRY_CODES> ) .metric_types(<METRIC_TYPES> ) .pricing_types(<PRICING_TYPES> ) .pricing_categories(<PRICING_CATEGORIES> ) .размеры(<DIMENSIONS> )
                              Параметры ценовой аналитики
                              
Фильтр

Описание

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

                              <COUNTRY_CODES>
                              Массив строк
                              Необязательный.
                              Укажите страны, для которых вы хотите получить аналитические данные. Предоставьте массив с двухбуквенными кодами стран, которые вы хотите включить. Если данные не указаны, будут возвращены аналитические данные для всех стран, с которыми вы взаимодействовали.
                              [США, Бразилия]
                              <DIMENSIONS>
                              Массив строк
                              Необязательный.
                              Список параметров, которые вы хотите применить к своим метрикам. Если вы отправите пустой список, мы вернем результаты без каких-либо параметров.
                              Возможные значения:
                                СТРАНАТЕЛЕФОНКАТЕГОРИЯ_ЦЕНООБРАЗОВАНИЯТИП_ЦЕНЫУРОВЕНЬ
                                [ PRICING_CATEGORY, PRICING_TYPE, COUNTRY ]
                                <END>
                                метка времени UNIX
                                Необходимый.
                                Метка времени UNIX, указывающая конечную дату диапазона дат, за который вы получаете аналитические данные.
                                1728581152
                                <GRANULARITY>
                                Нить
                                Необходимый.
                                Уровень детализации, с которым вы хотите получать аналитические данные. Значение может быть одним из следующих:
                                  ЕЖЕДНЕВНОПОЛЧАСАЕЖЕМЕСЯЧНО
                                  ЕЖЕДНЕВНО
                                  <METRIC_TYPES>
                                  Массив строк
                                  Необязательный.
                                  Массив метрик, которые вы хотите получить. Если вы отправите пустой массив, мы вернем результаты для всех типов метрик.
                                  Возможные значения:
                                    СТОИМОСТЬ : Ориентировочная стоимость сообщений, доставленных в указанный период времени, в валюте вашей WABA.ОБЪЕМ : Включает количество сообщений, доставленных за указанный период времени.
                                    Обратите внимание, что стоимость не будет возвращена для WABA, использующих кредитную линию партнера по решениям. Если ваш WABA использует кредитную линию партнера по решениям, свяжитесь с вашим партнером по решениям, чтобы уточнить размер ваших расходов.
                                    [СТОИМОСТЬ, ОБЪЕМ]
                                    <PHONE_NUMBERS>
                                    Массив строк
                                    Необязательный.
                                    Массив телефонных номеров, для которых вы хотите получить аналитические данные. Если не указан, будут включены данные по всем корпоративным телефонным номерам, связанным с вашей базой данных WABA.
                                    [
15550783881,
15550783882,
15550783883
]
                                    <PRICING_CATEGORIES>
                                    Массив строк
                                    Необязательный.
                                    Массив ценовых категорий. Если вы отправите пустой массив, мы вернем результаты для всех ценовых категорий.
                                    Возможные значения:
                                      АУТЕНТИФИКАЦИЯ : За сообщения взимается плата за аутентификацию.AUTHENTICATION_INTERNATIONAL : Сообщения обрабатываются по международному тарифу аутентификации.МАРКЕТИНГ : За сообщения взимается плата по маркетинговому тарифу.ОБСЛУЖИВАНИЕ : Сообщения, за которые не была произведена оплата. Включает все сообщения, не являющиеся шаблонами, и служебные сообщения, отправленные в течение периода обслуживания клиентов.КОММУНАЛЬНЫЕ УСЛУГИ : За сообщения взимается плата по тарифу коммунальных услуг.REFERRAL_CONVERSION : Сообщения, полученные через бесплатную точку входа.
                                      [Аутентификация, маркетинг, полезность]
                                      <PRICING_TYPES>
                                      Массив строк
                                      Необязательный.
                                      Массив типов ценообразования. Если вы отправите пустой массив, мы вернем результаты для всех типов ценообразования.
                                      Возможные значения:
                                        FREE_CUSTOMER_SERVICE : Бесплатные сообщения. Это сообщения, не являющиеся шаблонами, и служебные сообщения, отправляемые в рамках работы службы поддержки клиентов.FREE_ENTRY_POINT : Все сообщения, отправленные в рамках времени работы службы поддержки клиентов Free Entry Point.ОБЫЧНЫЙ ВАРИАНТ : Платные сообщения. Включает все шаблонные сообщения для аутентификации и маркетинга, а также любые служебные шаблонные сообщения, отправленные вне установленного окна обслуживания клиентов. Исключает все сообщения, отправленные в рамках бесплатного окна обслуживания клиентов.
                                        [ОБЫЧНОЕ, БЕСПЛАТНОЕ ОБСЛУЖИВАНИЕ КЛИЕНТОВ]
                                        <START>
                                        метка времени UNIX
                                        Необходимый.
                                        Временная метка UNIX, указывающая начальную дату диапазона дат, за который вы получаете аналитические данные.
                                        1726014453
                                        <WABA_ID>
                                        Нить
                                        Необходимый.
                                        Идентификатор бизнес-аккаунта WhatsApp.
                                        102290129340398
                                        Информация об уровне объема
                                         добавьте в  измерений  TIER , PRICING_CATEGORY и COUNTRY . Точки данных, представляющие сообщения, на которые влияют тарифные планы объемов, будут иметь  tier в ответе.
                                        Пример синтаксиса ответа с информацией об уровне
                                        { "начинать":<START_TIMESTAMP> , "конец":<END_TIMESTAMP> , "номер телефона": "<BUSINESS_PHONE_NUMBER> ", "страна": "<COUNTRY_CODE> ", "уровень": "<LOWER> :<UPPER> ", "pricing_type": "<PRICING_TYPE> ", "pricing_category": "<PRICING_CATEGORY> ", "объем":<VOLUME> , "расходы":<COST> }
                                        Значение  tier представляет собой конкатенацию нижней и верхней границ для уровня, специфичного для пары "рынок-категория" ( страна и "ценовая категория "), которую представляет данная точка данных.
                                          – Целое число, представляющее нижнюю границу уровня (включительно).– Целое число, представляющее верхнюю границу уровня (включительно), или строка MAX .
                                          Примечания
                                            Чтобы определить свой текущий уровень объема продаж, ознакомьтесь  tier , country и pricing_category . Значение tier Целое число (число после двоеточия) указывает ваш текущий тарифный план для страны и ценовой категории (например, Индия и коммунальные услуги соответственно).Чтобы определить, сколько сообщений нужно отправить для перехода на следующий уровень для данной страны и ценовой категории , вычтите  объема из значения уровня. целое число.Уровни объема будут доступны только для служебных сообщений и сообщений-шаблонов аутентификации. Для маркетинговых сообщений-шаблонов (где уровни объема не применяются) уровень будет установлен на 0:MAX .Свойство tier будет опущено для точек данных, представляющих бесплатные сообщения, поскольку бесплатные сообщения не учитываются при подсчете уровней.Уровни объема будут определяться исключительно Meta. Все данные аналитики являются приблизительными из-за небольших расхождений в обработке данных. Не следует чрезмерно полагаться на данные аналитики.
                                            Пример запроса
                                            curl 'https://graph.facebook.com/v25.0/161311403722088?fields=pricing_analytics.start(1748761200).end(1749687703).granularity(DAILY).dimensions(PRICING_CATEGORY,PRICING_TYPE,TIER,COUNTRY).country_codes(US,IN)' \ -H 'Авторизация: Bearer EAAJB'

                                            Пример ответа
                                            { "pricing_analytics": { "data": [ { "data_points": [ { "start": 1749193200, "end": 1749279600, "country": "IN", "pricing_type": "FREE_CUSTOMER_SERVICE", "pricing_category": "SERVICE", "volume": 2, "cost": 0 }, { "start": 1749106800, "end": 1749193200, "country": "IN", "tier": "0:750000", "pricing_type": "REGULAR", "pricing_category": "AUTHENTICATION_INTERNATIONAL", "volume": 2, "cost": 4.6 }, { "start": 1749106800, "end": 1749193200, "country": "IN", { "pricing_type": "FREE_CUSTOMER_SERVICE", "pricing_category": "SERVICE", "volume": 2, "cost": 0 }, { "start": 1748934000, "end": 1749020400, "country": "US", "tier": "0:MAX", "pricing_type": "REGULAR", "pricing_category": "MARKETING", "volume": 1, "cost": 10 }, { "start": 1748847600, "end": 1748934000, "country": "US", "pricing_type": "FREE_CUSTOMER_SERVICE", "pricing_category": "SERVICE", "volume": 1, "cost": 0 }, { "start": 1748847600, "end": 1748934000, "country": "US", "pricing_type": "FREE_ENTRY_POINT", "pricing_category": "SERVICE", "volume": 6, "cost": 0 }, { "start": 1748847600, "end": 1748934000, "country": "US", "tier": "0:2", "pricing_type": "REGULAR", "pricing_category": "AUTHENTICATION", "volume": 1, "cost": 10 }, { "start": 1748847600, "end": 1748934000, "country": "IN", "tier": "0:750000", "pricing_type": "REGULAR", "pricing_category": "AUTHENTICATION_INTERNATIONAL", "volume": 1, "cost": 2.3 }, { "start": 1748761200, "end": 1748847600, "country": "US", "pricing_type": "FREE_CUSTOMER_SERVICE", "pricing_category": "SERVICE", "volume": 2, "cost": 0 }, { "start": 1748761200, "end": 1748847600, "country": "US", "tier": "0:2", "pricing_type": "REGULAR", "pricing_category": "AUTHENTICATION", "volume": 1, "cost": 10 }, { "start": 1748761200, "end": 1748847600, "country": "US", "pricing_type": "FREE_CUSTOMER_SERVICE", "pricing_category": { "UTILITY", "volume": 1, "cost": 0 }, { "start": 1748761200, "end": 1748847600, "country": "US", "tier": "0:2", "pricing_type": "REGULAR", "pricing_category": "UTILITY", "volume": 1, "cost": 10 }, { "start": 1748761200, "end": 1748847600, "country": "US", "tier": "0:MAX", "pricing_type": "REGULAR", "pricing_category": "MARKETING", "volume": 4, "cost": 40 }, { "start": 1748761200, "end": 1748847600, "country": "US", "tier": "0:MAX", "pricing_type": "REGULAR", "pricing_category": "MARKETING_LITE", "volume": 1, "cost": 10 } ] } ] } }
                                            Аналитика шаблонов
                                            Аналитика шаблонов показывает количество отправленных, доставленных и прочитанных шаблонов, а также количество кликов по кнопкам URL или кнопкам быстрого ответа в шаблоне. Кроме того, интегрированный API MM для WhatsApp Business позволяет отслеживать показатели конверсии вне сайта.
                                            Данные возвращаются с точностью до дня в часовом поясе по умолчанию UTC и часовом поясе WABA, с периодом ретроспективного анализа до 90 дней. Для отображения данных в настроенном часовом поясе WABA передайте параметр use_waba_timezone со значением true.
                                            Для отображения данных в часовом поясе, настроенном для WABA, передайте  use_waba_timezone со значением true .
                                            { "data": [ { "waba_timezone": "America/Los_Angeles", "granularity": "DAILY", "product_type": "cloud_api", "data_points": [ ... ] } }
                                            Ограничения
                                              Аналитика кликов по кнопкам доступна только для шаблонов, отнесенных к категориям МАРКЕТИНГ или ПОЛЕЗНЫЕ ИНСТРУМЕНТЫ .WABA-аккаунты, принадлежащие или используемые совместно с Meta Business Accounts в Европейском Союзе, Соединенном Королевстве или Японии, или имеющие бизнес-номер с кодом страны из любой из этих стран или регионов, не поддерживаются.Показатели конверсии вне сайта доступны исключительно для компаний, подключенных к MM API для WhatsApp.Данные о прочтении и кликах по шаблонным сообщениям WhatsApp доступны только в течение 7 дней с момента отправки сообщения. По истечении этого 7-дневного периода соответствующие счетчики прочтений/кликов обнуляются, и дальнейшие обновления для этих сообщений не регистрируются.
                                              Подтверждение аналитики шаблона
                                              Для получения аналитики по шаблонам необходимо подтвердить ее в своем аккаунте WhatsApp Business. Подтвердить ее можно с помощью WhatsApp Manager или API.
                                              Подтвердив доступ через API, вы даёте Meta разрешение на добавление аналитических данных в ваш бизнес-аккаунт WhatsApp. Эти данные включают отслеживание ссылок для составления отчётов о переходах на веб-сайты. Вы можете отключить отслеживание ссылок в каждом шаблоне сообщения. Вы также даёте Meta разрешение на сбор и анонимизацию данных из ваших чатов с клиентами. Meta будет анонимизировать эти данные для улучшения предоставляемых вам и другим компаниям услуг.
                                              Для подтверждения через API отправьте следующий запрос:
                                              ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> ?is_enabled_for_insights=true
                                              После подтверждения мы начнем сбор аналитики шаблонов для бизнес-аккаунта WhatsApp. После подтверждения аналитику шаблонов отключить нельзя.
                                              В случае успешного выполнения API отправит вам идентификатор вашего бизнес-аккаунта WhatsApp. Например:
                                              { "id": 102290129340398 }
                                              Параметры анализа шаблонов
                                              
Имя

Описание

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

                                              начинать
                                              Строка времени или даты в формате UNIX
                                              Необходимый.
                                              Начальное время для диапазона дат, за который вы получаете аналитические данные. Может быть представлено либо в виде целочисленной метки времени Unix, либо в виде строки даты в формате ГГГГ-ММ-ДД. Поскольку аналитические данные шаблона предоставляются с ежедневной детализацией в часовом поясе UTC, начальная метка времени Unix, не соответствующая 0:00 UTC, будет скорректирована до текущего 00:00 UTC.
                                              Если  use_waba_timezone имеет значение true, это значение должно быть строкой даты в формате ГГГГ-ММ-ДД.
                                              1543536000
                                              конец
                                              Строка времени или даты в формате UNIX
                                              Необходимый.
                                              Время окончания диапазона дат, для которого вы получаете аналитические данные. Может быть представлено либо в виде целочисленной метки времени Unix, либо в виде строки даты в формате ГГГГ-ММ-ДД. Поскольку аналитические данные шаблона предоставляются с ежедневной детализацией в часовом поясе UTC, метка времени окончания Unix, не соответствующая 0:00 UTC, будет скорректирована до текущего 00:00 UTC.
                                              Если  use_waba_timezone имеет значение true, это значение должно быть строкой даты в формате ГГГГ-ММ-ДД.
                                              1543708800
                                              детализация
                                              Перечисление
                                              Необходимый.
                                              Уровень детализации, с которым вы хотите получать аналитические данные. Значение должно быть ЕЖЕДНЕВНЫМ .
                                              ЕЖЕДНЕВНО
                                              template_ids
                                              Массив идентификаторов
                                              Необходимый.
                                              Массив идентификаторов шаблонов, для которых вы хотите получить аналитические данные.
                                              Максимум 10.
                                              [1924084211297547,954638012257287,969725530748535]
                                              metric_types
                                              Массив перечислений
                                              Необязательный.
                                              Типы метрик, которые вы хотите получить. Если этот параметр отсутствует или представляет собой пустой массив, будут возвращены аналитические данные для всех типов метрик.
                                              Возможные значения:
                                                РАСХОДЫНАЖАЛДОСТАВЛЕННЫЙЧИТАТЬОТПРАВИЛAPP_ACTIVATIONS (MM API только для WhatsApp)APP_ADD_TO_CART (MM API только для WhatsApp)APP_CHECKOUTS_INITIATED (MM API только для WhatsApp)APP_PURCHASES (MM API только для WhatsApp)APP_PURCHASES_CONVERSION_VALUE (только для API MM для WhatsApp)WEBSITE_ADD_TO_CART (MM API только для WhatsApp)WEBSITE_CHECKOUT_INITIATED (MM API только для WhatsApp)ПОКУПКИ НА САЙТЕ (MM API только для WhatsApp)WEBSITE_PURCHASES_CONVERSION_VALUE (MM API только для WhatsApp)
                                                Обратите внимание, что стоимость не будет возвращена для WABA, использующих кредитную линию партнера по решениям. Если ваш WABA использует кредитную линию партнера по решениям, свяжитесь с вашим партнером по решениям, чтобы уточнить размер ваших расходов.
                                                [ОТПРАВЛЕНО, ДОСТАВЛЕНО, ПРОЧИТАНО]
                                                тип продукта
                                                Перечисление
                                                Необязательный.
                                                Тип продукта метрик, которые вы хотите получить. Если этот параметр опущен, будут возвращены только аналитические данные для Cloud API.
                                                Возможные значения:
                                                  CLOUD_API : Используйте этот тип продукта для фильтрации метрик шаблонов, отправляемых через Cloud API.MARKETING_MESSAGES_API_FOR_WHATSAPP : Используйте этот тип продукта для фильтрации метрик шаблонов, отправляемых через Marketing Messages API для WhatsApp.
                                                  API для маркетинговых сообщений WhatsApp
                                                  <USE_WABA_TIMEZONE>
                                                  Логический
                                                  Необязательный.
                                                  Следует ли отображать метрики в часовом поясе, заданном в WABA. Если значение равно false или отсутствует, метрики будут отображаться в UTC.
                                                  Если значение равно true, параметры start и end должны быть в формате ГГГГ-ММ-ДД.
                                                  истинный
                                                  Примеры
                                                  Получение всей аналитики по шаблонам
                                                  Задача: за 1 день получить все типы метрик аналитики шаблонов для шаблона аутентификации и маркетингового шаблона с кнопкой URL.
                                                  Пример запроса:
                                                  curl -g 'https://graph.facebook.com/v25.0/109259195336416/template_analytics?start=1718064000&end=1718122745&granularity=daily&metric_types=cost%2Cclicked%2Cdelivered%2Cread%2Csent&template_ids=[1421988012088524%2C2632273056924580]' \ -H 'Авторизация: Bearer EAAJB...'

                                                  Пример ответа:
                                                  { "data": [ { "granularity": "DAILY", "product_type": "cloud_api", // Доступно только для компаний в альфа-версии API маркетинговых сообщений для WhatsApp "data_points": [ { "template_id": "1421988012088524", "start": 1718064000, "end": 1718150400, "sent": 1, "delivered": 1, "read": 1, "cost": [ { "type": "amount_spent", "value": 0.01 }, { "type": "cost_per_delivered", "value": 0.01 } ] }, { "template_id": "2632273056924580", "start": 1718064000, "end": 1718150400, "sent": 1, "доставлено": 1, "прочитано": 1, "нажато": [ { "тип": "кнопка быстрого ответа", "содержимое кнопки": "Связаться со службой поддержки", "количество": 108 }, { "тип": "уникальная кнопка URL", "содержимое кнопки": "Расскажите подробнее", "количество": 16 } ], "стоимость": [ { "тип": "израсходованная сумма", "значение": 0.03 }, { "тип": "стоимость за доставленный", "значение": 0.03 }, { "тип": "стоимость за клик по кнопке URL", "значение": 0.03 } ] } ] } ], "пагинация": { "курсоры": { "до": "MAZDZD", "после": "MjQZD" } } }
                                                  Аналитика шаблонов: стоимость и показатели кликов
                                                  Показатели затрат возвращаются в виде массива объектов затрат, каждый из которых имеет тип и значение. Типы могут быть следующими:
                                                    amount_spent — Общая сумма, потраченная на диалоги, открытые в течение начального и конечного периодов времени в результате отправки шаблона. См. «Открытие диалогов» .cost_per_delivered —  amount_spent, деленное на количество доставок шаблона в течение начального и конечного периодов времени.cost_per_url_button_click —  amount_spent, деленное на количество нажатий на кнопку URL шаблона в течение начального и конечного временных интервалов. Нажатия на кнопку быстрого ответа не учитываются. Объект опускается, если шаблон не содержит кнопки URL.
                                                    Показатели кликов возвращаются в виде массива объектов JSON, каждый из которых содержит тип и значение. Клики возвращаются только для кнопок URL и кнопок быстрого ответа в шаблонах, отнесенных к категориям МАРКЕТИНГ или ПОЛЕЗНОСТЬ .
                                                    Типы могут быть следующими:
                                                      url_button — Общее количество кликов по кнопке url.unique_url_button — Показатель уникальных кликов отслеживает количество различных учетных записей WhatsApp, которые нажали на кнопку. Этот показатель помогает понять, сколько отдельных пользователей взаимодействуют с вашими призывами к действию, исключая повторные клики от одного и того же получателя и обеспечивая точное измерение вовлеченности.
                                                      Отключение аналитики кликов по кнопкам
                                                      Вы можете отключить отслеживание кликов по кнопкам в отдельном шаблоне, установив для поля cta_url_link_tracking_opted_out  true . После отключения API больше не будет возвращать свойство clicked в аналитике шаблона и не будет отображать активность/клики по кнопкам в WhatsApp Manager при просмотре статистики шаблона.
                                                      Синтаксис запроса
                                                      ПОЧТА /<TEMPLATE_ID> ?cta_url_link_tracking_opted_out=<OPT_OUT> &category=<TEMPLATE_CATEGORY>
                                                      Параметры запроса
                                                      
Заполнитель

Описание

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

                                                      <WHATSAPP_TEMPLATE_ID>
                                                      Идентификатор шаблона
                                                      Необходимый.
                                                      Идентификатор шаблона.
                                                      245435364965041
                                                      <OPT_OUT>
                                                      Логический
                                                      Необходимый.
                                                      Указывает, отключено ли отслеживание кликов по кнопкам шаблона. Установите значение true , чтобы отключить отслеживание кликов по кнопкам в шаблоне, или false, чтобы включить.
                                                      При создании шаблона это значение устанавливается в false 
                                                      истинный
                                                      <TEMPLATE_CATEGORY>
                                                      Нить
                                                      Необходимый.
                                                      Текущая категория шаблона.
                                                      Если вы зададите категории шаблона значение, отличное от текущей категории, статус шаблона изменится на «ОЖИДАЕТСЯ» , и шаблон должен пройти проверку для утверждения.
                                                      маркетинг
                                                      Пример запроса
                                                      curl -X POST 'https://graph.facebook.com/v25.0/245435364965041?cta_url_link_tracking_opted_out=true&category=marketing' \ -H 'Авторизация: Bearer EAAJB...'

                                                      Пример ответа
                                                      В случае успеха API ответит следующим образом:
                                                      { "success": true }
                                                      Аналитика групп шаблонов
                                                      Поле template_group_analytics позволяет получить количество отправленных, доставленных и прочитанных шаблонов в группе шаблонов , а также количество нажатий на кнопки URL или кнопки быстрого ответа .
                                                      Данные возвращаются с точностью до дня в часовом поясе по умолчанию UTC и часовом поясе WABA, с периодом ретроспективного анализа до 90 дней. Для отображения данных в настроенном часовом поясе WABA передайте параметр use_waba_timezone со значением true.
                                                      { "data": [ { "waba_timezone": "America/Los_Angeles", "granularity": "DAILY", "product_type": "cloud_api", "data_points": [ ... ] } }
                                                      Ограничения
                                                      Аналитика кликов по кнопкам доступна только для шаблонов, отнесенных к категориям «маркетинг» или «полезные» . WABA-аккаунты, принадлежащие или используемые совместно с Meta Business Accounts в Европейском Союзе, Великобритании или Японии, или имеющие бизнес-номер телефона с кодом страны из этих стран или регионов, не поддерживаются.
                                                      Включение аналитики шаблонов
                                                      Для получения аналитики по группам с использованием шаблонов необходимо включить аналитику по шаблонам в вашем аккаунте WhatsApp Business. Подтвердить включение аналитики по шаблонам можно с помощью WhatsApp Manager или API.
                                                      Подтвердив доступ через API, вы даёте Meta разрешение на добавление аналитических данных в ваш бизнес-аккаунт WhatsApp. Эти данные включают отслеживание ссылок для составления отчётов о переходах на веб-сайты. Вы можете отключить отслеживание ссылок в каждом шаблоне сообщения. Вы также даёте Meta разрешение на сбор и анонимизацию данных из ваших чатов с клиентами. Meta будет анонимизировать эти данные для улучшения предоставляемых вам и другим компаниям услуг.
                                                      Для подтверждения включения через API отправьте следующий запрос:
                                                      ПОЧТА /<WHATSAPP_BUSINESS_ACCOUNT_ID> ?is_enabled_for_insights=true
                                                      В случае успеха API отправит вам идентификатор вашей бизнес-учетной записи WhatsApp, и мы начнем сбор аналитики по группам шаблонов для этой бизнес-учетной записи WhatsApp.
                                                      После включения аналитику шаблонов отключить ее невозможно.
                                                      Синтаксис запроса
                                                      ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> /template_group_analytics ?granularity=daily &start=<START_TIME> &end=<END_TIME> &metric_types=<METRIC_TYPES> &template_group_ids=[<TEMPLATE_GROUP_IDS> ]
                                                      Параметры аналитики групп шаблонов
                                                      
Заполнитель

Описание

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

                                                      Нить
                                                      Необходимый.
                                                      Идентификатор бизнес-аккаунта WhatsApp.
                                                      102290129340398
                                                      <START_TIME>
                                                      Строка времени или даты в формате UNIX
                                                      Необходимый.
                                                      Время начала диапазона дат, за который вы получаете аналитические данные. Может быть представлено либо в виде целочисленной метки времени Unix, либо в виде строки даты в формате ГГГГ-ММ-ДД.
                                                      Поскольку аналитика групп шаблонов предоставляется с ежедневной детализацией в часовом поясе UTC, начальная метка времени Unix, не соответствующая 0:00 UTC, будет скорректирована до текущего времени 00:00 UTC.
                                                      Если  use_waba_timezone имеет значение true, это значение должно быть строкой даты в формате ГГГГ-ММ-ДД.
                                                      1738465116
                                                      <END_TIME>
                                                      Строка времени или даты в формате UNIX
                                                      Необходимый.
                                                      Время окончания диапазона дат, за который вы получаете аналитические данные. Может быть представлено либо в виде целочисленной метки времени Unix, либо в виде строки даты в формате ГГГГ-ММ-ДД.
                                                      Поскольку аналитика групп шаблонов предоставляется с ежедневной детализацией в часовом поясе UTC, конечная метка времени Unix, не соответствующая 0:00 UTC, будет скорректирована до текущего времени 00:00 UTC.
                                                      Если параметр use_waba_timezone имеет значение true, это значение должно быть строкой даты в формате ГГГГ-ММ-ДД.
                                                      1739559516
                                                      <METRIC_TYPES>
                                                      Массив строк
                                                      Необязательный.
                                                      Массив метрик, которые вы хотите получить. Если вы отправите пустой массив, API вернет результаты для всех типов метрик.
                                                      Возможные значения:
                                                        расходыкликнулдоставленныйчитатьотправил
                                                        Обратите внимание, что функция COST недоступна для корпоративных клиентов, счета за услуги которых выставляются через партнера по решениям.
                                                        [отправлено, доставлено, прочитано]

                                                        <TEMPLATE_GROUP_IDS>
                                                        Необходимый.
                                                        Массив идентификаторов групп шаблонов, для которых вы хотите получить метрики групп шаблонов.
                                                        Максимум 10 идентификаторов.
                                                        102290129340398
                                                        <USE_WABA_TIMEZONE>`
                                                        Логический
                                                        Необязательный.
                                                        Следует ли отображать метрики в часовом поясе, заданном в WABA. Если значение равно false или отсутствует, метрики будут отображаться в UTC.
                                                        Если значение равно true, параметры start и end должны быть в формате ГГГГ-ММ-ДД.
                                                        истинный
                                                        Пример запроса
                                                        curl -g 'https://graph.facebook.com/v25.0/102290129340398/template_group_analytics?granularity=daily&start=1738465116&end=1739559516&metric_types=sent,delivered,read&template_group_ids=[1044106240855852]' \ -H 'Авторизация: Bearer EAAJB...'

                                                        Пример ответа
                                                        Обратите внимание, что приведенный ниже пример для краткости сокращен многоточием ( ... ).
                                                        { "data": [ { "granularity": "DAILY", "data_points": [ { "template_group_id": "1044106240855852", "start": 1739491200, "end": 1739577600, "sent": 1460, "delivered": 1460, "read": 1399 }, { "template_group_id": "1044106240855852", "start": 1739404800, "end": 1739491200, "sent": 673, "delivered": 673, "read": 645 }, ... ] } ], "paging": { "cursors": { "before": "MAZDZD", "after": "MjQZD" } } }
                                                        Показатели стоимости и кликов для групп шаблонов
                                                        Показатели затрат возвращаются в виде массива объектов затрат, каждый из которых имеет тип и значение. Типы могут быть следующими:
                                                          amount_spent — Общая сумма, потраченная на диалоги, открытые в течение начального и конечного периодов времени в результате отправки шаблона. См. «Открытие диалогов» .cost_per_delivered —  amount_spent, деленное на количество доставок шаблона в течение начального и конечного периодов времени.cost_per_url_button_click —  amount_spent, деленное на количество нажатий на кнопку URL шаблона в течение начального и конечного временных интервалов. Нажатия на кнопку быстрого ответа не учитываются. Объект опускается, если шаблон не содержит кнопки URL.
                                                          Показатели кликов возвращаются в виде массива объектов JSON, каждый из которых содержит тип и значение. Клики возвращаются только для кнопок URL и кнопок быстрого ответа в шаблонах, отнесенных к категориям «маркетинг» или «полезные материалы» .
                                                          Типы могут быть следующими:
                                                            url_button — Общее количество кликов по кнопке url.unique_url_button — Показатель уникальных кликов отслеживает количество различных учетных записей WhatsApp, которые нажали на кнопку. Этот показатель помогает понять, сколько отдельных пользователей взаимодействуют с вашими призывами к действию, исключая повторные клики от одного и того же получателя и обеспечивая точное измерение вовлеченности.
                                                            Анализ звонков
                                                            Поле call_analytics отображает количество и тип звонков, совершенных и принятых по телефонным номерам, связанным с конкретной системой WABA. При звонке / ?fields=call_analytics.{filtering-parameters} , вы можете добавить следующие параметры.
                                                            Параметры анализа звонков
                                                            
Имя

Описание

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

                                                            начинать
                                                            тип: метка времени UNIX
                                                            Необходимый.
                                                            Начальная дата для диапазона дат, за который вы получаете аналитические данные.
                                                            1728581152
                                                            конец
                                                            тип: метка времени UNIX
                                                            Необходимый.
                                                            Конечная дата для диапазона дат, за который вы получаете аналитические данные.
                                                            1728581152
                                                            детализация
                                                            тип: Строка
                                                            Необходимый.
                                                            Уровень детализации, с которым вы хотите получать аналитические данные. Поддерживаемые параметры:
                                                              ПОЛЧАСАЕЖЕДНЕВНОЕЖЕМЕСЯЧНО
                                                              ЕЖЕДНЕВНО
                                                              номера телефонов
                                                              тип: Массив
                                                              Необязательный.
                                                              Массив телефонных номеров, для которых вы хотите получить аналитические данные. Если не указан, будут включены все телефонные номера, добавленные в ваш WABA-архив.
                                                              [15550783881,15550783882]
                                                              коды стран
                                                              тип: Массив
                                                              Необязательный.
                                                              Укажите страны, для которых вы хотите получить аналитические данные. Предоставьте массив с двухбуквенными кодами стран, которые вы хотите включить. Если данные не указаны, будут возвращены аналитические данные для всех стран, с которыми вы взаимодействовали.
                                                              [США, Бразилия]
                                                              указания
                                                              Массив перечислений
                                                              Необязательный.
                                                              Направление звонка, для которого вы хотите получить аналитические данные. Поддерживаемые параметры:
                                                                ИНИЦИИРОВАННЫЙ ПОЛЬЗОВАТЕЛЕМИНИЦИИРОВАННЫЙ БИЗНЕС
                                                                ИНИЦИИРОВАННЫЙ ПОЛЬЗОВАТЕЛЕМ
                                                                размеры
                                                                Массив перечислений
                                                                Необязательный.
                                                                Список вариантов разбивки, которые вы хотите применить к своим метрикам. Если вы отправите пустой список, мы вернем результаты без каких-либо вариантов разбивки. Поддерживаемые параметры:
                                                                  телефоннаправлениестрана
                                                                  направление
                                                                  metric_types
                                                                  Массив перечислений
                                                                  Необязательный.
                                                                  Массив метрик, которые вы хотите получить. Если вы отправите пустой массив, API вернет результаты для всех типов метрик. Поддерживаемые параметры:
                                                                    СЧИТАТЬРАСХОДЫСРЕДНЯЯ_ПРОДОЛЖИТЕЛЬНОСТЬ
                                                                    СРЕДНЯЯ_ПРОДОЛЖИТЕЛЬНОСТЬ
                                                                    Пример
                                                                    Задача: Вам необходимо получить количество инициированных пользователями звонков, поступивших на все телефонные номера, связанные с вашей системой WABA, с точностью до дня.
                                                                    Предлагаемое решение: используйте следующие параметры фильтрации: начало , конец , детализация , направления .
                                                                    curl -i -X ​​GET "https://graph.facebook.com/v25.0/102290129340398 ?fields=call_analytics .start(1759302000) .end(1767168000) .granularity(DAILY) .directions(USER_INITIATED) &access_token=BLI8lkj..."

                                                                    В случае успешного ответа возвращается  call_analytics с запрошенными данными:
                                                                    { "call_analytics": { "granularity": "DAILY", "directions": "USER_INITIATED", "data_points": [ { "start": 1765958400, "end": 1766044800, "cost": 0.47795, "count": 35, "average_duration": 106 }, { "start": 1760943600, "end": 1761030000, "cost": 0, "count": 20, "average_duration": 103 }, { "start": 1760857200, "end": 1760943600, "cost": 0, "count": 24, "average_duration": 103 }, # more data points ] }, "id": "102290129340398" }
                                                                    Групповая аналитика
                                                                    API групповой аналитики позволяет получать информацию о количестве отправленных, доставленных и прочитанных сообщений в группах WhatsApp, а также о количестве участников, присоединившихся к группе или покинувших её.
                                                                    Данные предоставляются с ежедневной детализацией и периодом анализа до 90 дней.
                                                                    Синтаксис запроса
                                                                    ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> /group_analytics ?granularity=daily &start=<START_TIME> &end=<END_TIME> &metric_types=[<METRIC_TYPES> ] &group_ids=[<GROUP_IDS> ]
                                                                    Параметры групповой аналитики
                                                                    
Заполнитель

Описание

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

                                                                    <START_TIME>
                                                                    Временная метка UNIX
                                                                    Необходимый.
                                                                    Начальное время для диапазона дат, за который вы получаете аналитические данные. Оно не должно превышать 90 дней от текущей даты.
                                                                    1685548801
                                                                    <END_TIME>
                                                                    Временная метка UNIX
                                                                    Необходимый.
                                                                    Время окончания периода, за который вы получаете аналитические данные.
                                                                    1685721600
                                                                    <GROUP_IDS>
                                                                    Массив строк
                                                                    Необходимый.
                                                                    Массив идентификаторов групп, для которых вы хотите получить групповые метрики.
                                                                    В настоящее время поддерживается только 1 идентификатор.
                                                                    ["GROUP_ID"]
                                                                    <GRANULARITY>
                                                                    Нить
                                                                    Необязательный.
                                                                    Уровень детализации, с которым вы хотели бы получать аналитические данные.
                                                                    Возможные значения:
                                                                      ЕЖЕДНЕВНО
                                                                      По умолчанию: ЕЖЕДНЕВНО .
                                                                      ЕЖЕДНЕВНО
                                                                      <METRIC_TYPES>
                                                                      Массив строк
                                                                      Необходимый.
                                                                      Набор метрик, которые вы хотели бы получать.
                                                                      Возможные значения:
                                                                        ОТПРАВЛЕНО — Количество сообщений, отправленных компанией в группу.ДОСТАВЛЕНО — Количество раз, когда сообщение было доставлено участнику группы.ЧИТАНО — Количество прочтений сообщения участником группы.PARTICIPANTS_JOINED — Количество раз, когда участник присоединялся к группе.PARTICIPANTS_LEFT — Количество раз, когда участник покидал группу.
                                                                        ["ОТПРАВЛЕНО","ПРОЧИТАНО","ПРИСОЕДИНЯЮЩИЕСЯ УЧАСТНИКИ"]
                                                                        Пример запроса
                                                                        curl -g 'https://graph.facebook.com/v25.0/102290129340398/group_analytics?start=1764662400&end=1764921600&granularity=DAILY&group_ids=['GROUP_ID']&metric_types=['SENT','DELIVERED', 'READ','PARTICIPANTS_JOINED','PARTICIPANTS_LEFT']' \ -H 'Авторизация: Bearer EAAJB...'

                                                                        Пример ответа
                                                                        Обратите внимание, что приведенный ниже пример для краткости сокращен многоточием ( ... ).
                                                                        { "данные": [ { "гранулярность": "ежедневно", "точки данных": [ { "идентификатор группы": "идентификатор группы", "начало": 1685548801, "конец": 1685635200, "отправлено": 100, "доставлено": 250, "прочитано": 200, "присоединилось": 3, "слева": 1 }, { "идентификатор группы": "идентификатор группы", "начало": 1685635201, "конец": 1685721600, "отправлено": 80, "доставлено": 200, "прочитано": 150, "присоединилось": 1, "слева": 0 }, ... ] } ], "пагинация": { "курсоры": { "до": "MAZDZD", "после": "MjQZD" } } }
                                                                        Ссылка
                                                                        Список всех возможных значений для каждого поля см. в справочнике Graph API для поля «Аналитика бизнес-аккаунта WhatsApp» .
                                                                        
    
                                                                                
                                                                        
        
                                                                        
    
                                                                        
        
                                                                        
            
                                                                        
                
                
                                                                        
                    
                    
                
                                                                        
            
                                                                        
            
            
                                                                        
                                            
                                                                        
        
                                                                        
    
                                                                        

    

                                                                        
    
                                                                        

    
            
                                                                        
            
                                                                        

    
                                                                        
        
                                                                        
            
             
         
                                                                        
            
                                                                        

    
                                                                        
        
                                                                        
                    
                                                                        

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

            
                                                                        

    

    

                                                                                    
                                                                        
        
                                                                        
                
                                                                        
        
                                                                        
    
                                                                        

    
                                                                        

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