Call https-Posts API

Die API für HTTPS-POST dient zur Übermittlung von Anrufinformationen in Echtzeit an externe Kundensysteme. Dabei werden die Anrufdaten – wie Anrufernummer, gewählte Nummer, Datum, Uhrzeit sowie gegebenenfalls DTMF-Eingaben – über die TENIOS-API per HTTPS-POST übergeben. Die Übermittlung erfolgt wahlweise zu Beginn oder am Ende der Verbindung sowie optional nach jedem Call-Block.

Mit HTTPS-POST-Anfragen können Sie beispielsweise externe Systeme anbinden, um Anrufzählung oder Reporting auf einem anderen System zu integrieren. Anhand der Anrufernummer oder einer Kunden-/Ticketnummer können auch Call-to-Action- oder Screenpop-Funktionen im CRM- oder ERP-System ausgelöst werden. So stehen dem Mitarbeiter bereits vor der Anrufannahme relevante Informationen wie Kundendaten, Ticketdetails oder anrufbezogene Hinweise auf dem Bildschirm zur Verfügung.

Die HTTPS-POST-Requests werden von der IP-Adresse 80.239.139.193 gesendet. Bitte stellen Sie sicher, dass diese IP-Adresse in Ihrer Firewall freigegeben ist, damit die Anrufdaten Ihr System erreichen können.

Die Einstellungen für HTTPS-POST werden pro Rufnummer im Routing vorgenommen. Details finden Sie hier.

Aufbau der Post-Requests:

Post beim Start

{
   "requestType": "CALL_START",
   "customerNumber": 200000,
   "accessKey": "XXXXXXXXX",
   "variables": {
      "destination_number": "+4922155400300",
      "correlation_id": "XXXXXXXXX",
      "call_uuid": "XXXXXXXXX",
      "caller_id_number": "+4917012345678"
   }
}

Post nach jedem Block

{
   "requestType": "BLOCK_END",
   "customerNumber": 200000,
   "accessKey": "XXXXXXXXX",
   "variables": {
      "destination_number": "+4922155400300",
      "correlation_id": "XXXXXXXXX",
      "call_uuid": "XXXXXXXXX",
      "caller_id_number": "+49170123456"
   },
   "blockType": "ANNOUNCEMENT"
}

Post am Ende/Auflegen

{
   "requestType": "CALL_END",
   "customerNumber": 20000,
   "accessKey": "XXXXXXXXX",
   "variables": {
      "destination_number": "+4922155400300",
      "correlation_id": "XXXXXXXXX",
      "call_uuid": "XXXXXXXXX",
      "caller_id_number": "+49170123456"
   }
}

Post bei Initiieren der Anrufweiterleitung

{
   "requestType": "INITIATE_FORWARD",
   "customerNumber": 200000,
   "accessKey": "XXXXXXXXXX",
   "variables": {
      "destination_number": "+4922155400300",
      "correlation_id": "XXXXXXXXX",
      "call_uuid": "XXXXXXXXX",
      "caller_id_number": "+49170123456"
   },
   "destination": "+492212345678",
   "destinationType": "EXTERNALNUMBER"
}

Post bei Annahme der Anrufweiterleitung

{
   "requestType": "FORWARD_ANSWER",
   "customerNumber": 200000,
   "accessKey": "XXXXXXXXXX",
   "variables": {
      "destination_number": "+4922155400300",
      "correlation_id": "XXXXXXXXX",
      "call_uuid": "XXXXXXXXX",
      "caller_id_number": "+49170123456"
   },
   "destination": "+492212345678",
   "destinationType": "EXTERNALNUMBER"
}