Skip to main content
GET
Beta. Die vollständige Funktionsbeschreibung finden Sie in der Automations-Übersicht.
Gibt jeden Versendungsversuch einer Automatisierung zurück, neueste zuerst. Jede Zeile enthält den Empfänger, den passenden Trigger, das Ergebnis jeder Aktion und etwaige Fehler. Es werden Zeilen der letzten 30 Tage zurückgegeben. Ältere Zeilen existieren in Firestore (die Aufbewahrung ist für Analytics unbegrenzt), werden aus Performance-Gründen von diesem Endpunkt aber ausgeschlossen.

Status der Activity-Zeile

Jede Zeile hat einen status auf oberster Ebene sowie einen status pro Aktion innerhalb von actionResults[]. pending und in_flight sind temporär; alles andere ist terminal. Wenn eine Automatisierung mehr als eine Aktion hat, wird der status auf oberster Ebene in dieser Reihenfolge aus den Ergebnissen pro Aktion abgeleitet: auth_error, wenn eine Aktion einen Auth-Fehler ausgelöst hat, dann sent, wenn eine Aktion akzeptiert wurde, dann deduplicated, wenn jede Aktion dedupliziert wurde, dann skipped, wenn jede Aktion bewusst unterdrückt wurde (skipped oder deduplicated), andernfalls failed. Lesen Sie actionResults[] für die Details pro Aktion.
sent bestätigt, dass Meta die Nachricht akzeptiert hat, nicht dass der Empfänger sie erhalten hat. Das gilt für Instagram-DMs und für Messenger-DMs von einer Facebook-Seite: Die Automatisierung erfasst nur die Annahme und verfolgt die Zustellung nicht. Instagram stellt auf keiner API-Oberfläche ein Zustellsignal bereit, und wenn die Message requests-Einstellung des Empfängers Fremde blockiert, akzeptiert Meta den Versand und verwirft ihn stillschweigend. Siehe Automation-DM gesendet, aber nicht zugestellt.

Ergebnisfelder pro Aktion

Jeder Eintrag in actionResults[] beschreibt das Ergebnis einer Aktion:

Was sent enthält

Lange Textwerte werden auf 4.000 Zeichen gekürzt, und in diesem Fall wird truncated gesetzt. Werte, die unter Schlüsselnamen gespeichert sind, die wie Zugangsdaten aussehen, etwa token, secret, password oder apiKey, werden als "[redacted]" erfasst. Die messageUrl einer send_dm-Aktion wird ebenfalls immer als "[redacted]" erfasst, da eine URL in ihrem Pfad oder Query-String ein Geheimnis enthalten kann. Bei kommentar-getriggerten Automatisierungen (comment_keyword) trägt die Zeile zusätzlich ein commentId auf oberster Ebene – die rohe Instagram-Kommentar-ID, an die die DM angehängt wurde. Bei nachrichten-getriebenen Triggern (dm_keyword, story_reply, dm_reaction) ist sie null. Zeilen tragen außerdem ein postId (der Beitrag, auf dem ein comment_keyword-Kommentar hinterlassen wurde) und ein storyId (die Story bei story_reply und story_comment). Jedes der beiden Felder ist bei den anderen Triggern null und fehlt in Zeilen, die geschrieben wurden, bevor diese Felder hinzugefügt wurden.

Header-Parameter

Pfad-Parameter

string
erforderlich
Die Automatisierungs-ID, die von POST /automations zurückgegeben wurde.

Query-Parameter

number
Standard:25
Seitengröße. Standard 25, Maximum 100. Werte außerhalb von [1, 100] werden gekappt; Nicht-Ganzzahlen oder ≤0 liefern HTTP 400.
string
Opaker Cursor aus dem meta.pagination.next einer vorhergehenden Antwort. Bei der ersten Anfrage weglassen.Nur vorwärts – die Übergabe von ?previous= liefert HTTP 400.

Antwortformat

Die Antwort verpackt die Ergebnisliste in activity[] und die Cursor-Informationen in meta.pagination:
meta.pagination.next ist ein base64-kodierter, opaker Blob – behandeln Sie ihn als Black Box und übergeben Sie ihn in der nächsten Anfrage unverändert im ?next=. meta.pagination.hasMore ist true, wenn mindestens eine weitere Seite existiert.