Dritten zu einem Anruf hinzufügen

In diesem Dokument wird erläutert, wie Sie mit dem Endpunkt /calls/CALL_ID/dial der Apps API einen Drittanbieter anrufen und dann einem laufenden Anruf hinzufügen. Wenn Sie eine Anfrage an diesen Endpunkt senden, wählt das System automatisch die Telefonnummer des Drittanbieters und im Anrufadapter des Kundenservicemitarbeiters wird der Bildschirm Anruf angezeigt. Das Hinzufügen von Drittanbietern zu Anrufen auf diese Weise funktioniert unabhängig davon, ob der Anrufadapter auf dem Agenten-Desktop, in Ihrem CRM oder im CCAI Platform-Portal ausgeführt wird. Ein Agent muss sich in einem aktiven Anruf befinden, damit dieser Endpunkt funktioniert.

Endpunkt aufrufen

Wenn Sie einem Anruf einen Drittanbieter hinzufügen möchten, senden Sie eine POST-Anfrage an den folgenden Endpunkt:

https://YOUR_CCAAS_HOST/apps/api/v1/calls/CALL_ID/dial

Ersetzen Sie CALL_ID durch die Anruf-ID.

Anfragetext

Das folgende Beispiel zeigt einen Anfragetext:

{
  "agent_email": "AGENT_EMAIL",
  "phone_number": "PHONE_NUMBER"
}

Ersetzen Sie Folgendes:

  • AGENT_EMAIL: Die E-Mail-Adresse des Kundenservicemitarbeiters im Anruf.
  • PHONE_NUMBER: Die Telefonnummer des Drittanbieters, der dem Anruf hinzugefügt werden soll.

Antwort

Die entsprechende Ausgabe sieht etwa so aus:

Erfolgsantwort

{
    "message": "Third party dialing initiated",
    "participant": {
        "id": 54321,
        "type": "third_party",
        "status": "connecting"
    }
}

Fehlerantworten

  • 400 Bad Request: phone_number oder agent_email fehlt oder ist leer. Text: {"message": "param is missing or the value is empty: <name>"}.
  • 400 Bad Request: agent_email stimmt mit keinem bekannten Nutzer überein. Body: {"message": "Invalid agent_email"}.
  • 401 Unauthorized – Authentifizierung fehlgeschlagen. Body: {"message": "Not Authorized"}.
  • 404 Not Found – Es gibt keinen Anruf mit der angegebenen call_id. Body: {"message": "Not Found"}.
  • 422 Unprocessable Entity: Der durch agent_email identifizierte Agent ist nicht mit dem Anruf verbunden. Body: {"message": "Agent is not connected to the call"}.
  • 422 Unprocessable Entity: Der Anruf konnte nicht gestartet werden. Dies umfasst Fehler bei der Normalisierung von Telefonnummern und Fehler beim Starten des Anrufs durch den Anbieter. Text: {"message": "Error dialing third party"}.
  • 500 Internal Server Error – unerwarteter Fehler beim Wählen. Text: {"message": "Unexpected error dialing third party"}.