Enregistrement & transcription

Enregistrez les appels et produisez des transcriptions mot pour mot automatiquement.

Pourquoi enregistrer et transcrire

Les enregistrements et les transcriptions sont désactivés par défaut. Activez-les par agent lorsque vous en avez besoin.

Raisons courantes d'activer :

Contrôle qualité et coaching. Révisez les appels pour évaluer les performances des agents et former le personnel humain.
Conformité. Certains secteurs réglementés exigent l'enregistrement des appels. Les transcriptions peuvent satisfaire les exigences de documentation.
Analytique. Alimentez les transcriptions dans des pipelines en aval pour extraire l'intention, le sentiment ou les entités nommées.
Automatisation. Déclenchez des workflows basés sur les résultats des appels en analysant les données de transcription dans les webhooks.

Activer l'enregistrement et la transcription

Définissez `recording_enabled` et `transcription_enabled` sur l'agent via une requête PATCH.

Activer sur un agent existant

bash

curl -X PATCH https://api.aethexai.com/api/v1/agents/$AGENT_ID \
  -H "X-API-Key: $AETHEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recording_enabled": true,
    "transcription_enabled": true
  }'

Enregistrements

Les enregistrements sont stockés sous forme de fichiers MP3. Le traitement prend quelques secondes après la fin de l'appel.

Listez les enregistrements via GET/recordings — filtrez par `status =` ready pour n'obtenir que les enregistrements terminés.

Téléchargez le fichier audio via GET/recordings/{id}/audio, qui retourne une URL présignée de courte durée.

Transcriptions

Les transcriptions sont structurées comme une liste de tours avec rôle, texte et horodatage.

Récupérez une transcription via GET/conversations/{id}/transcript.

200 OK

json

{
  "conversation_id": "f4a2c8e0-1234-...",
  "turns": [
    {
      "turn_id": "8a91b3c2-...",
      "role": "assistant",
      "turn_index": 0,
      "text": "Hi, thanks for calling First Capital Bank. This is Maya. How can I help?",
      "created_at": "2026-05-12T14:21:03.142Z"
    },
    {
      "turn_id": "12c4d8f6-...",
      "role": "user",
      "turn_index": 1,
      "text": "Hey, I'm trying to figure out how to dispute a charge on my card.",
      "created_at": "2026-05-12T14:21:08.974Z"
    },
    {
      "turn_id": "9d7a6e3b-...",
      "role": "assistant",
      "turn_index": 2,
      "text": "For a card dispute, let me transfer you to a specialist on our fraud team. One moment.",
      "created_at": "2026-05-12T14:21:14.508Z"
    }
  ]
}

Le champ role vaut "user" (appelant), "assistant" (agent) ou, après un transfert en conférence, "human_agent" (la personne vers qui l'appel a été transféré).

Quand le traitement est-il terminé ?

Interrogez GET/recordings jusqu'à ce que `status` soit `ready` pour l'enregistrement.

Pour les transcriptions, interrogez GET/conversations jusqu'à ce que `transcription_status` soit `completed`.

Stockage et conservation

Les enregistrements et les transcriptions sont conservés 90 jours par défaut. Contactez notre équipe si vous avez besoin d'une conservation personnalisée.

Supprimez un enregistrement plus tôt via DELETE/recordings/{id} . Cela supprime également la transcription associée.