Anrufaudio aufzeichnen

Sie können IBM® Voice Gateway so konfigurieren, dass Anrufaudio in einer WAV-Datei aufgezeichnet wird. In den Aufzeichnungen wird das Audio vom Anrufer (Kunde) und entweder das Audio vom Text to Speech-Service für Self-Service-Agenten oder das des Call-Center-Mitarbeiters für Agentenassistenten erfasst.

Informationen zur Audioaufzeichnung

Standardmäßig werden die Aufzeichnungen in einen einzigen Mono-Kanal gemischt. Ab Version 1.0.0.4 können Sie die Stereoaufzeichnung aktivieren, um das Audio von Anrufer und das Audio vom Text to Speech-Service oder dem Call-Center-Mitarbeiter in voneinander getrennten Audiokanälen aufzuzeichnen. Mit der Stereoaufzeichnung können Sie jede einzelne Audioquelle separat analysieren. Sie können z. B. nur das Anruferaudio für die Analyse oder zum Trainieren eines angepassten akustischen Speech to Text-Modells extrahieren.

Wenn Sie die Audioaufzeichnung konfiguriert haben, werden alle Aufzeichnungen im Container voice-gateway-mr im Verzeichnis /vgw-media-relay/recordings/ gespeichert. Da die Aufzeichnungen im Container gespeichert werden, werden die Aufzeichnungen gelöscht, sobald der Container erneut bereitgestellt wird. Wenn Sie Ihre Aufzeichnungen speichern möchten, hängen Sie das Verzeichnis entweder über eine Mountoperation an ein lokales Verzeichnis Ihrer Maschine oder an einen Docker-Datenträger an.

Wichtig: Tonaufzeichnungen können potenziell PHI-Daten (Protected Health Information), PII-Daten (Personally Identifiable Information) oder PCI-DSS-Daten (PCI Data Security Standard) enthalten. Stellen Sie sicher, dass Aufzeichnungen ordnungsgemäß gespeichert werden, um personenbezogene Daten vor unbefugter Einsicht zu schützen. Es wird empfohlen, dass Sie die Platte verschlüsseln, auf der Voice Gateway bereitgestellt wird, um Aufzeichnungen zu schützen, die im Dateisystem möglicherweise zwischengespeichert werden.

Format für die Aufzeichnungsdatei

Aufzeichnungen werden als WAV-Dateien im folgenden Format gespeichert, das von den meisten Standardaudiowiedergabeprogrammen unterstützt wird:

Dateiname: [Sitzungs-ID]-audio.wav. Beispiel: 1234-55678-audio.wav
Abtastrate: 8000 Hz
Kanäle:
- Mono (1 Audiokanal) - Standardeinstellung
- Stereo (2 Audiokanäle)
  - Linker Kanal: Text to Speech-Audio (Self-Service-Agenten) oder Call-Center-Mitarbeiteraudio (Agentenassistenten)
  - Rechter Kanal: Anruferaudio
Codierung: PCM

Die für den Dateinamen verwendete Sitzungs-ID ist der SIP-Anruf-ID zugeordnet. Wenn Sie die Sitzungs-ID ändern möchten, setzen Sie den Wert für die Konfigurationsvariable CUSTOM_SIP_SESSION_HEADER so, dass sie auf einen anderen SIP-Header verweist, der die zu verwendende Sitzungs-ID definiert. Weitere Informationen finden Sie unter SIP Orchestrator-Konfigurationsumgebungsvariablen.

Wie Sie die Audioaufzeichnung konfigurieren, hängt davon ab, wo Sie das Telefongateway bereitgestellt haben. Nachfolgend finden Sie die Beschreibung dazu.

Aufzeichnen für Docker Engine konfigurieren

Öffnen Sie die Datei docker/docker-compose.yml, die Sie erstellt haben, als Sie das erste Mal Voice Gateway in Docker Engine bereitgestellt haben.
Entfernen Sie die Kommentarzeichen für die folgende Konfiguration in der Datei docker-compose.yml. Diese Konfigurationsvariable aktiviert die Aufzeichnung und ordnet über eine Mountoperation ein lokales Verzeichnis zum Speichern der Aufzeichnungen zu. Wenn Sie die Stereoaufzeichnung aktivieren möchten, geben Sie zusätzlich STEREO_RECORDING=true an.
```
media.relay:
 image: ibmcom/voice-gateway-mr:latest
 ...
 environment:
   ...
   - ENABLE_RECORDING=true
   - STEREO_RECORDING=true
 volumes:
   - $PWD/recordings:/vgw-media-relay/recordings
```
Stellen Sie Voice Gateway erneut bereit, damit Ihre Änderungen wirksam werden.

