Arbeiten mit exportierten Aufzeichnungen im AWS S3-Bucket
Nachdem die AWS S3 Integration von Massenaufzeichnungen eingerichtet ist, können Sie Aufzeichnungen, die sich in Genesys Cloud befinden, in Massen in Ihren AWS S3 Bucket exportieren. Dieser Export kann automatisch über eine QM-Richtlinie oder explizit durch Aufruf der API für Massenaufzeichnungsaktionen erfolgen.
Dieser Artikel beschreibt den Inhalt, der in Ihr AWS S3-Bucket exportiert wird.
Inhalt des AWS S3-Buckets
Aufzeichnungsdateien werden in den AWS S3-Bucket in Ordnern mit der folgenden Struktur exportiert:
s3://{bucket}/{organizationId}/year={year}/{month={month}/day={day}/hour={hourOfDay}/conversation_id={conversationId}/
| Platzhalter | Beschreibung |
|---|---|
| (Eimer) | Der Name des S3-Buckets. |
| {OrganisationId} | Die Organisations-ID. |
| {Jahr} | Das Jahr, in dem das Gespräch begann. |
| {Monat} | Der Monat, in dem das Gespräch begann (in Ziffern). |
| {day} | Der Tag, an dem das Gespräch begann. |
| {hourOfDay} |
Die Stunde, in der das Gespräch begann. |
| {conversationId} |
Die Konversations-ID. |
Der Ordner enthält alle Aufzeichnungsdateien, die während des Gesprächs gespeichert werden. Jede Aufzeichnungsdatei enthält eine Aufzeichnung, und der Name der Datei ist die Aufzeichnungs-ID.
Jede Aufzeichnungsdatei hat eine entsprechende JSON-Metadatendatei. Der Name der JSON-Metadaten-Datei wird mit dem Suffix "_metadata.json" versehen.
Die Metadaten können für die Suche nach der exportierten Aufnahme verwendet werden. Weitere Informationen finden Sie im Athena+Glue Beispiel (ein Beispiel für einen Aufzeichnungssuchdienst).
Die Metadaten-Datei ist im JSON-Format mit dem folgenden Schema.
{
"$Schema": "http://json-schema.org/draft-04/schema#",
"Typ": "Objekt",
"Eigenschaften": {
"mediaType": {
"Beschreibung": "Medientyp (einer von Anruf, Chat, E-Mail, Nachricht, Rückruf, Bildschirm)",
"Typ": "string"
},
"Anbieter": {
"Beschreibung": "Art des Anbieters für die Aufzeichnung, z. B. Rand",
"Typ": "string"
},
"userIds": {
"Beschreibung": "Liste der Benutzer",
"Typ": "array",
"Elemente": [
{
"Typ": "string"
}
]
},
"startTime": {
"Beschreibung": "Startzeitpunkt der Aufzeichnungen",
"Typ": "string"
},
"endTime": {
"Beschreibung": "Endzeitpunkt der Aufzeichnungen",
"Typ": "string"
},
"DauerMs": {
"Beschreibung": "Dauer der Aufzeichnung",
"Typ": "Ganzzahl"
},
"initialDirection": {
"Beschreibung": "Ursprüngliche Richtung des Gesprächs (eingehend/ausgehend)",
"Typ": "string"
},
"aniNormalisiert": {
"Beschreibung": "ANI",
"Typ": "string"
},
"aniDisplayable": {
"Beschreibung": "ANI in anzeigbarer Form",
"Typ": "string"
},
"dnisNormalized": {
"Beschreibung": "DNIS",
"Typ": "string"
},
"dnisDisplayable": {
"Beschreibung": "DNIS in anzeigbarer Form",
"Typ": "string"
},
"queueIds": {
"Beschreibung": "Liste der Warteschlangen-IDs für die Aufzeichnung",
"Typ": "array",
"Elemente": [
{
"Typ": "string"
}
]
},
"wrapupCodes": {
"Beschreibung": "Nachbereitungscodes für das Gespräch",
"Typ": "array",
"Elemente": [
{
"Typ": "string"
}
]
},
"organisationId": {
"Beschreibung": "Eindeutige ID für das Gespräch",
"Typ": "string"
},
"conversationId": {
"Beschreibung": "Eindeutige ID, die mit der Konversation verbunden ist",
"Typ": "string"
},
"conversationStartTime": {
"Beschreibung": "Uhrzeit des Gesprächsbeginns",
"Typ": "string"
},
"conversationEndTime": {
"Beschreibung": "Endzeitpunkt des Gesprächs",
"Typ": "string"
},
"recordingId": {
"Beschreibung": "Eindeutige ID für die Aufzeichnung",
"Typ": "string"
},
"filePath": {
"Beschreibung": "Originalpfad der Aufzeichnung",
"Typ": "string"
},
"fileSize": {
"Beschreibung": "Größe der Aufzeichnungsdatei",
"Typ": "Ganzzahl"
},
"messageType": {
"Beschreibung": "Art der Nachrichtenplattform, von der die Nachricht stammt, z. B. sms, twitter, line, facebook, whatsapp, webmessaging, open, instagram",
"Typ": "string"
},
"languageIds": {
"Beschreibung": "Kennung der Sprache",
"Typ": "string"
},
"screenInformation": {
"Beschreibung": "Bildschirmspezifische Informationen, einschließlich Bildschirm-ID, X- und Y-Position, Auflösungsinformationen",
"Typ": "Objekt"
}
},
"erforderlich": [
"mediaType",
"Anbieter",
"startTime",
"endTime",
"durationMs",
"organisationId",
"conversationId",
"conversationStartTime",
"conversationEndTime",
"recordingId",
"filePath",
"fileSize"
]
}
Ein Gespräch mit aktivierter Bildschirmaufzeichnung kann beispielsweise den folgenden Ordnerinhalt haben.
In der Abbildung unten ist die .opus-Datei die Audioaufnahmedatei, die .zip-Datei enthält die Bildschirmaufnahmedatei, und die .json-Dateien sind die JSON-Metadaten, die mit den jeweiligen Mediendateien verbunden sind.
Klicken Sie auf das Bild, um es zu vergrößern.
Eine digitale Konversation kann den folgenden Ordnerinhalt haben.
In der Abbildung unten enthält die .zip-Datei die digitale Aufzeichnungsdatei, und die .json-Datei ist die entsprechende JSON-Datei.
Klicken Sie auf das Bild, um es zu vergrößern.
Verschlüsselung
Ihr S3-Bucket ist bereits mit AWS S3 Server-Side Encryption (SSE) konfiguriert. Es kann mit Verschlüsselungsschlüsseln aktiviert worden sein, die von Amazon S3 verwaltet werden (SSE-S3), oder mit den von AWS verwalteten Schlüsseln oder vom Kunden bereitgestellten Schlüsseln vom AWS Key Management Service (SSE-KMS) aktiviert worden sein.
AWS S3 Server-Side Encryption (SSE) sichert die Aufzeichnungsdateien im S3-Bucket im Ruhezustand. Wenn die Dateien aus dem Bucket abgerufen werden, entschlüsselt AWS den Dateiinhalt automatisch.
Wenn Ihr System eine zusätzlich aktivierte Recording Export Encryption enthält, müssen Sie den Dateiinhalt selbst entschlüsseln, nachdem Sie die Dateien aus dem S3-Bucket abgerufen haben.
