Skip to main content
POST
Search all conversations
Scope requis : CONVERSATIONS_READ
Cet endpoint est paginé. Utilisez page et size dans le corps de la requête pour contrôler les résultats. Voir Pagination.

Comportement de la recherche

Le champ search est une recherche par mots-clés, pas une requête en langage naturel. Extrayez les mots-clés de la question de l’utilisateur avant de les transmettre. Fonctionnement de la correspondance :
  • Les termes sont combinés avec AND"billing refund" correspond aux éléments contenant les deux mots
  • La correspondance par préfixe est utilisée — "bill" correspond à “billing”, “billed”, etc.
  • La recherche porte sur : les transcriptions d’appels, les résumés d’appels et le contenu des messages SMS
  • Utilisez sort=RELEVANCE pour classer les résultats par qualité de correspondance plutôt que par date

Notes sur les champs

Paramètre extend

Passer une valeur non prise en charge renvoie une erreur 400 avec le code UNSUPPORTED_EXTEND_VALUE.

Autorisations

Authorization
string
header
requis

Corps

application/json
allo_number
string
contact_number
string
user_id
string
direction
enum<string>
Options disponibles:
INBOUND,
OUTBOUND
type
enum<string>
défaut:ALL
Options disponibles:
CALL,
SMS,
ALL
result
enum<string>
Options disponibles:
ANSWERED,
VOICEMAIL,
TRANSFERRED
tags
string[]
unread
boolean
unresponded
boolean

Keyword search (not natural language). Extract keywords from the user's question. Terms are AND'd with prefix matching — 'billing refund' matches items containing both words, 'bill' matches 'billing'. Searches across call transcripts, summaries, and SMS content.

sort
enum<string>
défaut:DATE_DESC
Options disponibles:
DATE_DESC,
DATE_ASC,
RELEVANCE
extend
string
page
integer
défaut:1
size
integer
défaut:20
Plage requise: x <= 100
date
object

Date range to filter by

Réponse

Search results

data
object[]
pagination
object