Enregistrements

Accès aux enregistrements d'appels vidéo. Les enregistrements sont stockés au format WebM et sont disponibles après la fin de l'appel.

Endpoints

Méthode	Endpoint	Description	Rôle Minimum
GET	/api/v1/calls/:call_id/recording	Obtenir l'enregistrement d'un appel	attendant

---

Obtenir un Enregistrement

Retourne les métadonnées et l'URL de téléchargement de l'enregistrement d'un appel.

GET /api/v1/calls/:call_id/recording

Path Parameters

Paramètre	Type	Description
call_id	uuid	ID de l'appel

Exemple de Requête

curl -X GET https://voki.avanter.com.br/api/v1/calls/1a2b3c4d-5e6f-7890-abcd-ef1234567890/recording \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Réponse de Succès (200)

{
  "data": {
    "id": "r1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "call_id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
    "format": "webm",
    "duration": 345,
    "file_size": 15234567,
    "download_url": "/api/v1/calls/1a2b3c4d-5e6f-7890-abcd-ef1234567890/recording/download",
    "transcription": {
      "status": "completed",
      "text": "Texte transcrit de l'appel...",
      "language": "pt-BR"
    },
    "created_at": "2026-02-15T14:36:00Z"
  }
}

Erreurs

Code	Description
404	Appel non trouvé ou sans enregistrement
403	Permission insuffisante pour accéder à l'enregistrement

{
  "errors": {
    "detail": "Enregistrement non trouvé"
  }
}

---

Notes Techniques

Format d'Enregistrement

Les enregistrements sont sauvegardés au format WebM (VP8/Opus) par le SFU natif en Elixir/Rust. Le fichier contient :

• Vidéo : Tous les participants en disposition composée
• Audio : Mix de tous les participants

Transcription

Si la transcription est activée dans les paramètres de l'entreprise (transcription_enabled: true), l'audio est traité par le module voki_ai pour générer une transcription automatique via Whisper.

Stockage

• Les enregistrements sont stockés localement sur le serveur
• La durée de rétention dépend du plan souscrit
• Les enregistrements ne peuvent pas être supprimés individuellement (politique d'auditabilité)

Politique d'Auditabilité

Les départements possédant des appels avec des enregistrements ne peuvent pas être supprimés. Cela garantit la traçabilité et la conformité réglementaire des enregistrements.