Lister les conversations de l’assistant

Renvoie les conversations de l’assistant IA, de la plus récente à la plus ancienne.

GET /v1/assistant/conversations

Jeton Bearer portée 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"
}

Conversations paginées par curseur. Avec un filtre feedback ou coverage, l’analyse est limitée à 10 fenêtres par requête ; une page peut donc être incomplète avec has_more à true. Suivez next_cursor pour poursuivre l’analyse sans ignorer de correspondances.

Paramètres de requête

· 6

start_cursor string

Curseur opaque extrait de la réponse précédente dans next_cursor.

page_size integer · min: 1· max: 100· par défaut : 20

Nombre d’éléments par page.

feedback string · énumération

Restreint la liste à une seule évaluation par pouces.

valeurs

all
positive
negative
none

coverage string · énumération

Restreint la liste à un seul verdict de couverture.

valeurs

all
covered
partial
none
irrelevant

start_date string

Date la plus ancienne à inclure.

end_date string

Date la plus récente à inclure.

Paramètres de requête

Réponses