Xbase++

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. Xbase++

LOCAL nSuccess
LOCAL oHttp
LOCAL oJson
LOCAL oSbRequestBody
LOCAL oResp
LOCAL oSbResponseBody
LOCAL oJResp
LOCAL nRespStatusCode
LOCAL nAnswered
LOCAL cBusiness_phone_number
LOCAL cCustomer_city
LOCAL cCustomer_country
LOCAL cCustomer_name
LOCAL cCustomer_phone_number
LOCAL cCustomer_state
LOCAL cDirection
LOCAL nDuration
LOCAL cId
LOCAL cRecording
LOCAL cRecording_duration
LOCAL cStart_time
LOCAL cTracking_phone_number
LOCAL nVoicemail

nSuccess := 0

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

oHttp := CreateObject("Chilkat.Http")

//  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
//  }

oJson := CreateObject("Chilkat.JsonObject")
oJson:UpdateString("note", "Call customer back tomorrow")
oJson:UpdateString("tags[0]", "New Client")
oJson:UpdateString("lead_status", "good_lead")
oJson:UpdateString("value", "$1.00")
oJson:UpdateBool("append_tags", 1)

oHttp:SetRequestHeader("Authorization", "Token token={api_token}")
oHttp:SetRequestHeader("Content-Type", "application/json")

oSbRequestBody := CreateObject("Chilkat.StringBuilder")
oJson:EmitSb(oSbRequestBody)

oResp := CreateObject("Chilkat.HttpResponse")
nSuccess := oHttp:HttpSb("PUT", "https://api.callrail.com/v3/a/{account_id}/calls/{call_id}.json", oSbRequestBody, "utf-8", "application/json", oResp)
IF (nSuccess == 0)
    ? oHttp:LastErrorText
    oHttp:destroy()
    oJson:destroy()
    oSbRequestBody:destroy()
    oResp:destroy()
    RETURN
ENDIF

oSbResponseBody := CreateObject("Chilkat.StringBuilder")
oResp:GetBodySb(oSbResponseBody)
oJResp := CreateObject("Chilkat.JsonObject")
oJResp:LoadSb(oSbResponseBody)
oJResp:EmitCompact := 0

? "Response Body:"
? oJResp:Emit()

nRespStatusCode := oResp:StatusCode
? "Response Status Code = " + Str(nRespStatusCode)
IF (nRespStatusCode >= 400)
    ? "Response Header:"
    ? oResp:Header
    ? "Failed."
    oHttp:destroy()
    oJson:destroy()
    oSbRequestBody:destroy()
    oResp:destroy()
    oSbResponseBody:destroy()
    oJResp:destroy()
    RETURN
ENDIF

//  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

nAnswered := oJResp:BoolOf("answered")
cBusiness_phone_number := oJResp:StringOf("business_phone_number")
cCustomer_city := oJResp:StringOf("customer_city")
cCustomer_country := oJResp:StringOf("customer_country")
cCustomer_name := oJResp:StringOf("customer_name")
cCustomer_phone_number := oJResp:StringOf("customer_phone_number")
cCustomer_state := oJResp:StringOf("customer_state")
cDirection := oJResp:StringOf("direction")
nDuration := oJResp:IntOf("duration")
cId := oJResp:StringOf("id")
cRecording := oJResp:StringOf("recording")
cRecording_duration := oJResp:StringOf("recording_duration")
cStart_time := oJResp:StringOf("start_time")
cTracking_phone_number := oJResp:StringOf("tracking_phone_number")
nVoicemail := oJResp:BoolOf("voicemail")

oHttp:destroy()
oJson:destroy()
oSbRequestBody:destroy()
oResp:destroy()
oSbResponseBody:destroy()
oJResp:destroy()