Jump to: navigation, search
(Undo revision 329500 by Jumunn (talk))
Line 49: Line 49:
  
 
===Request===
 
===Request===
−
<pre>
+
<source lang="text">
−
POST api/v2/me/devices/efe1ab32-53f9-43ce-b65e-5768c61f7d4a/calls
+
POST api/v2/me/devices/631608b3-ceb1-472b-ba05-2ae39555b0d1/calls
 
   
 
   
 
{
 
{
 
   "operationName": "Dial",
 
   "operationName": "Dial",
 
   "destination": {
 
   "destination": {
−
     "phoneNumber": "5001"
+
     "phoneNumber": "15002"
 
   }
 
   }
 
}
 
}
−
</pre>
+
</source>
  
 
===Response===
 
===Response===
−
<pre>
+
<source lang="text">
 
{
 
{
 
   "statusCode": 0
 
   "statusCode": 0
 
}
 
}
−
</pre>
+
</source>
  
 
===Notification===
 
===Notification===
−
<pre>
+
<source lang="text">
−
{
+
{
−
  "data": {
+
  "data":{
−
    "messageType": "CallStateChangeMessage",
+
      "notificationType":"StatusChange",
−
    "notificationType": "StatusChange",
+
       "call":{
−
    "extensions": {
+
        "id":"012PUFMMS0ASNAK48O7GK2LAES000004",
−
      "WrapUpTime": 0,
+
        "state":"Dialing",
−
       "BusinessCall": 0
+
        "callUuid":"012PUFMMS0ASNAK48O7GK2LAES000004",
−
    },
+
        "connId":"007102719260b004",
−
    "call": {
+
        "deviceUri":"http://127.0.0.1:8080/api/v2/devices/631608b3-ceb1-472b-ba05-2ae39555b0d1",
−
      "id": "013V08JRL498H1OI04000VTAES00000G",
+
        "participants":[ 
−
      "connId": "0072026cb98d140f",
+
            { 
−
      "state": "Dialing",
+
              "e164Number":"",
−
      "callUuid": "013V08JRL498H1OI04000VTAES00000G",
+
              "formattedPhoneNumber":"15002",
−
      "deviceUri": "http://127.0.0.1:8080/api/v2/devices/efe1ab32-53f9-43ce-b65e-5768c61f7d4a",
+
              "phoneNumber":"15002",
−
      "uri": "http://127.0.0.1:8080/api/v2/me/calls/013V08JRL498H1OI04000VTAES00000G",
+
              "digits":"15002"
−
      "participants": [
+
            }
−
        "5001"
+
        ],
−
      ],
+
        "dnis":"15002",
−
      "participantsInfo": [
+
        "callType":"Internal",
−
        {
+
        "capabilities":[
−
          "digits": "5001",
+
            "SendDtmf",
−
          "e164Number": "5001",
+
            "DeleteUserData",
−
          "formattedPhoneNumber": "5001"
+
            "AttachUserData",
−
        }
+
            "DeleteUserDataPair",
−
      ],
+
            "Hangup",
−
      "dnis": "5001",
+
            "UpdateUserData"
−
      "callType": "Internal",
+
        ],
−
      "capabilities": [
+
        "duration":"0",
−
        "DeleteUserDataPair",
+
        "mute":"Off",
−
        "AttachUserData",
+
        "supervisorListeningIn":false,
−
        "Hangup",
+
        "monitoredUserMuted":false,
−
        "DeleteUserData",
+
        "monitoring":false,
−
        "SendDtmf",
+
        "uri":"http://127.0.0.1:8080/api/v2/me/calls/012PUFMMS0ASNAK48O7GK2LAES000004",
−
        "UpdateUserData"
+
        "path":"/calls/012PUFMMS0ASNAK48O7GK2LAES000004"
−
      ],
+
      },
−
      "duration": "0",
+
      "phoneNumber":"15000",
−
      "mute": "Off",
+
      "extensions":{ 
−
      "supervisorListeningIn": false,
+
        "BusinessCall":0
−
      "monitoredUserMuted": false
+
      },
−
    },
+
      "messageType":"CallStateChangeMessage"
−
    "phoneNumber": "5005"
+
  },
−
  },
+
  "channel":"/v2/me/calls"
−
  "channel": "/v2/me/calls"
 
 
}
 
}
−
</pre>
+
</source>
  
 
==Sample #2==
 
==Sample #2==
Line 119: Line 118:
  
 
===Request===
 
