Konversationen auflisten
Alle Konversationen des authentifizierten Benutzers mit Filterung und Cursor-Paginierung auflisten
GET
Dieser Endpunkt gibt eine Cursor-paginierte Liste von Konversationen zurück, die den Assistenten des authentifizierten Benutzers gehören. Verwende dies, um den Konversationsverlauf anzuzeigen, nach Typ zu filtern oder eine Integration mit deinem CRM durchzuführen.
Dieser Endpunkt verwendet Cursor-basierte Paginierung für eine bessere Performance bei großen Datensätzen. Verwende
next_cursor und prev_cursor, um zwischen den Seiten zu navigieren.Query-Parameter
string
Filtert Konversationen nach Typ. Mögliche Werte:
test, widget, whatsapp, apiinteger
Filtert Konversationen nach Assistenten-ID (muss dem authentifizierten Benutzer gehören)
string
Filtert Konversationen nach der Telefonnummer des Kunden (exakte Übereinstimmung). Nützlich, um alle Gespräche mit einem bestimmten Kunden zu finden.
string
Filtert Konversationen nach der WhatsApp-Absendernummer (exakte Übereinstimmung). Nützlich, um alle Gespräche von einer bestimmten WhatsApp-Business-Nummer zu finden.
string
Filtert Konversationen nach einer externen Kennung. Nützlich, um Konversationen zu finden, die mit Datensätzen in deinem externen System verknüpft sind.
integer
Anzahl der Konversationen pro Seite (1-100, Standard: 15)
string
Cursor für die Paginierung. Verwende
next_cursor oder prev_cursor aus einer vorherigen Antwort.Antwort-Felder
array
string
Cursor zum Abrufen der nächsten Seite mit Ergebnissen. Übergib dies als Parameter
cursor in deiner nächsten Anfrage. null, wenn keine weiteren Ergebnisse vorliegen.string
Cursor zum Abrufen der vorherigen Ergebnisseite.
null, wenn dies die erste Seite ist.integer
Anzahl der Elemente pro Seite
Konversationstypen
Filter-Parameter
Alle Filterparameter verwenden indizierte Spalten für eine effiziente Abfrage:WhatsApp-Konversationsdetails
Für WhatsApp-Konversationen enthält die Antwort zusätzliche Felder:- whatsapp_sender: Die Business-WhatsApp-Nummer, die das Gespräch geführt hat (Name und Telefonnummer deines WhatsApp-Absenders)
- customer: Der Kunde, der das Gespräch initiiert oder empfangen hat (dessen Name und Telefonnummer)
whatsapp vorhanden und helfen dir, die beteiligten Parteien zu identifizieren, wenn du eine Integration mit deinen CRM- oder Support-Systemen vornimmst.
API-Konversationsdetails
Für über die API erstellte Konversationen kannst du beim Erstellen der Konversation einenexternal_identifier festlegen. Diese Kennung wird in der Antwort zurückgegeben und kann für Folgendes verwendet werden:
- Verknüpfung von Konversationen mit deinen CRM-Leads oder -Kontakten
- Nachverfolgung von Konversationen über deine internen Systeme hinweg
- Filterung von Konversationen nach deiner externen Referenz
Anwendungsfälle
- Analyse-Dashboard: Anzeige von Konversationsmetriken und Trends
- CRM-Integration: Synchronisierung von Konversationsdaten mit deiner Kundendatenbank unter Verwendung von
external_identifier - Kundensuche: Finden aller Konversationen mit einem bestimmten Kunden über
customer_phone - Qualitätsüberwachung: Überprüfung des Konversationsvolumens nach Typ und Assistent
- Abrechnungsprüfung: Verfolgung der Konversationskosten in deinem Unternehmen

