Ferndesk

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.

GET /v1/conversations
Bearer-Token Scope inbox:read

Query-Parameter

· 16
limit 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

  • keyword
  • semantic
  • hybrid
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_...).

Antworten