StartCallRecording

DieStartCallRecording Aktion startet die Aufzeichnung eines Gesprächsabschnitts. Sie starten die Anrufaufzeichnung in Ihren SIP-Medienanwendungen, entweder bei Bedarf oder als Reaktion auf ein SIP-Ereignis.

• Um die On-Demand-Aufzeichnung eines Anrufs zu starten, verwenden Sie dieUpdateSipMediaApplication API, um Ihre Anwendung aufzurufen und dieStartCallRecording Aktion zurückzugeben.

• Um die Anrufaufzeichnung als Reaktion auf ein SIP-Ereignis zu starten, geben Sie dieStartCallRecording Aktion in Ihrer Anwendung zurück.

Sie geben an, ob Sie die Audiospur für den eingehenden Abschnitt, den ausgehenden Abschnitt oder beide aufnehmen möchten. In den folgenden Abschnitten wird die Verwendung derStartCallRecording Aktion erläutert.

Anmerkung

Aufzeichnungen, die mit dieser Funktion gemacht wurden, können Gesetzen oder Vorschriften zur Aufzeichnung elektronischer Kommunikation unterliegen. Es liegt in Ihrer Verantwortung und Ihrer Endnutzer, alle geltenden Gesetze in Bezug auf die Aufzeichnung einzuhalten, einschließlich der ordnungsgemäßen Benachrichtigung aller Teilnehmer einer aufgezeichneten Sitzung oder Kommunikation darüber, dass die Sitzung oder Kommunikation aufgezeichnet wird, und deren Zustimmung einzuholen.

Eine StartCallRecording Aktion anfordern

Das folgende Beispiel zeigt, wie dieStartCallRecording Aktion fürBOTH Tracks angefordert wird.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Type": "StartCallRecording",
            "Parameters":
            {
                "CallId": "call-id-1",
                "Track": "BOTH",
                "Destination":
                {
                    "Type": "S3",
                    "Location": "valid-bucket-name-and-optional-prefix"
                }
            }
        }
    ]
}

CallId

Beschreibung —CallId des TeilnehmersCallDetails amAWS Lambda Funktionsaufruf

Zulässige Werte — Eine gültige Anruf-ID

Erforderlich — Ja

Standardwert – Kein

Spur

Beschreibung — AudioTrack der Anrufaufzeichnung.

Zulässige Werte —BOTH,INCOMING, oderOUTGOING

Erforderlich — Ja

Standardwert – Kein

Ziel.Typ

Beschreibung — Art des Ziels. Nur Amazon S3 ist zulässig.

Zulässige Werte — Amazon S3

Erforderlich — Ja

Standardwert – Kein

Ziel.Standort

Beschreibung — Ein gültiger Amazon S3 S3-Bucket und ein optionales Amazon S3 S3-Schlüsselpräfix. Der Bucket muss über Berechtigungen für den Amazon Chime SDK Voice Connector-Service Principal, voiceconnector.chime.amazonaws.com, verfügen.

Zulässige Werte — Ein gültiger Amazon S3 S3-Pfad, für den das Amazon Chime SDK über Berechtigungen für dies3:PutObjects3:PutObjectAcl AND-Aktionen verfügt.

Erforderlich — Ja

Standardwert – Kein

Festlegen eines Aufnahmeziels

Amazon Chime SDK sendet die Protokolldateien an einen Amazon-S3-Bucket. Der Bucket muss zu IhremAWS -Konto gehören. Sie geben die Position des Buckets imDestination Parameter derStartCallRecording Aktion an. DasType Feld imDestination Parameter muss seinS3. DasLocation Feld besteht aus Ihrem Amazon S3 S3-Bucket sowie einem optionalen Objektschlüsselpräfix, in dem die Anrufaufzeichnung übermittelt wird.

Die SIP-Medienanwendung verwendet das angegebeneLocation Datum und die Uhrzeit des Anrufs, die Transaktions-ID und die Anruf-ID, um den Amazon S3 S3-Objektschlüssel zu formatieren. DieStartCallRecording Aktionsantwort gibt den vollständigen Amazon S3 S3-Objektschlüssel zurück.

Wenn Sie nur den Amazon S3 S3-Bucket imLocation Feld angeben, hängt die SIP-Medienanwendung ein Standardpräfix,Amazon-Chime-SMA-Call-Recordings, an den Amazon S3 S3-Pfad an. Die SIP-Medienanwendung fügt außerdem das Jahr, den Monat und den Tag der Startzeit des Anrufs hinzu, um die Aufzeichnungen zu organisieren. Das folgende Beispiel zeigt das allgemeine Format eines Amazon S3-Pfads mit dem Standardpräfix. In diesem Beispiel wirdmyRecordingBucket alsLocation Wert verwendet.

myRecordingBucket/Amazon-Chime-SMA-Call-Recordings/2019/03/01/2019–03–01–17–10–00–010_c4640e3b–1478–40fb-8e38–6f6213adf70b_7ab7748e–b47d–4620-ae2c–152617d3333c.wav

Das folgende Beispiel zeigt die Daten, die im Amazon S3 S3-Pfad zur Anrufaufzeichnung dargestellt sind.

s3Bucket/Amazon-Chime-SMA-Call-Recordings/year/month/date/year-month-date-hour-minute-second-millisecond_transactionId_callId.wav