===Request===
−
<pre>
+
<source lang="text">
−
POST api/v2/me/devices/efe1ab32-53f9-43ce-b65e-5768c61f7d4a/calls
+
POST api/v2/me/devices/631608b3-ceb1-472b-ba05-2ae39555b0d1/calls
 
{
 
{
 
   "operationName": "Dial",
 
   "operationName": "Dial",
 
   "destination": {
 
   "destination": {
−
     "phoneNumber": "5001"
+
     "phoneNumber": "15002"
 
   },
 
   },
 
   "userData": {
 
   "userData": {
Line 130: Line 129:
 
   }
 
   }
 
}
 
}
−
</pre>
+
</source>
  
 
===Response===
 
===Response===
−
<pre>
+
<source lang="text">
 
{
 
{
 
   "statusCode": 0
 
   "statusCode": 0
 
}
 
}
−
</pre>
+
</source>
  
  
 
===Notification===
 
===Notification===
−
<pre>
+
<source lang="text">
−
{
+
{
−
  "data": {
+
  "data":{
−
    "messageType": "CallStateChangeMessage",
+
      "notificationType":"StatusChange",
−
    "notificationType": "StatusChange",
+
       "call":{
−
    "extensions": {
+
        "id":"012PUFMMS0ASNAK48O7GK2LAES000004",
−
       "WrapUpTime": 0,
+
        "state":"Dialing",
−
      "BusinessCall": 0
+
        "callUuid":"012PUFMMS0ASNAK48O7GK2LAES000004",
−
    },
+
        "connId":"007102719260b004",
−
    "call": {
+
        "deviceUri":"http://127.0.0.1:8080/api/v2/devices/631608b3-ceb1-472b-ba05-2ae39555b0d1",
−
      "id": "01NOSKNPB8AT3D4MUTCJ82LAES000111",
+
        "participants":[ 
−
      "connId": "0072026cb98d140e",
+
            { 
−
      "state": "Dialing",
+
              "e164Number":"",
−
      "callUuid": "01NOSKNPB8AT3D4MUTCJ82LAES000111",
+
              "formattedPhoneNumber":"15002",
−
      "deviceUri": "http://127.0.0.1:8080/api/v2/devices/efe1ab32-53f9-43ce-b65e-5768c61f7d4a",
+
              "phoneNumber":"15002",
−
      "uri": "http://127.0.0.1:8080/api/v2/me/calls/01NOSKNPB8AT3D4MUTCJ82LAES000111",
+
              "digits":"15002"
−
      "participants": [
+
            }
−
        "5001"
+
        ],
−
      ],
+
        "dnis":"15002",
−
      "participantsInfo": [
+
        "callType":"Internal",
−
        {
+
        "capabilities":[ 
−
          "digits": "5001",
+
            "SendDtmf",
−
          "e164Number": "5001",
+
            "DeleteUserData",
−
          "formattedPhoneNumber": "5001"
+
            "AttachUserData",
−
        }
+
            "DeleteUserDataPair",
−
      ],
+
            "Hangup",
−
      "dnis": "5001",
+
            "UpdateUserData"
−
      "callType": "Internal",
+
        ],
−
      "capabilities": [
+
        "userData":{ 
−
        "DeleteUserDataPair",
+
            "CustomerSegment":"Gold"
−
        "AttachUserData",
+
        },
−
        "Hangup",
+
        "duration":"0",
−
        "DeleteUserData",
+
        "mute":"Off",
−
        "SendDtmf",
+
        "supervisorListeningIn":false,
−
        "UpdateUserData"
+
        "monitoredUserMuted":false,
−
       ],
+
        "monitoring":false,
−
       "userData": {
+
        "uri":"http://127.0.0.1:8080/api/v2/me/calls/012PUFMMS0ASNAK48O7GK2LAES000004",
−
        "CustomerSegment": "Gold"
+
        "path":"/calls/012PUFMMS0ASNAK48O7GK2LAES000004"
 +
       },
 +
       "phoneNumber":"15000",
 +
      "extensions":{ 
 +
        "BusinessCall":0
 
       },
 
       },
−
       "duration": "0",
+
       "messageType":"CallStateChangeMessage"
−
      "mute": "Off",
+
  },
−
      "supervisorListeningIn": false,
+
  "channel":"/v2/me/calls"
−
      "monitoredUserMuted": false
 
−
    },
 
−
    "phoneNumber": "5005"
 
−
  },
 
−
  "channel": "/v2/me/calls"
 
 
}
 
}
−
</pre>
+
</source>
  
  
 
