Ferndesk

Lister les conversations

Liste et recherche les conversations de la boîte de réception Support, par activité la plus récente. Les filtres se combinent. Avec query, seules les conversations trouvées sont renvoyées, par pertinence décroissante (200 au maximum), chacune avec search : le passage correspondant et son emplacement.

GET /v1/conversations
Jeton Bearer portée inbox:read

Paramètres de requête

· 16
limit integer · min: 1· max: 100· par défaut : 25

Nombre d’éléments par page, de 1 à 100.

cursor string · min length: 1

Le next_cursor de la page précédente. Valide uniquement avec le même endpoint et les mêmes filtres.

query string · max length: 200

Mots à rechercher dans l’objet, chez le client (nom, e-mail, propriétés), ainsi que dans chaque message et note interne.

mode string · énumération

Avec query : keyword recherche les mots, semantic leur signification, hybrid (valeur par défaut) les deux, par pertinence décroissante.

valeurs

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

Uniquement ces statuts. Répétez le paramètre ou séparez les valeurs par des virgules.

assignee string | array of string

Uniquement les conversations attribuées à ces membres de l’équipe (mem_...) ou à "unassigned". Répétez le paramètre ou séparez les valeurs par des virgules.

label_ids string | array of string

Uniquement les conversations portant l’une de ces étiquettes (tag_...). Répétez le paramètre ou séparez les valeurs par des virgules.

channel string | array of string

Uniquement ces canaux. Répétez le paramètre ou séparez les valeurs par des virgules.

priority string | array of string

Uniquement ces priorités. Répétez le paramètre ou séparez les valeurs par des virgules.

customer_id string · min length: 1

Uniquement ce client (cust_...).

Réponses