Conversations

Retourne une liste paginée de conversations, triées par ordre chronologique décroissant. Chaque élément inclut le statut, le nombre de tours, la durée totale et des liens vers la transcription et l'audio si disponibles.

Effectue une recherche en texte intégral sur tous les tours de transcription de votre compte. Retourne les extraits correspondants avec leurs identifiants de conversation parent.

Retourne l'enregistrement complet de la conversation, incluant le statut, le nombre de tours, la durée totale et la disponibilité de la transcription et de l'enregistrement.

Retourne un tableau ordonné de tours avec le rôle du locuteur (user, assistant ou human_agent, la personne jointe par un transfert en conférence), le texte, les métriques de latence et tous les appels d'outils effectués par l'agent. Les tours de l'appelant portent aussi text_raw, la sortie brute de la reconnaissance vocale, lorsque la correction post-appel a modifié le texte. Les tours de l'agent coupés par l'appelant portent interrupted_after_ms, la durée pendant laquelle l'agent a parlé avant d'être interrompu, et estimated_text_spoken, la partie de la phrase qui tient dans ce temps. Les trois valent null sinon. Chaque tour porte également start_ms, le décalage en millisecondes entre le premier échantillon de l'enregistrement de l'appel et le moment où ce tour est devenu audible. Transmettez-le à un lecteur avec l'audio de GET /conversations/{id}/audio et les mots du tour commencent là. Il est publié par tour : un tour isolé vaut null lorsque son début n'a pas été mesuré (une réponse jamais diffusée, un tour de l'appelant sans début détecté, ou une saisie au clavier) tandis que les tours voisins conservent le leur, et tous les tours de l'appelant valent null lorsqu'une partie de l'audio de l'appelant ne nous est jamais parvenue, tandis que ceux de l'agent conservent le leur. null sur tous les tours d'un appel signifie l'une de trois choses : les décalages se contredisaient ou contredisaient l'enregistrement, le média de l'appel s'est reconnecté en cours de route, ou l'appel est antérieur à ce champ.

Génère une URL signée (valide 60 minutes) pour télécharger l'enregistrement WAV. Utilisez cette URL avec un client HTTP standard ; elle ne requiert pas l'en-tête X-API-Key.

Retourne le fichier WAV brut. Supporte les en-têtes Range pour les téléchargements partiels. Authentifiez-vous avec le paramètre de requête token (valeur depuis GET .../audio) ou l'en-tête X-API-Key.