C

CallRail API - Update a Call

See more CallRail Examples

Updates a call object in the target account. You can use the API to add a Tag or a Note to a call, or to set the call’s lead status. C

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

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttp http;
    HCkJsonObject json;
    HCkStringBuilder sbRequestBody;
    HCkHttpResponse resp;
    HCkStringBuilder sbResponseBody;
    HCkJsonObject jResp;
    int respStatusCode;
    BOOL answered;
    const char *business_phone_number;
    const char *customer_city;
    const char *customer_country;
    const char *customer_name;
    const char *customer_phone_number;
    const char *customer_state;
    const char *direction;
    int duration;
    const char *id;
    const char *recording;
    const char *recording_duration;
    const char *start_time;
    const char *tracking_phone_number;
    BOOL voicemail;

    success = FALSE;

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

    http = CkHttp_Create();

    // Implements the following CURL command:

    // curl -H "Authorization: Token token={api_token}" \
    //      -X PUT \
    //      -H "Content-Type: application/json" \
    //      -v \
    //      -d '{
    //            "note": "Call customer back tomorrow",
    //            "tags": ["New Client"],
    //            "lead_status": "good_lead",
    //            "value": "$1.00",
    //            "append_tags": true,
    //          }' \
    //         "https://api.callrail.com/v3/a/{account_id}/calls/{call_id}.json"

    // Use the following online tool to generate HTTP code from a CURL command
    // Convert a cURL Command to HTTP Source Code

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

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

    // {
    //   "note": "Call customer back tomorrow",
    //   "tags": [
    //     "New Client"
    //   ],
    //   "lead_status": "good_lead",
    //   "value": "$1.00",
    //   "append_tags": true
    // }

    json = CkJsonObject_Create();
    CkJsonObject_UpdateString(json,"note","Call customer back tomorrow");
    CkJsonObject_UpdateString(json,"tags[0]","New Client");
    CkJsonObject_UpdateString(json,"lead_status","good_lead");
    CkJsonObject_UpdateString(json,"value","$1.00");
    CkJsonObject_UpdateBool(json,"append_tags",TRUE);

    CkHttp_SetRequestHeader(http,"Authorization","Token token={api_token}");
    CkHttp_SetRequestHeader(http,"Content-Type","application/json");

    sbRequestBody = CkStringBuilder_Create();
    CkJsonObject_EmitSb(json,sbRequestBody);

    resp = CkHttpResponse_Create();
    success = CkHttp_HttpSb(http,"PUT","https://api.callrail.com/v3/a/{account_id}/calls/{call_id}.json",sbRequestBody,"utf-8","application/json",resp);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        CkJsonObject_Dispose(json);
        CkStringBuilder_Dispose(sbRequestBody);
        CkHttpResponse_Dispose(resp);
        return;
    }

    sbResponseBody = CkStringBuilder_Create();
    CkHttpResponse_GetBodySb(resp,sbResponseBody);
    jResp = CkJsonObject_Create();
    CkJsonObject_LoadSb(jResp,sbResponseBody);
    CkJsonObject_putEmitCompact(jResp,FALSE);

    printf("Response Body:\n");
    printf("%s\n",CkJsonObject_emit(jResp));

    respStatusCode = CkHttpResponse_getStatusCode(resp);
    printf("Response Status Code = %d\n",respStatusCode);
    if (respStatusCode >= 400) {
        printf("Response Header:\n");
        printf("%s\n",CkHttpResponse_header(resp));
        printf("Failed.\n");
        CkHttp_Dispose(http);
        CkJsonObject_Dispose(json);
        CkStringBuilder_Dispose(sbRequestBody);
        CkHttpResponse_Dispose(resp);
        CkStringBuilder_Dispose(sbResponseBody);
        CkJsonObject_Dispose(jResp);
        return;
    }

    // Sample JSON response:
    // (Sample code for parsing the JSON response is shown below)

    // {
    //   "answered": false,
    //   "business_phone_number": null,
    //   "customer_city": "Denver",
    //   "customer_country": "US",
    //   "customer_name": "RUEGSEGGER SIMO",
    //   "customer_phone_number": "+13036231131",
    //   "customer_state": "CO",
    //   "direction": "inbound",
    //   "duration": 4,
    //   "id": "CAL8154748ae6bd4e278a7cddd38a662f4f",
    //   "recording": "https://api.callrail.com/v3/a/227799611/calls/213472384/recording.json",
    //   "recording_duration": "27",
    //   "start_time": "2017-01-24T11:27:48.119-05:00",
    //   "tracking_phone_number": "+13038163491",
    //   "voicemail": false
    // }

    // Sample code for parsing the JSON response...
    // Use the following online tool to generate parsing code from sample JSON:
    // Generate Parsing Code from JSON

    // Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat.
    // See this example explaining how this memory should be used: const char * functions.

    answered = CkJsonObject_BoolOf(jResp,"answered");
    business_phone_number = CkJsonObject_stringOf(jResp,"business_phone_number");
    customer_city = CkJsonObject_stringOf(jResp,"customer_city");
    customer_country = CkJsonObject_stringOf(jResp,"customer_country");
    customer_name = CkJsonObject_stringOf(jResp,"customer_name");
    customer_phone_number = CkJsonObject_stringOf(jResp,"customer_phone_number");
    customer_state = CkJsonObject_stringOf(jResp,"customer_state");
    direction = CkJsonObject_stringOf(jResp,"direction");
    duration = CkJsonObject_IntOf(jResp,"duration");
    id = CkJsonObject_stringOf(jResp,"id");
    recording = CkJsonObject_stringOf(jResp,"recording");
    recording_duration = CkJsonObject_stringOf(jResp,"recording_duration");
    start_time = CkJsonObject_stringOf(jResp,"start_time");
    tracking_phone_number = CkJsonObject_stringOf(jResp,"tracking_phone_number");
    voicemail = CkJsonObject_BoolOf(jResp,"voicemail");


    CkHttp_Dispose(http);
    CkJsonObject_Dispose(json);
    CkStringBuilder_Dispose(sbRequestBody);
    CkHttpResponse_Dispose(resp);
    CkStringBuilder_Dispose(sbResponseBody);
    CkJsonObject_Dispose(jResp);

    }