Skip to main content
GET
Beta. Consulta la Visión general de las automatizaciones para ver la descripción completa de la funcionalidad.
Devuelve todos los intentos de envío de una automatización, del más reciente al más antiguo. Cada fila registra el destinatario, el disparador coincidente, el resultado de cada acción y cualquier error. Se devuelven las filas de los últimos 30 días. Las filas más antiguas existen en Firestore (la retención es indefinida para analíticas) pero se excluyen de este endpoint por rendimiento.

Estado de la fila de actividad

Cada fila tiene un status de nivel superior más un status por acción dentro de actionResults[]. pending e in_flight son transitorios; todo lo demás es terminal. Cuando una automatización tiene más de una acción, el status de nivel superior se deriva de los resultados por acción en este orden: auth_error si alguna acción tuvo un error de autenticación, luego sent si alguna acción fue aceptada, luego deduplicated si todas las acciones fueron desduplicadas, luego skipped si todas las acciones fueron suprimidas deliberadamente (skipped o deduplicated), en caso contrario failed. Consulta actionResults[] para el detalle por acción.
sent confirma que Meta aceptó el mensaje, no que el destinatario lo haya recibido. Esto aplica a los DMs de Instagram y a los DMs de Messenger desde una página de Facebook: la automatización solo registra la aceptación y no hace seguimiento de la entrega. Instagram no expone ninguna señal de entrega en ninguna superficie de la API, y si la configuración de Message requests del destinatario bloquea a los desconocidos, Meta acepta el envío y lo descarta silenciosamente. Consulta DM de automatización enviado pero no entregado.

Campos de resultado por acción

Cada entrada en actionResults[] describe el resultado de una acción:

Qué contiene sent

Los valores de texto largos se recortan a 4.000 caracteres, y truncated se establece cuando eso ocurre. Los valores almacenados bajo nombres de clave que parecen credenciales, como token, secret, password o apiKey, se registran como "[redacted]". El messageUrl de una acción send_dm también se registra siempre como "[redacted]", porque una URL puede llevar un secreto en su ruta o en su query string. Para automatizaciones activadas por comentarios (comment_keyword), la fila también lleva un commentId de nivel superior — el ID de comentario de Instagram sin procesar al que se ancló el DM. Es null para disparadores basados en mensajes (dm_keyword, story_reply, dm_reaction). Las filas también llevan postId (la publicación en la que se dejó un comentario de comment_keyword) y storyId (la historia para story_reply y story_comment). Cada uno es null para los otros disparadores, y está ausente en las filas escritas antes de que se añadieran estos campos.

Parámetros de encabezado

Parámetros de ruta

string
requerido
El ID de la automatización devuelto por POST /automations.

Parámetros de consulta

number
predeterminado:25
Tamaño de página. Predeterminado 25, máximo 100. Los valores fuera de [1, 100] se ajustan al rango; los valores no enteros o ≤0 devuelven HTTP 400.
string
Cursor opaco proveniente del meta.pagination.next de una respuesta anterior. Omítelo en la primera solicitud.Solo hacia adelante — pasar ?previous= devuelve HTTP 400.

Forma de la respuesta

La respuesta envuelve la lista de resultados en activity[] y la información del cursor en meta.pagination:
meta.pagination.next es un blob opaco codificado en base64 — trátalo como una caja negra y pásalo sin modificar en el ?next= de la siguiente solicitud. meta.pagination.hasMore es true cuando existe al menos una página más.