Unterhaltungen auflisten
Listet die Unterhaltungen im Support-Posteingang auf und durchsucht sie, wobei die neueste Aktivität zuerst angezeigt wird. Filter werden kombiniert. Mit query werden nur die gefundenen Unterhaltungen angezeigt, sortiert nach bester Übereinstimmung (höchstens 200); jede enthält search: die passende Textstelle und deren Fundort.
/v1/conversations inbox:read Query-Parameter
· 16limit integer · min: 1· max: 100· Standard: 25 Einträge pro Seite, 1 bis 100.
cursor string · min length: 1 Der next_cursor der vorherigen Seite. Nur mit demselben Endpunkt und denselben Filtern gültig.
query string · max length: 200 Wörter, nach denen im Betreff, beim Kunden (Name, E-Mail-Adresse, Eigenschaften) sowie in allen Nachrichten und internen Notizen gesucht wird.
mode string · Enum Mit query: keyword sucht nach passenden Wörtern, semantic nach der Bedeutung, hybrid (Standard) nach beidem; die beste Übereinstimmung wird zuerst angezeigt.
Werte
keywordsemantichybrid
status string | array of string Nur diese Statuswerte. Wiederholen Sie den Parameter oder trennen Sie die Werte durch Kommas.
assignee string | array of string Nur Unterhaltungen, die diesen Teammitgliedern (mem_...) zugewiesen sind, oder "unassigned". Wiederholen Sie den Parameter oder trennen Sie die Werte durch Kommas.
label_ids string | array of string Nur Unterhaltungen mit einem dieser Labels (tag_...). Wiederholen Sie den Parameter oder trennen Sie die Werte durch Kommas.
channel string | array of string Nur diese Kanäle. Wiederholen Sie den Parameter oder trennen Sie die Werte durch Kommas.
priority string | array of string Nur diese Prioritäten. Wiederholen Sie den Parameter oder trennen Sie die Werte durch Kommas.
customer_id string · min length: 1 Nur dieser Kunde (cust_...).