Passer au contenu principal
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.

Appels sortants tombés sur une messagerie

Quand un appel sortant est décroché par le répondeur du contact, result reste ANSWERED, car l’opérateur considère qu’un répondeur qui décroche est une réponse. Deux champs portent l’information à la place : Les deux sont indépendants : detected_outbound_voicemail: true avec voicemail_left: false signifie que l’appel est tombé sur une messagerie et que l’appelant a raccroché sans laisser de message. L’un ou l’autre peut valoir null quand le signal n’a jamais été déterminé. null n’est pas équivalent à false.
Filtrer sur result: "VOICEMAIL" ne renvoie que les messageries entrantes. Pour trouver les appels sortants tombés sur une messagerie, cherchez avec direction: "OUTBOUND" puis filtrez les éléments renvoyés sur detected_outbound_voicemail. Il n’existe pas de filtre de requête pour ce champ.

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

duration est la durée totale de l’appel en secondes, sonnerie incluse. recording_duration est la durée de conversation, celle affichée dans l’application Allo pour les appels enregistrés. Pour les appels sans enregistrement, l’application utilise duration. recording_download_url télécharge le fichier de l’enregistrement sans connexion à Allo, pendant 48 heures. Il n’est renvoyé que sur les lignes des comptes créés par un partenaire, jamais pour un appel HIPAA. Voir Liens vers l’enregistrement.

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