WhatsApp Analytics

Las analíticas de WhatsApp le permiten recuperar métricas detalladas de los números de teléfono de empresa y las plantillas asociadas a su WABA. Algunos ejemplos son el número y el tipo de mensajes enviados, el número de veces que se ha leído una plantilla determinada y el número de veces que se ha hecho clic en un botón de una plantilla.

Análisis de mensajería

El análisis de mensajes proporciona el número y el tipo de mensajes enviados y entregados por los números de teléfono asociados a un WABA concreto.

Ejemplo de solicitud

Para recuperar los análisis de mensajería, envíe una solicitud GET al siguiente punto final, sustituyendo waba_id con el ID de la cuenta de WhatsApp Business de la que deseas obtener los datos analíticos de mensajería:

https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/:waba_id/messaging-analytics

Los datos se devuelven con una granularidad de media hora, diaria o mensual en la zona horaria UTC, con una retrospectiva de hasta 90 días. Debe incluir los parámetros de inicio, fin y granularidad en su solicitud, y hay algunos parámetros opcionales que puede utilizar para filtrar aún más los datos:

Nombre Tipo Requerido Notas
start cadena(timestamp) Sí El formato de fecha y hora de inicio de los datos analíticos que se van a recuperar, en el formato YYYY-MM-DD.
end cadena(timestamp) Sí El formato de fecha y hora de finalización de los datos analíticos que se van a recuperar, en el formato YYYY-MM-DD.
granularity cadena Sí Granularidad de los datos analíticos que deben recuperarse. Se admiten: MEDIA HORA, DIARIO, MENSUAL
phone_number matriz No Numbers téléphoniques pour lesquels vous souhaitez obtenir des analyse. Si está vacío, se incluyen todos los números de teléfono asociados a WABA.
product_types matriz No Una matriz con los tipos de mensajes para los que se desean obtener datos analíticos. Los valores posibles son: 0 para mensajes de notificación y/o 2 para los mensajes de atención al cliente. Si no se especifica, se devolverán análisis para todos los tipos de mensajes.
country_codes matriz No Códigos de país de dos letras para los países de los que desea obtener datos analíticos. Si no se especifica, se mostrarán los análisis de todos los países.

Encontrará un ejemplo de código completo en Recuperar análisis de mensajería fragmento de código.

Ejemplo de respuesta

{
   "id": "345688589250625",
   "granularity": "HALF_HOUR",
   "phone_numbers": [
      "16505550111"
   ],
   "country_codes": [
      "US"
   ],
   "_embedded": {
      "messaging_analytics": [
         {
            "start": "1543543200",
            "end": "1543629600",
            "sent": 100,
            "delivered": 90
         }
      ]
   },
   "paging": {
      "cursors": {
         "before": "MAZDZD",
         "after": "MjQZD"
      },
      "next": "https://api.nexmo.com/v2/channel-manager/wabas/106499765517625/messaging-analytics?after=MAZDZD",
      "previous": "https://api.nexmo.com/v2/channel-manager/wabas/106499765517625/messaging-analytics?before=MjQZD"
   }
}

Análisis de plantillas

Los análisis de plantillas describen el número de veces que se ha enviado, entregado y leído una plantilla, así como el número de veces que se ha hecho clic en los botones URL o de respuesta rápida de la plantilla; los análisis de clics en botones sólo están disponibles para las plantillas clasificadas como MARKETING o UTILITY.

Los datos se facilitan con una periodicidad diaria en la zona horaria UTC, con un historial de hasta 90 días.

Nota: Debe confirmar el análisis de plantillas en su cuenta de empresa antes de poder recuperar el análisis de plantillas. Consulte la Documentación de WhatsApp para más información.

Ejemplo de solicitud de carga útil

https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/794579786527563/template-analytics?template_ids=['1441569584015671','2266692337158554']&start=2026-01-11&end=2026-01-21&metric_types=['DELIVERED']

Ejemplo de respuesta

