Chilkat Online Tools

C / Plivo REST API / Cold transfer a caller

Back to Collection Items

#include <C_CkHttp.h>
#include <C_CkJsonObject.h>
#include <C_CkHttpResponse.h>

void ChilkatSample(void)
    {
    HCkHttp http;
    BOOL success;
    HCkJsonObject json;
    HCkHttpResponse resp;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    http = CkHttp_Create();

    CkHttp_putBasicAuth(http,TRUE);
    CkHttp_putLogin(http,"{{auth_id}}");
    CkHttp_putPassword(http,"password");

    // Use this online tool to generate code from sample JSON: Generate Code to Create JSON

    // The following JSON is sent in the request body.

    // {
    //   "action": "cold_transfer",
    //   "to": "+14152225555",
    //   "role": "agent",
    //   "trigger_source": "+14152223333"
    // }

    json = CkJsonObject_Create();
    CkJsonObject_UpdateString(json,"action","cold_transfer");
    CkJsonObject_UpdateString(json,"to","+14152225555");
    CkJsonObject_UpdateString(json,"role","agent");
    CkJsonObject_UpdateString(json,"trigger_source","+14152223333");

    resp = CkHttp_PostJson3(http,"https://phlorunner.plivo.com/v1/phlo/{phlo_id}/multi_party_call/{node_id}","application/json",json);
    if (CkHttp_getLastMethodSuccess(http) == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        CkJsonObject_Dispose(json);
        return;
    }

    printf("%d\n",CkHttpResponse_getStatusCode(resp));
    printf("%s\n",CkHttpResponse_bodyStr(resp));
    CkHttpResponse_Dispose(resp);


    CkHttp_Dispose(http);
    CkJsonObject_Dispose(json);

    }

Curl Command

curl -X POST
	-u '{{auth_id}}:password'
	-d '{
    "action": "cold_transfer",
    "to": "+14152225555",
    "role": "agent",
    "trigger_source": "+14152223333"
}'
https://phlorunner.plivo.com/v1/phlo/{phlo_id}/multi_party_call/{node_id}

Postman Collection Item JSON

{
  "name": "Cold transfer a caller",
  "request": {
    "method": "POST",
    "header": [
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n    \"action\": \"cold_transfer\",\n    \"to\": \"+14152225555\",\n    \"role\": \"agent\",\n    \"trigger_source\": \"+14152223333\"\n}",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    },
    "url": {
      "raw": "https://phlorunner.plivo.com/v1/phlo/{phlo_id}/multi_party_call/{node_id}",
      "protocol": "https",
      "host": [
        "phlorunner",
        "plivo",
        "com"
      ],
      "path": [
        "v1",
        "phlo",
        "{phlo_id}",
        "multi_party_call",
        "{node_id}"
      ]
    },
    "description": "A User (U1) can transfer the call with a member (U2) on the Multi-Party Call to another user (U3). On Cold transfer, user U2 is connected directly to the user to whom the call is transferred to (U3) and the user initiating the cold transfer is disconnected from the Multi-Party Call.\n\nBelow is the list of arguments that can be passed in this API request, more information can be found [here](https://www.plivo.com/docs/phlo/api/phlo/multi-party-call/update-a-multi-party-call#cold-transfer-a-caller)\n\n| Arguments   | Description | Required/Conditional/Optional     |\n| :---        |    :----:   |          ---: |\n| action      | Set this parameter \"cold_transfer\".| Required  |\n| to   | Phone number or SIP endpoint address of the user to add to the Multi-party Call| Required      |\n| role   | Role of the user added to the Multi-Party Call. Allowed values are 'customer' and 'agent'. Defaults to agent. | Required |\n| trigger_source   | Phone number or SIP endpoint address of the user (agent) initiating the trigger      | Required      |"
  },
  "response": [
    {
      "name": "Cold transfer a caller",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"action\": \"cold_transfer\",\n    \"to\": \"+14152225555\", // Phone number or SIP endpoint address of the user to which the call has to be transferred\n    \"role\": \"agent\", // Role of the user added to the Multi-Party Call. Allowed values are 'customer' and 'agent'. Defaults to agent.\n    \"trigger_source\": \"+14152223333\" // Phone number or SIP endpoint address of the user(agent) initiating the transfer\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "https://phlorunner.plivo.com/v1/phlo/{phlo_id}/multi_party_call/{node_id}",
          "protocol": "https",
          "host": [
            "phlorunner",
            "plivo",
            "com"
          ],
          "path": [
            "v1",
            "phlo",
            "{phlo_id}",
            "multi_party_call",
            "{node_id}"
          ]
        }
      },
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
      ],
      "cookie": [
      ],
      "body": "{\n    \"api_id\": \"8c77b816-d621-4028-afc8-1aeab1d497a8\",\n    \"error\": \"\"\n}"
    }
  ]
}