Grundlegendes zu Workflows für die Aufzeichnung von Anrufen

In den Themen in diesem Abschnitt werden die Workflows für die Aufzeichnung von Anrufen und Kinesis Video Streams aufgeführt und beschrieben.

Aufzeichnen von Voice Connector-Anrufen

Verwenden Sie diesen Workflow, wenn:

• Sie verwenden bereits einen Voice Connector oder planen, ihn zu verwenden, um SIP Medien in die Anrufanalyse einzubeziehen.

  Anmerkung

  Voice Connectors unterstützen SIP undSIPREC. Weitere Informationen finden Sie unter Verwaltung von Amazon Chime SDK Voice Connectors im Amazon Chime SDK Chime-Administratorhandbuch.

• Sie möchten SIPREC Anrufe SIP oder Anrufe mit geringer Latenz an Amazon Simple Storage Service-Ziele Ihrer Wahl automatisch aufzeichnen.

• Sie möchten die Amazon Chime SDK Chime-Konsole verwenden, um die Konfiguration zu erstellen und sie einem Voice Connector zuzuordnen.

• Sie möchten dieselbe Aufnahmekonfiguration auf jeden Voice Connector-Anruf anwenden. Wenn Sie mehrere Konfigurationen auf einen oder mehrere Voice Connectors anwenden möchten, lesen Sie den nächsten Abschnitt.

Verwenden Sie den folgenden Amazon Chime, um programmgesteuertes Aufrufen zu aktivieren. SDK APIs

• Verwenden der CreateMediaInsightsPipelineConfigurationAPIum eine Konfiguration für Anrufanalysen zu erstellen

• Verwenden der CreateVoiceConnectorum einen Voice Connector zu erstellen.

• Verwenden der PutVoiceConnectorStreamingConfigurationAPIum die Konfiguration einem Voice Connector zuzuordnen.

Weitere Informationen finden Sie unter Konfiguration von Voice Connectors für die Verwendung von Anrufanalysen im Amazon Chime SDK Chime-Administratorhandbuch.

Das folgende Diagramm zeigt den Datenfluss, wenn ein Voice Connector eine Anrufaufzeichnungssitzung einleitet. Die Zahlen im Diagramm entsprechen dem nummerierten Text unten.

Im Diagramm:

1. Verwenden Sie die Amazon Chime SDK Chime-Konsole oder die CreateMediaInsightsPipelineConfigurationAPIum eine Konfiguration für Anrufanalysen zu erstellen. Während der Erstellung der Konfiguration aktivieren Sie einfach die Anrufaufzeichnung, wählen das gewünschte Aufnahmedateiformat und geben das Amazon S3 S3-Ziel zum Speichern der Aufzeichnungsdateien an. Weitere Informationen finden Sie unter Creating Call Analytics-Konfigurationen im Amazon Chime SDK Chime-Administratorhandbuch.

2. Sie verwenden die Amazon Chime SDK Chime-Konsole oder PutVoiceConnectorStreamingConfigurationAPIum die Konfiguration einem Voice Connector zuzuordnen. Informationen zur Verwendung der Konsole finden Sie unter Voice Connectors für die Verwendung von Anrufanalysen konfigurieren.

3. Während eines ausgehenden Anrufs empfängt der Voice Connector das Audio jedes Gesprächsteilnehmers.

4. Wenn eine Konfiguration für die Aufzeichnung von Anrufanalysen an den Voice Connector angehängt ist, verwendet der Voice Connector-Dienst den Media Pipeline-Dienst, um eine Anrufanalyse-Aufzeichnungssitzung zu initiieren.

5. Der Media Pipeline-Dienst initiiert den Prozessor für die Anrufaufzeichnung, der den laufenden Anruf überwacht.

6. Wenn der Anruf beendet ist, übermittelt der Media Pipeline-Service die Anrufaufzeichnungsdatei an den dafür vorgesehenen Amazon S3 S3-Bucket und stellt die Aufzeichnungsmetadaten über den Amazon Kinesis Data Stream bereit. Wenn ein Data Warehouse aktiviert ist, werden die Aufruf-Metadaten auch an das Amazon Simple Storage Service Data Warehouse gesendet. In Fällen, in denen SIP Audio in die Anrufanalyse integriert SIPREC wird, enthalten die SIPREC Anruf-Metadaten Metadaten in einem Tabellenformat. Weitere Informationen zu den Aufzeichnungstabellen finden Sie weiter Grundlegendes zu den AWS Glue Datenkatalogtabellen unten in diesem Abschnitt.

7. Der Media Pipeline-Service sendet die Pipeline-Status-Ereignisse an das Standard-Amazon EventBridge. Weitere Informationen finden Sie unter Verwenden von EventBridge Benachrichtigungen in diesem Handbuch.