{
    "page_size": 100,
    "_embedded": {
        "template_analytics": [
            {
                "template_id": "1441569584015671",
                "start": "2026-01-11T00:00:00Z",
                "end": "2026-01-12T00:00:00Z",
                "delivered": 0
            },
            {
                "template_id": "1441569584015671",
                "start": "2026-01-12T00:00:00Z",
                "end": "2026-01-13T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "1441569584015671",
                "start": "2026-01-13T00:00:00Z",
                "end": "2026-01-14T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "1441569584015671",
                "start": "2026-01-14T00:00:00Z",
                "end": "2026-01-15T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "1441569584015671",
                "start": "2026-01-15T00:00:00Z",
                "end": "2026-01-16T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "1441569584015671",
                "start": "2026-01-16T00:00:00Z",
                "end": "2026-01-17T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "1441569584015671",
                "start": "2026-01-17T00:00:00Z",
                "end": "2026-01-18T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "1441569584015671",
                "start": "2026-01-18T00:00:00Z",
                "end": "2026-01-19T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "1441569584015671",
                "start": "2026-01-19T00:00:00Z",
                "end": "2026-01-20T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "1441569584015671",
                "start": "2026-01-20T00:00:00Z",
                "end": "2026-01-21T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-11T00:00:00Z",
                "end": "2026-01-12T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-12T00:00:00Z",
                "end": "2026-01-13T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-13T00:00:00Z",
                "end": "2026-01-14T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-14T00:00:00Z",
                "end": "2026-01-15T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-15T00:00:00Z",
                "end": "2026-01-16T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-16T00:00:00Z",
                "end": "2026-01-17T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-17T00:00:00Z",
                "end": "2026-01-18T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-18T00:00:00Z",
                "end": "2026-01-19T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-19T00:00:00Z",
                "end": "2026-01-20T00:00:00Z",
                "delivered": "0"
            },
            {
                "template_id": "2266692337158554",
                "start": "2026-01-20T00:00:00Z",
                "end": "2026-01-21T00:00:00Z",
                "delivered": "0"
            }
        ]
    },
    "granularity": "DAILY",
    "product_type": "cloud_api",
    "_links": {
        "self": {
            "href": "https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/794579786527563/template-analytics?template_ids=[1441569584015671,2266692337158554]&start=2026-01-11&end=2026-01-21&metric_types=[DELIVERED]&page_size=100&cursor=c2VsZj1udWxs"
        }
    }
}

Activar el análisis de plantillas

Antes de poder consultar las estadísticas de las plantillas de tu cuenta de WhatsApp Business (WABA), debes habilitar la recopilación de datos de «Insights» a nivel de la WABA. «Insights» son datos analíticos relacionados con los mensajes, los precios o las plantillas, incluido el seguimiento de los clics en los botones o enlaces de las plantillas. Se trata de un paso de configuración que solo hay que realizar una vez por cada WABA.

Importante: Habilitar insights dirige a Meta a recopilar y anonimizar datos de tus chats con clientes. Meta utiliza estos datos anonimizados para mejorar los servicios de WhatsApp. Una vez habilitado, el análisis de plantillas no se puede deshabilitar para todo el WABA. La habilitación se realiza una vez por ID de WABA (no por plantilla o número de teléfono).

Enabling insights permite a Meta:

  • Recopila datos de chat anónimos de tu WABA
  • Generar informes de plantillas que muestren las métricas de entrega, lectura y clics
  • Facilita estos datos a través de la API de Template Analytics

Activa Insights para tu WABA

Punto final: [PARCHE] /v1/channel-manager/whatsapp/wabas/{waba_id}/enable_insights

Utilice el mismo método de autenticación que otros puntos finales de Channel Manager. La clave API debe estar vinculada al ID de WABA.

Códigos de respuesta:

Código Descripción
200 Solicitud realizada con éxito: las estadísticas se han activado correctamente
403 No autorizado: la clave API no está vinculada a este ID de WABA
404 Recurso no encontrado: el ID de WABA no es válido

Una vez activadas las estadísticas, espera unos minutos a que el cambio surta efecto. A continuación, podrás empezar a recuperar los datos analíticos de las plantillas.

Ejemplo de solicitud

Para recuperar los análisis de plantillas, envíe una solicitud GET al siguiente punto final, sustituyendo waba_id con el ID del Account de WhatsApp Business de la que deseas obtener los datos analíticos de las plantillas:

https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/:waba_id/template-analytics

Los parámetros de consulta que se detallan a continuación pueden utilizarse para filtrar los resultados:

Nombre Tipo Requerido Notas
start cadena(timestamp) Sí El formato de fecha y hora de inicio de los datos analíticos que se van a recuperar, en el formato YYYY-MM-DD.
end cadena(timestamp) Sí La fecha y hora finales a las que se recuperarán los datos analíticos, en el formato YYYY-MM-DD. La diferencia máxima entre las fechas de inicio y fin es de 90 días.
granularity cadena Sí Debe ser DIARIO.
template_ids matriz Sí Una matriz de template_ids de las plantillas de las que se desea obtener datos analíticos. Máximo 10.
metric_types matriz No Una matriz de los tipos de métricas para los que recuperar los análisis. Los valores posibles son SENT, DELIVERED, READy CLICKED. Puede obtener más información sobre el significado de cada tipo en la documentación de WhatsApp. Si está vacío, se devolverán los análisis de todos los tipos de métricas.

Ejemplo de respuesta

{
   "granularity": "DAILY",
   "product_type": "cloud_api",
   "page_size": 100,
   "_embedded": {
      "template_analytics": [
         {
            "template_id": "458951126288942",
            "start": "2024-11-11T00:00:00Z",
            "end": "2024-11-11T00:00:00Z",
            "sent": 100,
            "delivered": 90,
            "read": 80,
            "clicked": 70
         }
      ]
   },
   "_links": {
      "self": {
         "href": "https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/345688589250625/template-analytics?template_ids=[458951126288937]&start=2024-11-10&end=2024-11-14&page_size=100&cursor=c2VsZj1udWxs"
      }
   }
}

Análisis de precios

El análisis de precios te permite consultar desgloses de precios e información sobre las categorías de tarifas de cualquier mensaje enviado dentro de un intervalo de fechas determinado.

Ejemplo de solicitud

Para recuperar los análisis de precios, envíe una solicitud GET al siguiente punto final, sustituyendo waba_id con el ID del Account de WhatsApp Business de la que deseas obtener los datos analíticos de las plantillas:

https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/:waba_id/pricing-analytics

Los parámetros de consulta que se detallan a continuación pueden utilizarse para filtrar los resultados:

Nombre Tipo Requerido Notas
start cadena(timestamp) No La fecha y hora de inicio de los datos analíticos que se van a recuperar, en el formato YYYY-MM-DD.
end cadena(timestamp) No La fecha y hora finales a las que se recuperarán los datos analíticos, en el formato YYYY-MM-DD.
granularity cadena No Debe de ser uno de HALF_HOUR, DAILY, o MONTHLY.
phone_numbers matriz No Numbers de teléfono de los que desea obtener datos analíticos. Si no se especifica, se devolverán los análisis de todos los números de teléfono asociados al WABA. Ejemplo: [ "16505550111" ]
country_codes matriz No Códigos de país de dos letras correspondientes a los países para los que deseas obtener datos analíticos. Si no se especifican, se mostrarán los datos analíticos de todos los países. Ejemplo: [ "US" ]
dimensions matriz No Lista de desgloses que deseas aplicar a tus métricas. Si está vacía, se mostrarán todos los resultados sin ningún desglose. Puede incluir PRICING_CATEGORY, PRICING_TYPE, COUNTRY, PHONEy TIER.
tier matriz No El valor de la propiedad tier representa una concatenación de los límites inferior y superior para el tier específico del par mercado-categoría (país y pricing_category). Ejemplo: [ "0:100000" ]

Ejemplo de respuesta

{
   "granularity": "DAILY",
   "product_type": "cloud_api",
   "_embedded": {
      "pricing_analytics": [
         {
            "start": "2024-11-11T00:00:00Z",
            "end": "2024-11-11T00:00:00Z",
            "volume": 100,
            "phone_number": "14155552671",
            "country": "US",
            "tier": "75000:150000",
            "pricing_type": "REGULAR",
            "pricing_category": "AUTHENTICATION"
         }
      ]
   },
   "paging": {
      "cursors": {
         "before": "MjQZD",
         "after": "MAZDZD"
      },
      "previous": "https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/345688589250625/pricing-analytics?before=MjQZD",
      "next": "https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/345688589250625/pricing-analytics?before=MAZDZD"
   }
}

Ejemplo de solicitud con parámetros de consulta

https://api.nexmo.com/v1/channel-manager/whatsapp/wabas/waba111/pricing-analytics?start=2026-01-25T15:07:24.850718Z&end=2026-02-14T15:07:24.850838Z&granularity=DAILY&country_codes=['IN','US']&dimensions=['PRICING_CATEGORY', 'PRICING_TYPE', 'COUNTRY', 'PHONE', 'TIER']&phone_numbers=16505550111,16505550112,16505550113&pricing_categories=['Utility']&pricing_types=['REGULAR']