[[Category:V:HTCC:8.5.2]]
 
[[Category:V:HTCC:8.5.2]]

Revision as of 23:14, December 20, 2015

Dial

This operation is part of the Voice API section of the Genesys Web Services REST API.

Overview

Initiates a new outbound call to the specified destination.

Request URL /api/v2/me/devices/{id}/calls
HTTP Method POST
Required Features api-voice

Parameters

Parameter Value
operationName Dial
destination A JSON object that includes the number to be dialed: 
{ 
  "phoneNumber": "5551212" 
}
location An optional parameter that is used by GWS to set the "location" attribute for the corresponding TServer requests.
userData An optional JSON object that includes key/value data to be included with the call: 
{
  "Product": "Guitars"
}

Sample #1

Request

POST api/v2/me/devices/631608b3-ceb1-472b-ba05-2ae39555b0d1/calls
 
{
  "operationName": "Dial",
  "destination": {
    "phoneNumber": "15002"
  }
}

Response

{
  "statusCode": 0
}

Notification

{  
   "data":{  
      "notificationType":"StatusChange",
      "call":{  
         "id":"012PUFMMS0ASNAK48O7GK2LAES000004",
         "state":"Dialing",
         "callUuid":"012PUFMMS0ASNAK48O7GK2LAES000004",
         "connId":"007102719260b004",
         "deviceUri":"http://127.0.0.1:8080/api/v2/devices/631608b3-ceb1-472b-ba05-2ae39555b0d1",
         "participants":[  
            {  
               "e164Number":"",
               "formattedPhoneNumber":"15002",
               "phoneNumber":"15002",
               "digits":"15002"
            }
         ],
         "dnis":"15002",
         "callType":"Internal",
         "capabilities":[  
            "SendDtmf",
            "DeleteUserData",
            "AttachUserData",
            "DeleteUserDataPair",
            "Hangup",
            "UpdateUserData"
         ],
         "duration":"0",
         "mute":"Off",
         "supervisorListeningIn":false,
         "monitoredUserMuted":false,
         "monitoring":false,
         "uri":"http://127.0.0.1:8080/api/v2/me/calls/012PUFMMS0ASNAK48O7GK2LAES000004",
         "path":"/calls/012PUFMMS0ASNAK48O7GK2LAES000004"
      },
      "phoneNumber":"15000",
      "extensions":{  
         "BusinessCall":0
      },
      "messageType":"CallStateChangeMessage"
   },
   "channel":"/v2/me/calls"
}

Sample #2

This sample includes a key/value pair with the Dial request:

Request

POST api/v2/me/devices/631608b3-ceb1-472b-ba05-2ae39555b0d1/calls
{
  "operationName": "Dial",
  "destination": {
    "phoneNumber": "15002"
  },
  "userData": {
    "CustomerSegment": "Gold"
  }
}

Response

{
  "statusCode": 0
}


Notification

{  
   "data":{  
      "notificationType":"StatusChange",
      "call":{  
         "id":"012PUFMMS0ASNAK48O7GK2LAES000004",
         "state":"Dialing",
         "callUuid":"012PUFMMS0ASNAK48O7GK2LAES000004",
         "connId":"007102719260b004",
         "deviceUri":"http://127.0.0.1:8080/api/v2/devices/631608b3-ceb1-472b-ba05-2ae39555b0d1",
         "participants":[  
            {  
               "e164Number":"",
               "formattedPhoneNumber":"15002",
               "phoneNumber":"15002",
               "digits":"15002"
            }
         ],
         "dnis":"15002",
         "callType":"Internal",
         "capabilities":[  
            "SendDtmf",
            "DeleteUserData",
            "AttachUserData",
            "DeleteUserDataPair",
            "Hangup",
            "UpdateUserData"
         ],
         "userData":{  
            "CustomerSegment":"Gold"
         },
         "duration":"0",
         "mute":"Off",
         "supervisorListeningIn":false,
         "monitoredUserMuted":false,
         "monitoring":false,
         "uri":"http://127.0.0.1:8080/api/v2/me/calls/012PUFMMS0ASNAK48O7GK2LAES000004",
         "path":"/calls/012PUFMMS0ASNAK48O7GK2LAES000004"
      },
      "phoneNumber":"15000",
      "extensions":{  
         "BusinessCall":0
      },
      "messageType":"CallStateChangeMessage"
   },
   "channel":"/v2/me/calls"
}
Comments or questions about this documentation? Contact us for support!