Skip to main content
GET
Bêta. Voir la Vue d’ensemble des automatisations pour la description complète de la fonctionnalité.
Renvoie chaque tentative d’envoi pour une automatisation, la plus récente en premier. Chaque ligne enregistre le destinataire, le déclencheur correspondant, le résultat de chaque action et toute erreur. Les lignes des 30 derniers jours sont retournées. Les lignes plus anciennes existent dans Firestore (la rétention est indéfinie pour l’analyse) mais sont exclues de ce point de terminaison pour des raisons de performance.

Statut des lignes d’activité

Chaque ligne a un status de premier niveau plus un status par action à l’intérieur d’actionResults[]. pending et in_flight sont transitoires ; tout le reste est terminal. Lorsqu’une automatisation comporte plus d’une action, le status de premier niveau est dérivé des résultats par action dans cet ordre : auth_error si une action a rencontré une erreur d’auth, puis sent si une action a été acceptée, puis deduplicated si chaque action a été dédupliquée, puis skipped si chaque action a été délibérément supprimée (skipped ou deduplicated), sinon failed. Consultez actionResults[] pour le détail par action.
sent confirme que Meta a accepté le message, pas que le destinataire l’a reçu. C’est vrai pour les DM Instagram comme pour les DM Messenger envoyés depuis une Page Facebook : l’automatisation enregistre uniquement l’acceptation et ne suit pas la livraison. Instagram n’expose aucun signal de livraison sur aucune surface d’API, et si le paramètre Message requests du destinataire bloque les inconnus, Meta accepte l’envoi et le supprime silencieusement. Voir Automation DM Sent but Not Delivered.

Champs de résultat par action

Chaque entrée d’actionResults[] décrit le résultat d’une action :

Ce que contient sent

Les longues valeurs texte sont tronquées à 4 000 caractères, et truncated est défini lorsque cela se produit. Les valeurs stockées sous des noms de clé qui ressemblent à des identifiants, tels que token, secret, password ou apiKey, sont enregistrées comme "[redacted]". Le messageUrl d’une action send_dm est lui aussi toujours enregistré comme "[redacted]", car une URL peut contenir un secret dans son chemin ou sa chaîne de requête. Pour les automatisations déclenchées par un commentaire (comment_keyword), la ligne porte également un commentId de premier niveau — l’ID brut du commentaire Instagram sur lequel le DM était ancré. Il est null pour les déclencheurs pilotés par message (dm_keyword, story_reply, dm_reaction). Les lignes portent également postId (la publication sur laquelle un commentaire comment_keyword a été laissé) et storyId (la story pour story_reply et story_comment). Chacun vaut null pour les autres déclencheurs, et est absent des lignes écrites avant l’ajout de ces champs.

Paramètres d’en-tête

Paramètres de chemin

string
requis
L’ID d’automatisation retourné par POST /automations.

Paramètres de requête

number
défaut:25
Taille de page. Par défaut 25, max 100. Les valeurs en dehors de [1, 100] sont ramenées à cette plage ; les valeurs non entières ou ≤0 retournent HTTP 400.
string
Curseur opaque provenant de meta.pagination.next d’une réponse précédente. Omettez-le à la première requête.Vers l’avant uniquement — passer ?previous= renvoie HTTP 400.

Forme de la réponse

La réponse enveloppe la liste de résultats dans activity[] et les infos du curseur dans meta.pagination :
meta.pagination.next est un blob opaque encodé en base64 — traitez-le comme une boîte noire et repassez-le tel quel dans le ?next= de la requête suivante. meta.pagination.hasMore vaut true lorsqu’au moins une page supplémentaire existe.