Anmerkung

Bitte beachten Sie, dass Sie Voice Connector-Streaming aktivieren müssen, um die Aufnahme mit einem Voice Connector zu ermöglichen. Diese Funktion ermöglicht das Streaming von Anrufdaten zu den von Voice Connector verwalteten Kinesis Video Streams in Ihrem Konto. Weitere Informationen finden Sie unter Streaming von Amazon Chime SDK Voice Connector-Medien zu Kinesis Video Streams im Amazon Chime SDK Administratorhandbuch.

Sie können auch mit Voice Connector erstellte Anrufdaten in Kinesis Video Streams für unterschiedliche Zeiträume speichern, die von Stunden über Tage bis hin zu Jahren reichen. Wenn Sie sich dafür entscheiden, keine Daten aufzubewahren, wird die Verwendbarkeit der Anrufdaten für den sofortigen Zugriff eingeschränkt. Die Kosten für Kinesis Video Streams richten sich nach der verwendeten Bandbreite und dem insgesamt genutzten Speicherplatz. Sie können die Datenaufbewahrungsdauer jederzeit in der Voice Connector-Streaming-Konfiguration anpassen. Um die Aufzeichnung von Anrufanalysen zu aktivieren, müssen Sie sicherstellen, dass der Kinesis Video Stream die Daten lange genug speichert, um die Anrufanalysen durchzuführen. Dazu geben Sie einen geeigneten Aufbewahrungszeitraum für Daten an.

Sie können eine Konfiguration der Call Insights-Pipeline beliebig vielen Voice Connectors zuordnen. Sie können auch für jeden Voice Connector eine andere Konfiguration erstellen. Voice Connectors verwenden den AWSServiceRoleForAmazonChimeVoiceConnector , um die anzurufen CreateMediaInsightsPipelineAPIin Ihrem Namen einmal pro Transaktions-ID. Informationen zur Rolle finden Sie unter Verwenden der SDK serviceverknüpften Amazon Chime-Rolle für Amazon Chime SDK Voice Connectors im Amazon Chime SDKChime-Administratorhandbuch.

Aufnahme mit Amazon Kinesis Video-Stream-Produzenten

Sie zeichnen Amazon Kinesis Video-Streams auf, wenn:

• Sie müssen unterschiedliche Konfigurationen auf einen Anruf anwenden, anstatt dieselbe Konfiguration für jeden Voice Connector-Anruf zu verwenden.

• Sie möchten Audio aufnehmen SIP oder kein SIP Audio, das nicht von einem Voice Connector verarbeitet wird.

Um diese Option für die Anrufaufzeichnung zu verwenden, müssen Sie Audio in Kinesis Video Streams (KVS) veröffentlichen und dann den CreateMediaInsightsPipelineAPImit KVS Stream-Kanalinformationen und einer Konfiguration ARN für Anrufanalysen.

Anmerkung

Die Anrufanalyse APIs unterstützt maximal zwei Audiokanäle. Sie können auch das Voice Connector-Streaming aktivieren und dann die in den EventBridge Benachrichtigungen des Voice Connectors veröffentlichten KVS Informationen verwenden, um eine Anrufaufzeichnung zu starten.

Beim Anrufen der CreateMediaInsightsPipelineAPI, können Sie wählen, ob Sie Fragmentnummern für jede KVS Stream-Kanaldefinition angeben möchten oder nicht. Wenn Sie eine Fragmentnummer angeben, beginnt Call Analytics mit der Verarbeitung des Streams an diesem Fragment. Wenn Sie keine Fragment-ID angeben, beginnt Call Analytics mit der Verarbeitung des Streams ab dem neuesten verfügbaren Fragment.

Das folgende Diagramm zeigt den Datenfluss, wenn ein Voice Connector eine Anrufaufzeichnungssitzung initiiert. Die Zahlen im Diagramm entsprechen dem nummerierten Text unten.

Im Diagramm:

1. Sie können die Amazon Chime SDK Chime-Konsole verwenden oder CreateMediaInsightsPipelineConfigurationAPIum eine Konfiguration für die Anrufaufzeichnung zu erstellen.

2. Verwenden Sie die AWS SDK, um eine Anwendung zu erstellen, die externes Audio in eine Datei überträgtKVS, oder aktivieren Sie das Voice Connector-Streaming, um Anruf-Audio automatisch auf einem KVS zu veröffentlichen. Weitere Informationen finden Sie unter Streaming von Amazon Chime SDK Voice Connector-Medien zu Kinesis Video Streams im Amazon Chime SDK Chime-Administratorhandbuch.

3. Wenn Voice Connector-Streaming aktiviert ist, sendet der Voice Connector-Dienst standardmäßig Benachrichtigungen. EventBridge