Anstelle eines über eine Mountoperation zugeordneten lokalen Verzeichnisses können Sie die Aufzeichnungen auch manuell in einen lokalen Pfad kopieren, indem Sie den folgenden Befehl absetzen:

  docker cp voice-gateway-mr:/vgw-media-relay/recordings .

Aufzeichnen in IBM Cloud Private konfigurieren

Erstellen Sie einen Datenträger, der die Aufzeichnungen enthalten soll, indem Sie die Datenträgerkonfiguration in einer YAML-Datei angeben.

Wichtig: Stellen Sie sicher, dass name auf recordings, accessModes auf ReadWriteMany und persistentVolumeReclaimPolicy auf Retain gesetzt ist.

 Die folgende YAML-Datei erstellt beispielsweise einen `recordings`-Datenträger, der die Dateien im Verzeichnis `/recordings/` in von IBM Cloud Private speichert.

 kind: PersistentVolume
 apiVersion: v1
 metadata:
   name: recordings
   labels: {}
 spec:
   capacity:
     storage: 2Gi
   accessModes:
   - ReadWriteMany
   persistentVolumeReclaimPolicy: Retain
   hostPath:
     path: /recordings/

Erstellen Sie den Datenträger über die YAML-Datei entweder in der Benutzerschnittstelle oder über die Befehlszeile.
- Klicken Sie in der Benutzerschnittstelle im Dashboard auf Ressource erstellen. Fügen Sie die YAML-Datei in den Textbereich ein und klicken Sie auf Erstellen.
- Führen Sie in der Befehlszeile den Befehl kubectl create -f aus.
```
    kubectl create -f recordingVol.yaml
```
Aktivieren Sie die Aufzeichnung in der Voice Gateway-Konfiguration und stellen Sie sie bereit.
- Wählen Sie in der Benutzerschnittstelle auf der Seite mit der Konfiguration des Voice Gateway-Helmdiagramms den Eintrag Aufzeichnung aktivieren aus. Klicken Sie auf Installieren, um die Bereitstellung erneut bereitzustellen.
- Setzen Sie den Wert für die Eigenschaft mediaRelayEnvVariables.enableRecording über die Befehlszeile entweder in der Datei vgwEnvVariables.yaml auf true oder geben Sie den Wert mit dem Befehl über die Option --set an.
  
  Geben Sie in der Datei vgwEnvVariables.yaml für die Eigenschaft unterhalb von mediaRelayEnvVariables das folgende Format an:
```
mediaRelayEnvVariables:
  enableRecording: true
```
  Führen Sie den folgenden Befehl aus, um den Wert für die Option --set festzulegen:
```
helm install ibm-charts/ibm-voice-gateway --name my-release \
--set mediaRelayEnvVariables.enableRecording=true
```

Aufzeichnung für Kubernetes in IBM Cloud Kubernetes Service konfigurieren

Öffnen Sie die Kubernetes-Bereitstellungsdatei deploy.json, die Sie erstellt haben, als Sie das erste Mal Voice Gateway in Kubernetes in IBM Cloud bereitgestellt haben.
Aktivieren Sie im Container vgw-media-relay die Aufzeichnung, indem Sie die Umgebungsvariable ENABLE_RECORDING auf true setzen. Sie können die Stereoaufzeichnung optional aktivieren, indem Sie die Variable STEREO_RECORDING auf true setzen.
```
"env": [{
         "name": "ENABLE_RECORDING",
         "value": "true"
       },
       {
         "name": "STEREO_RECORDING",
         "value": "true"
        }
        ...
       ]
```
Stellen Sie Voice Gateway erneut bereit, damit Ihre Änderungen wirksam werden.

Wenn die Aufzeichnung aktiviert ist, erstellt Ihre Voice Gateway-Bereitstellung einen Docker-Datenträger mit dem Namen recordings im Pod. Dieser Datenträger speichert die Audiodateien für die Aufzeichnungen jeder Sitzung.

Wichtig: Lite Kubernetes-Cluster können Datenträger nur im Pod erstellen. Wenn Sie also den Pod löschen, werden der Datenträger und die Aufzeichnungen gelöscht. Wenn Sie die Aufzeichnungen in ein lokales Verzeichnis kopieren möchten, führen Sie den Befehl kubectl cp mit den folgenden Optionen aus:

 kubectl cp <Namensbereich>/<Podname>:recordings -c <Containername> <Zielverzeichnis>

Der folgende Beispiel kopiert beispielsweise den Datenträger recordings vom Pod pod1 in das aktuelle Verzeichnis.

 kubectl cp default/pod1:recordings -c vgw-media-relay .