Ejemplo de respuesta con parámetros de consulta

{
  "id": "345688589250625",
  "granularity": "DAILY",
  "product_type": "cloud_api",
  "_embedded": {
    "pricing_analytics": [
      {
        "start": "2025-06-06T07:00:00Z",
        "end": "2025-06-07T07:00:00Z",
        "country": "IN",
        "pricing_type": "FREE_CUSTOMER_SERVICE",
        "pricing_category": "SERVICE",
        "volume": 2
      },
      {
        "start": "2025-06-05T07:00:00Z",
        "end": "2025-06-06T07:00:00Z",
        "country": "IN",
        "pricing_type": "REGULAR",
        "pricing_category": "AUTHENTICATION_INTERNATIONAL",
        "volume": 2,
        "tier": "0:750000"
      },
      {
        "start": "2025-06-05T07:00:00Z",
        "end": "2025-06-06T07:00:00Z",
        "country": "IN",
        "pricing_type": "FREE_CUSTOMER_SERVICE",
        "pricing_category": "SERVICE",
        "volume": 2
      },
      {
        "start": "2025-06-03T07:00:00Z",
        "end": "2025-06-04T07:00:00Z",
        "country": "US",
        "pricing_type": "REGULAR",
        "pricing_category": "MARKETING",
        "volume": 1,
        "tier": "0:MAX"
      },
      {
        "start": "2025-06-02T07:00:00Z",
        "end": "2025-06-03T07:00:00Z",
        "country": "US",
        "pricing_type": "FREE_CUSTOMER_SERVICE",
        "pricing_category": "SERVICE",
        "volume": 1
      },
      {
        "start": "2025-06-02T07:00:00Z",
        "end": "2025-06-03T07:00:00Z",
        "country": "US",
        "pricing_type": "FREE_ENTRY_POINT",
        "pricing_category": "SERVICE",
        "volume": 6
      },
      {
        "start": "2025-06-02T07:00:00Z",
        "end": "2025-06-03T07:00:00Z",
        "country": "US",
        "pricing_type": "REGULAR",
        "pricing_category": "AUTHENTICATION",
        "volume": 1,
        "tier": "0:2"
      },
      {
        "start": "2025-06-02T07:00:00Z",
        "end": "2025-06-03T07:00:00Z",
        "country": "IN",
        "pricing_type": "REGULAR",
        "pricing_category": "AUTHENTICATION_INTERNATIONAL",
        "volume": 1,
        "tier": "0:750000"
      },
      {
        "start": "2025-06-01T07:00:00Z",
        "end": "2025-06-02T07:00:00Z",
        "country": "US",
        "pricing_type": "FREE_CUSTOMER_SERVICE",
        "pricing_category": "SERVICE",
        "volume": 2
      },
      {
        "start": "2025-06-01T07:00:00Z",
        "end": "2025-06-02T07:00:00Z",
        "country": "US",
        "pricing_type": "REGULAR",
        "pricing_category": "AUTHENTICATION",
        "volume": 1,
        "tier": "0:2"
      },
      {
        "start": "2025-06-01T07:00:00Z",
        "end": "2025-06-02T07:00:00Z",
        "country": "US",
        "pricing_type": "FREE_CUSTOMER_SERVICE",
        "pricing_category": "UTILITY",
        "volume": 1
      },
      {
        "start": "2025-06-01T07:00:00Z",
        "end": "2025-06-02T07:00:00Z",
        "country": "US",
        "pricing_type": "REGULAR",
        "pricing_category": "UTILITY",
        "volume": 1,
        "tier": "0:2"
      },
      {
        "start": "2025-06-01T07:00:00Z",
        "end": "2025-06-02T07:00:00Z",
        "country": "US",
        "pricing_type": "REGULAR",
        "pricing_category": "MARKETING",
        "volume": 4,
        "tier": "0:MAX"
      },
      {
        "start": "2025-06-01T07:00:00Z",
        "end": "2025-06-02T07:00:00Z",
        "country": "US",
        "pricing_type": "REGULAR",
        "pricing_category": "MARKETING_LITE",
        "volume": 1,
        "tier": "0:MAX"
      }
    ]
  }
}

Lecturas complementarias