Fragen? 0800 55400300
View Categories

Call https-Posts API

1 min read

The API for Call https-Post is used to transfer call information to customer systems in real time. The call data (caller, dialed number, date, time and, if applicable, DTMF input) are transferred via the TENIOS API at the beginning or at the end of the connection and optionally via https post after each call block. With https-Post Requests you can connect external systems, for example, to integrate call counting or reporting on another system. The caller number or customer/ticket number can also be used to carry out call-to-action or screenpop functions in CRM/ERP. This means that the employee has on-screen information such as customer data, ticket details or call-relevant information before the call is accepted.

The settings for the https mail are made for each phone number in routing. More details can be found on page Edit routing.

 

Structure of the post-requests:

Post on call start

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

Post after each 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 on call end

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

Post on intiate call forward

{
   "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 on answering call forward

{
   "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"
}
TOP