Referencia de la API de insights de mensajes

La API de insights de mensajes te permite recuperar mediante programación la misma información que aparece en la pestaña “Insights de la página” de tu página de Facebook.

Para obtener más información sobre esta API y otros análisis disponibles en la plataforma de Messenger, consulta la sección Análisis.

Si quieres obtener más información acerca de la API de insights de página, incluida la relacionada con otras métricas disponibles y los permisos necesarios, consulta los documentos sobre las insights de páginas o la referencia de objeto de las insights.

Permisos

Se necesita un identificador de acceso a la página con el permiso read_insights para interactuar con este extremo.

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. Pueden ser `messaging_channel` (Messenger o Instagram), `recurring_notification_topic` o `recurring_notifications_freuency`.
`date_preset`	Intervalo de fechas relacionado que se puede utilizar en lugar de `since` y `until`. Puede ser `last_week`, `last_month`, `last_quarter`y otras opciones.
`metric`	Lista de métricas separadas por comas que se devuelven.
`period`	La agregación proporcionada en el intervalo since/until o date_preset. El valor de `total_over_range` da un solo valor a la métrica en el intervalo de fechas establecido. Puede ser `day`, `week`, `month`, `days_28` o `total_over_range`.
`since`	Marca de tiempo UNIX de la hora de inicio de la que se quiere obtener la métrica.
`until`	Marca de tiempo UNIX de la hora de finalización de la que se quiere obtener la métrica.

Resultados disponibles

Las siguientes métricas están disponibles mediante la API de insights de mensajes:

Nombre de la `metric`	Descripción
`recurring_notification_tokens`	Número de veces que una cuenta se ha suscrito para recibir mensajes de marketing de tu negocio. Si una cuenta se ha suscrito a varios temas, se contará una vez por tema. Se calcula de la siguiente forma: la métrica hace un recuento del número de veces que las cuentas han aceptado recibir mensajes recurrentes menos el número de veces que las cuentas han anulado la suscripción. Valores posibles de `breakdowns`: `messaging_channel` `recurring_notifications_frequency` `recurring_notifications_topic` Esta métrica se encuentra en desarrollo.
`page_messages_engagement`	Número de veces que los usuarios han interactuado con mensajes en la página de tu negocio tocando un botón de llamada a la acción. Esta métrica solo incluye los datos correspondientes a los mensajes de marketing. Valores posibles de `breakdowns`: `messaging_channel` `recurring_notifications_topic` Esta métrica se encuentra en desarrollo.
`page_messages_sent`	Número de mensajes que la página de tu negocio ha enviado a un cliente. Esta métrica solo incluye los datos correspondientes a los mensajes de marketing. Valores posibles de `breakdowns`: `messaging_channel` `recurring_notifications_topic` Esta métrica se encuentra en desarrollo.
`page_messages_read_ratio`	Número de mensajes leídos dividido entre el número de mensajes enviados por tu página. Puede que algunos mensajes leídos no figuren, por ejemplo, si un cliente ha desactivado las confirmaciones de lectura. Esta métrica solo incluye los datos correspondientes a los mensajes de marketing. Valores posibles de `breakdowns`: `messaging_channel` `recurring_notifications_topic` Esta métrica se encuentra en desarrollo.
`page_messages_order_count`	Número de veces que has creado un pedido en conversaciones con mensajes o en aplicaciones o sitios web de terceros utilizados para administrar dichas conversaciones. Esta métrica se encuentra en desarrollo.
`page_messages_paid_order_earnings`	La cantidad de dinero aproximada que has ganado con pedidos creados mediante conversaciones con mensajes o con aplicaciones o sitios web de terceros utilizados para administrar dichas conversaciones. Los ingresos finales pueden diferir debido a la conversión de divisas. Esta métrica se encuentra en desarrollo.
`page_messages_with_business_outcomes`	Número de conexiones de mensajes con al menos un pedido creado. Esta métrica se encuentra en desarrollo.
`page_messages_blocked_conversations_unique`	Número de conversaciones con la página que se han bloqueado.
`page_messages_new_conversations_unique`	Número de conversaciones con mensajes en Messenger iniciadas por usuarios que nunca antes habían intercambiado mensajes con la empresa.
`page_messages_reported_conversations_unique`	Número de conversaciones de la página que alguien haya denunciado por ser spam o mostrar contenido inapropiado, entre otros motivos.
`page_messages_total_messaging_connections`	Número de usuarios a los que tu empresa puede enviar mensajes. Esta métrica muestra el número de usuarios que alguna vez han enviado un mensaje a tu negocio en Messenger, sin incluir a los usuarios que han bloqueado o denunciado a tu empresa en Messenger. Puede haber algunas restricciones en tu capacidad para enviar mensajes a las conexiones, como en la cantidad de mensajes que puedes enviar durante ciertos intervalos de tiempo. Ten en cuenta que esta métrica solo incluye las conexiones realizadas a partir de octubre de 2016, momento en el que los datos empezaron a estar disponibles.

Propiedades de la respuesta

Propiedad	Descripción
`data` matriz de objetos	Lista de objetos de las métricas.
`name` cadena	Nombre de la métrica.
`period` Cadena	Periodo de tiempo durante el que se han recopilado datos.
`values` Matriz de objetos	Lista de datos correspondientes a una métrica.
`value` Matriz de objetos	Recuento de la métrica solicitada desglosada por día. En el caso de las métricas desglosadas por tipo, se devuelve un objeto que contiene los recuentos de cada tipo.
`end_time` Marca de tiempo 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 insights de mensajes, consulta la guía sobre el uso de la API de insights de mensajes.