Listar conversaciones del asistente

Devuelve las conversaciones del asistente de IA, de más recientes a más antiguas.

GET /v1/assistant/conversations

Token Bearer ámbito 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"
}

Conversaciones paginadas mediante cursor. Con un filtro feedback o coverage, el análisis está limitado a 10 ventanas por solicitud, por lo que una página puede devolverse incompleta con has_more en true; sigue next_cursor para continuar el análisis sin omitir coincidencias.

Parámetros de consulta

· 6

start_cursor string

Cursor opaco tomado del next_cursor de la respuesta anterior.

page_size integer · min: 1· max: 100· por defecto: 20

Elementos por página.

feedback string · enumeración

Restringe la lista a una calificación de pulgar.

valores

all
positive
negative
none

coverage string · enumeración

Restringe la lista a un veredicto de cobertura.

valores

all
covered
partial
none
irrelevant

start_date string

Fecha más antigua que se incluirá.

end_date string

Fecha más reciente que se incluirá.

Parámetros de consulta

Respuestas