Referencia de la API de estadísticas de mensajes

Con la API de estadísticas de mensajes, puedes recuperar de forma programática la misma información que aparece en la pestaña "Estadísticas de la página" de tu página de Facebook.

Para obtener más información sobre la API de estadísticas de mensajes y otros análisis disponibles en la plataforma de Messenger, consulta Analytics.

Para obtener más información sobre la API de estadísticas de la página, incluida información sobre otras métricas disponibles y los permisos necesarios, consulta la documentación sobre estadísticas de la página o la referencia de objetos de las estadísticas.

Permisos

Se requiere un token de acceso a la página con permiso read_insights para interactuar con este punto de conexión.

Ejemplo de solicitud

curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=

Ejemplo de respuesta

{ 
  "data": [ 
    { 
      "name": "

Parámetros

Parámetro	Descripción
`breakdowns`	Dimensiones por las que se agrupa la respuesta. Puede ser `messaging_channel` (Messenger o Instagram), `recurring_notification_topic` o `recurring_notifications_freuency`
`date_preset`	Intervalo de fechas relativo que se puede usar en lugar de `since` y `until`. Puede ser `last_week`, `last_month`, `last_quarter`, etc.
`metric`	La lista de métricas que deseas recibir, separadas por comas.
`period`	La agregación proporcionada dentro del intervalo since/until o date_preset. El valor `total_over_range` brinda un solo valor correspondiente a la métrica en el intervalo de fechas determinado. Puede ser `day`, `week`, `month`, `days_28` o `total_over_range`
`since`	Marca de tiempo UNIX correspondiente a la hora de inicio para obtener la métrica.
`until`	Marca de tiempo UNIX correspondiente a la hora de finalización para obtener la métrica.

Métricas disponibles

Las siguientes métricas están disponibles con la API de estadísticas de mensajes:

Nombre de `metric`	Descripción
`recurring_notification_tokens`	El número de veces que una cuenta se suscribió para recibir mensajes de marketing de tu empresa. Si una cuenta se suscribió a varios temas, se contará otra vez por cada tema. Cómo se calcula: esta métrica cuenta la cantidad de veces que la cuenta aceptó recibir mensajes recurrentes menos la cantidad de veces que las cuentas anularon la suscripción. Valores posibles de `breakdowns`: `messaging_channel` `recurring_notifications_frequency` `recurring_notifications_topic` Esta métrica está en desarrollo.
`page_messages_engagement`	La cantidad de veces que los usuarios interactuaron con mensajes en la página de tu negocio tocando un botón de llamada a la acción. Esta métrica solo incluye datos de los mensajes de marketing. Valores posibles de `breakdowns`: `messaging_channel` `recurring_notifications_topic` Esta métrica está en desarrollo.
`page_messages_sent`	El número de mensajes que la página de tu empresa envió a un cliente. Esta métrica solo incluye datos de los mensajes de marketing. Valores posibles de `breakdowns`: `messaging_channel` `recurring_notifications_topic` Esta métrica está en desarrollo.
`page_messages_read_ratio`	La cantidad de mensajes leídos dividida por la cantidad de mensajes enviados por tu página. Es posible que no se capturen algunas lecturas de mensajes, por ejemplo, cuando un cliente desactivó las confirmaciones de lectura. Esta métrica solo incluye datos de los mensajes de marketing. Valores posibles de `breakdowns`: `messaging_channel` `recurring_notifications_topic` Esta métrica está en desarrollo.
`page_messages_order_count`	La cantidad de veces que creaste un pedido en conversaciones con mensajes o en apps o sitios web de terceros que usas para administrar conversaciones con mensajes. Esta métrica está en desarrollo.
`page_messages_paid_order_earnings`	El importe de dinero aproximado que ganaste a partir de pedidos creados mediante conversaciones con mensajes o apps o sitios web de terceros que usas para administrar conversaciones con mensajes. Los ingresos finales pueden variar debido a las conversiones de divisas. Esta métrica está en desarrollo.
`page_messages_with_business_outcomes`	El número de conexiones de mensajes con al menos un pedido creado. Esta métrica está en desarrollo.
`page_messages_blocked_conversations_unique`	La cantidad de conversaciones con la página que se bloquearon.
`page_messages_new_conversations_unique`	La cantidad de conversaciones con mensajes en Messenger que comenzaron con personas que nunca habían enviado un mensaje a tu empresa.
`page_messages_reported_conversations_unique`	El número de conversaciones de tu página que las personas reportaron por considerarlas spam o de contenido inapropiado.
`page_messages_total_messaging_connections`	El número de personas a la que tu empresa puede enviar mensajes. Esta métrica muestra la cantidad de personas que enviaron un mensaje a tu empresa en Messenger, pero no incluye a las personas que bloquearon o reportaron a tu empresa en Messenger. Puede haber algunas limitaciones en tu capacidad para enviar mensajes a conexiones, como limitaciones sobre la cantidad de mensajes que puedes enviar durante ciertos plazos. Además, esta métrica solo incluye conexiones realizadas desde octubre de 2016, cuando los datos comenzaron a estar disponibles.

Propiedades de la respuesta

Propiedad	Descripción
`data` matriz de objetos	Una lista de objetos de la métrica.
`name` cadena	El nombre de la métrica.
`period` cadena	El período durante el cual se recopilaron los datos.
`values` matriz de objetos	Una lista de datos de una métrica.
`value` matriz de objetos	El recuento de la métrica solicitada por día. En el caso de las métricas que se desglosan por tipo, se devolverá un objeto que contenga recuentos correspondientes a cada tipo.
`end_time` marca de tiempo de unix	Marca de tiempo UTC de la hora de finalización de la métrica.

Más información

Para obtener más información sobre el uso de la API de estadísticas de mensajes, consulta la Guía de uso de la API de estadísticas de mensajes.