APIs zur Aufzeichnung bei Bedarf

Diese API ist nur für CXone Multi-ACD (CXone Open) -Benutzer verfügbar.

Diese APIs ermöglichen das Starten, Beenden und Deaktivieren der Anrufaufzeichnung bei Bedarf,d. h. die Steuerung der Aufzeichnung erfolgt über APIs.

Bevor Sie beginnen

Bevor Sie mit der Nutzung der APIs zum Maskieren und zum Aufheben der Maskierung beginnen können, müssen Sie eine Benutzerberechtigung einrichten, einen Zugriffsschlüssel generieren und den Registrierungs- und Authentifizierungsprozess befolgen, der im Entwicklerportal erklärt wird.

Für die API ist die Berechtigung Suche & Wiedergabe > APIs > API zur Multi-ACD-Aufzeichnung bei Bedarf erforderlich.

POST Aufzeichnung bei Bedarf starten

Die API ermöglicht einem Agenten oder einer Anwendung, die Aufzeichnung eines laufenden Anrufs für einen bestimmten Benutzer zu starten. Sie kann verwendet werden, um bestimmte Interaktionen oder Gespräche für Konformitäts-, Qualitätssicherungs- oder Schulungszwecke aufzuzeichnen.

Sie können festlegen, ob die Aufzeichnung nur für Sprache oder für Sprache und Bildschirm gestartet wird. Diese API hat Vorrang vor Aufzeichnungsrichtlinien.

Das Flag mediaType ist optional und ermöglicht die Steuerung der aufzuzeichnenden Medientypen. Die unterstützten Werte sind voice und voiceAndScreen, die es ermöglichen, die Aufzeichnung nur für Sprache oder für Sprache und Bildschirm zu starten. Wenn das Flag nicht angegeben ist, lautet der Standardwert voice.

userId*:

String

Der aufzuzeichnende Medientyp.

POST /interaction-recording-management-service/interactions/start-recording-on-demand?user-id=1234567

Antwort

  • Status 200 – Erfolgreicher Vorgang. Die Anforderung zum Starten der Aufzeichnung bei Bedarf wurde gestartet.

  • Status 202 – Vorgang wird ausgeführt. Die Anforderung zum Starten der Aufzeichnung bei Bedarf wurde akzeptiert und wird verarbeitet.

  • Status 400 – Fehlerhafte Anfrage.

  • Status 401 – Der anfordernde Benutzer konnte nicht authentifiziert werden.

  • Status 403 – Der anfordernde Benutzer ist nicht berechtigt, den Vorgang auszuführen.

  • Status 404 – Nicht gefunden. Es wurden keine aktiven Interaktionen gefunden.

  • Status 409 – Die Anforderung kann aufgrund des Dienststatus nicht aufgeführt werden.

  • Status 425 – Die Interaktion ist gesperrt, während eine vorherige Anforderung zum Starten bzw. Beenden der Aufzeichnung bei Bedarf verarbeitet wird.

  • Status 500 – Interner Serverfehler.

  • Status 504 – Zeitüberschreitung bei Anforderung.

POST Aufzeichnung bei Bedarf beenden

Die API ermöglicht das Beenden der Sprache- und Bildschirmaufzeichnung eines laufenden Anrufs für einen bestimmten Benutzer. Sie kann für den Datenschutz des Kunden oder zur Einhaltung von Vorschriften verwendet werden, die die Aufzeichnung bestimmter Gesprächsarten einschränken.

Diese API hat Vorrang vor Aufzeichnungsrichtlinien. Nach dem Aufruf der API zum Beenden der Aufzeichnung bei Bedarf kann die Aufzeichnung nur durch Aufruf der API Aufzeichnung bei Bedarf starten fortgesetzt werden.

userId*:

String

Benutzer-ID des Agenten, der aufgezeichnet werden soll.

POST /interaction-recording-management-service/interactions/stop-recording-on-demand?user-id=1234567

Antwort

  • Status 200 – Erfolgreicher Vorgang. Die Anforderung zum Beenden der Aufzeichnung bei Bedarf wurde gestartet.

  • Status 202 – Vorgang wird ausgeführt. Die Anforderung zum Beenden der Aufzeichnung bei Bedarf wurde akzeptiert und wird verarbeitet.

  • Status 400 – Fehlerhafte Anfrage.

  • Status 401 – Der anfordernde Benutzer konnte nicht authentifiziert werden.

  • Status 403 – Der anfordernde Benutzer ist nicht berechtigt, den Vorgang auszuführen.

  • Status 404 – Nicht gefunden. Es wurden keine aktiven Interaktionen gefunden.

  • Status 409 – Die Anforderung kann aufgrund des Dienststatus nicht aufgeführt werden.

  • Status 425 – Die Interaktion ist gesperrt, während eine vorherige Anforderung zum Starten bzw. Beenden der Aufzeichnung bei Bedarf verarbeitet wird.

  • Status 500 – Interner Serverfehler.

  • Status 504 – Zeitüberschreitung bei Anforderung.

POST Option zur Anrufaufzeichnung deaktivieren

Diese API ermöglicht die Deaktivierung der Option zur Aufzeichnung von Sprache und Bildschirm eines Anrufs für den Fall, dass der Kunde seine Einwilligung ablehnt und der Aufzeichnung nicht zustimmt. Dies gilt insbesondere für die EU-Datenschutzgrundverordnung (DSGVO). Wenn ein Kunde ablehnt, dann zeichnet CXone Recording den Anruf nicht auf, auch wenn eine Aufzeichnungsrichtlinie zum Aufzeichnen des Anrufs festgelegt ist oder der Agent den Anruf bei Bedarf oder mit einer API aufzeichnet.

Die API zur Deaktivierung der Anrufaufzeichnung kann nicht für den gesamten Kundenkontakt, einschließlich Weiterleitungen, Rücksprachen und Konferenzen, initiiert werden. Wenn die API während einer Anrufaufzeichnung aufgerufen wird, beendet CXone Recording die Aufzeichnung. Der aufgezeichnete Teil des Anrufs ist für die Suche und Wiedergabe verfügbar.

Die Einwilligung zur Aufzeichnung gilt nur für den aktuellen Anruf. Sie wird nicht für zukünftige Interaktionen für den Kunden gespeichert.

userId*:

String

Benutzer-ID des Agenten, der aufgezeichnet werden soll.

POST /interaction-recording-management-service/interactions/do-not-record?user-id=1234567

Antwort

  • Status 200 – Erfolgreicher Vorgang. Die "Nicht aufzeichnen“-Anforderung wurde gestartet.

  • Status 202 – Vorgang wird ausgeführt. Die "Nicht aufzeichnen"-Anforderung wurde akzeptiert und wird verarbeitet.

  • Status 400 – Fehlerhafte Anfrage.

  • Status 401 – Der anfordernde Benutzer konnte nicht authentifiziert werden.

  • Status 403 – Der anfordernde Benutzer ist nicht berechtigt, den Vorgang auszuführen.

  • Status 404 – Nicht gefunden. Es wurden keine aktiven Interaktionen gefunden.

  • Status 409 – Die Anforderung kann aufgrund des Dienststatus nicht aufgeführt werden.

  • Status 425 – Die Interaktion ist gesperrt, während eine vorherige Anforderung verarbeitet wird.

  • Status 500 – Interner Serverfehler.

  • Status 504 – Zeitüberschreitung bei Anforderung.