Search all conversations
Conversations
Rechercher des éléments de conversation
Search and filter items across all conversations. Supports keyword search across transcripts, summaries, and message content.
POST
Search all conversations
Scope requis :
CONVERSATIONS_READpage et size dans le corps de la requête pour contrôler les résultats. Voir Pagination.
Comportement de la recherche
Le champsearch 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.
| L’utilisateur demande | Valeur de search |
|---|---|
| ”Trouver les appels où les clients se sont plaints de la facturation” | "billing complaint" |
| ”Qu’avons-nous discuté à propos de la politique de remboursement ?” | "refund policy" |
| ”Montrer les conversations mentionnant la tarification entreprise” | "enterprise pricing" |
- 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=RELEVANCEpour classer les résultats par qualité de correspondance plutôt que par date
Notes sur les champs
| Champ | Null quand |
|---|---|
summary | Éléments SMS, ou appels dont le résumé IA n’est pas encore disponible |
duration | Éléments SMS (s’applique uniquement aux appels) |
result | Éléments SMS (s’applique uniquement aux appels) |
recording_url | Enregistrement désactivé, appel sans réponse, ou éléments SMS |
transcript | Non demandé via extend=transcript, ou éléments SMS |
content | Éléments d’appel (s’applique uniquement aux SMS) |
status | Éléments d’appel (s’applique uniquement aux SMS) |
tags | Éléments SMS (les tags s’appliquent uniquement aux appels) |
Paramètre extend
| Valeur | Effet |
|---|---|
transcript | Inclure les transcriptions complètes des appels sur chaque élément |
400 avec le code UNSUPPORTED_EXTEND_VALUE.Autorisations
Corps
application/json
Options disponibles:
INBOUND, OUTBOUND Options disponibles:
CALL, SMS, ALL Options disponibles:
ANSWERED, VOICEMAIL, TRANSFERRED 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.
Options disponibles:
DATE_DESC, DATE_ASC, RELEVANCE Plage requise:
x <= 100Date range to filter by