Wenn Sie den Amazon S3 S3-Bucket und das Objektschlüsselpräfix in dasLocation Feld eingeben, verwendet die SIP-Medienanwendung Ihr Objektschlüsselpräfix im Amazon S3 S3-Zielpfad anstelle des Standardpräfixes. Das folgende Beispiel zeigt das allgemeine Format eines Amazon S3 S3-Pfads zur Anrufaufzeichnung mit Ihrem Präfix. Beispielsweise können Sie myRecordingBucket /TechnicalSupport/English als das angebenLocation.

myRecordingBucket/technicalSupport/english/2019/03/01/2019–03–01–17–10–00–010_c4640e3b1478–40fb–8e38-6f6213adf70b_7ab7748e–b47d–4620–ae2c–152617d3333c.wav

Das folgende Beispiel zeigt die Daten im Amazon-S3-Pfad.

s3Bucket/yourObjectKeyPrefix/year/month/date/year-month-date-hour-minute-second-millisecond_transactionId_callId.wav

Die an Ihren Amazon S3 S3-Bucket gesendete Aufzeichnung enthält zusätzliche Amazon S3 S3-Objektmetadaten zum Anrufabschnitt. In der folgenden Tabelle sind die unterstützten Amazon-S3-Objektmetadaten aufgeführt.

Name	Beschreibung
Transaktions-ID	Transaktions-ID des Telefongesprächs
Anruf-ID	CallId des CallDetails Teilnehmers amAWS Lambda Funktionsaufruf
Aufnahmedauer	Dauer der Anrufaufzeichnung in Sekunden
recording-audio-file-format	Audiodateiformat für die Anrufaufzeichnung, dargestellt als Internet-Medientyp

Amazon S3 S3-Bucket-Berechtigungen gewähren

Ihr Amazon S3-Ziel-Bucket muss zu demselbenAWS Konto gehören wie Ihre Anwendung. Darüber hinaus muss die Aktion dem Amazon Chime SDK Voice Connector Service Principal eines3:PutObjectAcl Genehmigung erteilenvoiceconnector.chime.amazonaws.com.s3:PutObject Im folgenden Beispiel wird die entsprechende Berechtigung erteilt.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "SIP media applicationRead",
            "Effect": "Allow",
            "Principal": {
                "Service": "voiceconnector.chime.amazonaws.com"
            },
            "Action": [                
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": "arn:aws:s3:::bucket-name/*",
	    "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "aws-account-id"
                }
            }
        }
    ]
}

Der PSTN Audio Service liest und schreibt im Namen Ihrer Sip Media-Anwendung in Ihren S3-Bucket. Um das verwirrte Stellvertreterproblem zu vermeiden, können Sie die S3-Bucket-Berechtigungen auf eine einzelne SIP-Medienanwendung beschränken.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "SIP media applicationRead",
            "Effect": "Allow",
            "Principal": {
                "Service": "voiceconnector.chime.amazonaws.com"
            },
            "Action": [                
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": "arn:aws:s3:::bucket-name/*",
	    "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "aws-account-id",
                    "aws:SourceArn": "arn:aws:chime:region:aws-account-id:sma/sip-media-application-id"
                }
            }
        }
    ]
}
    

Aktion: erfolgreiche Reaktion

Wenn die Anrufaufzeichnung auf einer Anrufstrecke erfolgreich gestartet wurde, ruft die SIP-Medienanwendung eineAWS Lambda Funktion mit demACTION_SUCCESSFUL Ereignistyp auf. Der Ort der Anrufaufzeichnung wird in der Antwort zurückgegeben.

{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type" : "StartCallRecording",
        "Parameters": {
            "CallId": "call-id-1",
            "Track": "BOTH",
            "Destination": {
                "Type": "S3",
                "Location": "valid-bucket-name"
            }
        }
        "CallRecordingDestination": {
            "Type": "S3",
            "Location": "call-recording-bucket-and-key"
        }
    }
    "CallDetails": {
        ...
    }
}

Antwort auf einen Fehler

Bei Validierungsfehlern ruft die SIP-Medienanwendung dieAWS Lambda Funktion mit der entsprechenden Fehlermeldung auf. In der folgenden Tabelle sind die Fehlermeldungen aufgeführt.

Fehler	Fehlermeldung	Grund
InvalidActionParameter	CallIdParameter für Aktion ist ungültig	Jeder Parameter ist ungültig.
SystemException	Systemfehler beim Ausführen einer Aktion.	Beim Ausführen einer Aktion ist ein anderer Systemfehler aufgetreten.

Wenn die Aktion die Medien auf einer Anrufablage nicht aufzeichnen kann, ruft die SIP-Medienanwendung eineAWS Lambda Funktion mit demActionFailed Ereignistyp auf.

Das folgende Beispiel zeigt eine typische Fehlerantworterantwort.

{
    "SchemaVersion": "1.0",
    "Sequence": 5,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type" : "StartCallRecording",
        "Parameters": {
            "CallId": "call-id-1",
            "Track": "BOTH",
            "Destination": {
                "Type": "S3",
                "Location": "valid-bucket-name"
            }
        }
        "Error": "NoAccessToDestination: Error while accessing destination"
    }
    "CallDetails": {
        ...
    }
}

Ein funktionierendes Beispiel finden Sie auf GitHub: https://github.com/aws-samples/amazon-chime-sma-on -demand-recording