Ferndesk

Listar conversaciones

Enumera y busca las conversaciones de la bandeja de soporte, ordenadas de más reciente a más antigua según la actividad. Los filtros se combinan. Con query, solo devuelve las conversaciones que encuentra, primero la mejor coincidencia (como máximo 200), cada una con search: el pasaje que coincidió y dónde.

GET /v1/conversations
Token Bearer ámbito inbox:read

Parámetros de consulta

· 16
limit integer · min: 1· max: 100· por defecto: 25

Elementos por página, de 1 a 100.

cursor string · min length: 1

El next_cursor de la página anterior. Solo es válido con el mismo endpoint y los mismos filtros.

query string · max length: 200

Palabras que buscar en el asunto, el cliente (nombre, correo electrónico, propiedades) y todos los mensajes y notas internas.

mode string · enumeración

Con query: keyword busca coincidencias con las palabras, semantic con su significado, hybrid (el valor predeterminado) usa ambos; primero la mejor coincidencia.

valores

  • keyword
  • semantic
  • hybrid
status string | array of string

Solo estos estados. Repite el parámetro o separa los valores con comas.

assignee string | array of string

Solo conversaciones asignadas a estos compañeros de equipo (mem_...), o "unassigned". Repite el parámetro o separa los valores con comas.

label_ids string | array of string

Solo conversaciones con cualquiera de estas etiquetas (tag_...). Repite el parámetro o separa los valores con comas.

channel string | array of string

Solo estos canales. Repite el parámetro o separa los valores con comas.

priority string | array of string

Solo estas prioridades. Repite el parámetro o separa los valores con comas.

customer_id string · min length: 1

Solo este cliente (cust_...).

Respuestas