Skip to main content
GET
Rufen Sie Nachrichten oder Konversationen für eine Messaging-Plattform ab. Die Abrufzeiten unterscheiden sich je nach sozialem Netzwerk. Auf Facebook, Instagram und WhatsApp sind Nachrichten über Ayrshare in Echtzeit verfügbar. Auf X/Twitter gibt es eine Verzögerung von bis zu 3 Minuten, bis neue Nachrichten-Updates sichtbar sind. Bitte wenden Sie sich an den Support, um mehr über den Enterprise Plan zu erfahren, wenn Sie Echtzeitzugriff auf X/Twitter-Nachrichten benötigen.
Response-Caching: Für Facebook und Instagram werden Antworten 60 Sekunden lang zwischengespeichert. Für X/Twitter werden Antworten 15 Sekunden lang zwischengespeichert, um Polling besser zu unterstützen. WhatsApp liest Nachrichten, die bereits über Meta-Webhooks empfangen wurden, sodass eine neu empfangene Nachricht erscheinen kann, sobald Ayrshare den Webhook verarbeitet hat. Die Antwort enthält weiterhin die Metadaten lastUpdated und nextUpdate.
Der initiale Abruf des Nachrichtenverlaufs für Facebook und Instagram ist auf die letzten 20 Nachrichten beschränkt. Weitere Informationen finden Sie im Abschnitt Abruf des Nachrichtenverlaufs für Facebook und Instagram.
WhatsApp-Konversationen werden anhand der Telefonnummer des Korrespondenten identifiziert (nur Ziffern, E.164 ohne führendes +). Eine gespeicherte ausgehende Nachricht kann einen status-Wert von sent, delivered, read oder failed enthalten.
WhatsApp-Nachrichten, die über Send Message gesendet werden, werden derzeit nicht dem Get-Messages-Verlauf hinzugefügt. Eingehende WhatsApp-Nachrichten, die über Webhooks empfangen werden, werden gespeichert und hier zurückgegeben.

Header-Parameter

Pfad-Parameter

string
erforderlich
Die Plattform, für die die Nachricht abgerufen werden soll: facebook, instagram, twitter, whatsapp

Query-Parameter

string
Standard:"active"
erforderlich
Gibt aktive oder archivierte Konversationen zurück. Werte: active oder archived.
string
Gibt nur die angegebene Konversation zurück.
boolean
Standard:false
Gibt alle Konversationen zurück. Wenn true, wird das Feld conversationId ignoriert.
Wenn conversationsOnly=true, werden die Konversationsdetails in converstationsDetails zurückgegeben. Diese Schreibweise ist Teil der aktuellen API-Antwort.
integer
Nur X/Twitter. Begrenzt die Anzahl der pro Anfrage zurückgegebenen Nachrichten (1–100). Ermöglicht effizientes Polling ohne vollständigen Verlaufsabgleich. Verwenden Sie dies zusammen mit next für die Paginierung. Wenn weggelassen, wird das Standardverhalten (vollständiger Nachrichtenabruf) verwendet.
string
Nur X/Twitter. Verschlüsselter Paginierungs-Cursor, der aus dem Feld meta.pagination.next einer vorherigen Anfrage zurückgegeben wird. Verwenden Sie ihn zusammen mit limit, um die nächste Ergebnisseite abzurufen.