Assistentenunterhaltungen auflisten

Gibt AI-Assistentenunterhaltungen zurück, neueste zuerst.

GET /v1/assistant/conversations

Bearer-Token Scope conversations:read

curl 'https://api.ferndesk.com/v1/assistant/conversations?start_cursor=eyJ2IjoxLCJrIjpbIjIwMjYtMDEtMDEiLCJhcnRfMSJdfQ&page_size=20&feedback=negative&coverage=none&start_date=2026-01-01&end_date=2026-01-31' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "results": [
    {
      "id": "conv_01JXY9AZK4KV",
      "createdAt": "2026-01-15T18:25:43.511Z",
      "updatedAt": "2026-01-15T18:25:43.511Z",
      "status": "active",
      "source": "widget",
      "pageUrl": "https://example.com/pricing",
      "user": {
        "id": "hcusr_01JXYB3S2Y8C",
        "name": "Alice Example"
      },
      "summary": "Asked how to rotate an API key.",
      "coverage": "covered",
      "feedback": "positive",
      "escalated": false,
      "messageCount": 4
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ2IjoxLCJrIjpbIjIwMjYtMDEtMDEiLCJhcnRfMSJdfQ"
}

Cursor-paginierte Unterhaltungen. Bei einem feedback- oder coverage-Filter ist der Scan auf 10 Fenster pro Anfrage begrenzt, sodass eine Seite mit has_more true möglicherweise weniger Ergebnisse enthält; folgen Sie next_cursor, um den Scan fortzusetzen, ohne Treffer zu überspringen

Query-Parameter

· 6

start_cursor string

Intransparenter Cursor aus der vorherigen Antwort von next_cursor.

page_size integer · min: 1· max: 100· Standard: 20

Elemente pro Seite.

feedback string · Enum

Beschränkt die Liste auf eine Daumenbewertung.

Werte

all
positive
negative
none

coverage string · Enum

Beschränkt die Liste auf ein Abdeckungsurteil.

Werte

all
covered
partial
none
irrelevant

start_date string

Frühestes einzuschließendes Datum.

end_date string

Spätestes einzuschließendes Datum.

Query-Parameter

Antworten