4. Im Fall von Voice Connector-Streaming kann Ihre Anwendung die Amazon Chime Voice STARTED Connector-Streaming-Ereignisse von verwenden, EventBridge um KVS Stream-Informationen über die einzelnen Phasen eines Anrufs zu sammeln.

5. Sobald Ihre Anwendung über die Audioinformationen von Voice Connector-Streaming-Ereignissen oder einer externen Quelle verfügt, ruft Ihre Anwendung Amazon Chime auf SDK CreateMediaInsightsPipeline API.

6. Der Media Pipeline-Dienst initiiert den Prozessor für die Anrufaufzeichnung, der den laufenden Anruf überwacht.

7. Der Media Pipeline-Service sendet die Pipeline-Status-Ereignisse an das Standard-Amazon EventBridge. Weitere Informationen finden Sie unter EventBridge Benachrichtigungen verwenden.

8. Sobald ein Anruf abgeschlossen ist, übermittelt der Media Pipeline-Service die Anrufaufzeichnungsdatei an den dafür vorgesehenen Amazon S3 S3-Bucket und stellt die Aufzeichnungsmetadaten über Amazon Kinesis Data Stream bereit. Wenn ein Data Warehouse aktiviert ist, werden die Anruf-Metadaten auch an das Amazon S3 S3-Data Warehouse gesendet. In Fällen, in denen SIPREC SIP Audio in die Anrufanalyse integriert wird, enthalten die SIPREC Anruf-Metadaten Metadaten in einem praktischen Tabellenformat. Weitere Informationen zu den Aufzeichnungstabellen finden Sie weiter Grundlegendes zu den AWS Glue Datenkatalogtabellen unten in diesem Abschnitt.

9. Ihre Anwendung kann die Pipeline und im Falle eines Voice Connectors den Anrufstatus anhand von Ereignissen überwachen, die auf Amazon veröffentlicht wurden EventBridge. Weitere Informationen finden Sie unter Verwenden von EventBridge Benachrichtigungen in diesem Handbuch.

10. Um die Aufnahme zu beenden, rufen Sie den DeleteMediaPipelineAPIum die Anrufaufzeichnung zu beenden.

Informationen zu API aufzeichnungsbasierten Aufzeichnungen und Beispielen finden Sie unter Amazon S3 Recording Sink in diesem Handbuch.

Verwenden vonCLI, um die Aufnahme zu starten

In den Beispielen in diesem Abschnitt wird erklärt, wie Sie Folgendes tun können:

• Verwenden Sie dieCLI, um eine Konfiguration für Anrufanalysen auszuführen und die aufzurufen CreateMediaInsightsPipeline.

• Verwenden Sie denCLI, um Aufnahmeziele, Audiodateiformate und Audiodateinamen anzugeben.

Eine Konfiguration ausführen und eine Pipeline starten

Verwenden Sie den folgenden Befehl, um eine Konfiguration auszuführen und eine Media Insights-Pipeline zu starten. Die Datei pipeline.json enthält die Konfigurationseinstellungen.

aws chime-sdk-media-pipeline create-media-insights-pipeline --cli-input-json file://pipeline.json

Das folgende Beispiel zeigt eine typische Datei. pipeline.json

{
    "MediaInsightsPipelineConfigurationArn": arn:aws:chime:region;account_id:media-insights-pipeline-configuration/MyConfiguration,
    "KinesisVideoStreamRecordingSourceRuntimeConfiguration": {
        "Streams": [
            {
                "StreamArn": kinesis_video_stream_arn_1
            },
            {
                "StreamArn": kinesis_video_stream_arn_2
            }
        ],
        "FragmentSelector": {
            "FragmentSelectorType": "selector_type", // Specify "server_timestamp" or "producer_timestamp" as the fragment selector type
            "TimestampRange": {
                "StartTimestamp": epoch_time_seconds,
                "EndTimestamp": epoch_time_seconds
            }
        }
    },
    "S3RecordingSinkRuntimeConfiguration": {
        "Destination": arn:aws:s3:::bucket_name/prefix/optional_file_name,
        "RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format, if you want to override the configuration
    }
}

Dies MediaInsightsPipelineConfigurationArn ist die KonfigurationARN, die Sie erhalten, nachdem Sie eine Konfiguration für Anrufanalysen erstellt haben.

Ziele, Namen und Formate festlegen

Im folgenden Beispiel wird ein Ordner verwendet, der MyRecordingBucket als S3SinkConfiguration.Destination Wert und Opus als RecordingFileFormat Wert benannt ist.

arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.ogg

Im folgenden Beispiel wird MyRecordingBucket als S3SinkConfiguration.Destination Wert und Wav als RecordingFileFormat Wert verwendet.

arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.wav