B4X

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. B4X

Dim success As Boolean = False

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

Dim http As ChilkatHttp
http.Initialize("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
'  }

Dim json As ChilkatJsonObject
json.Initialize
json.UpdateString("note", "Call customer back tomorrow")
json.UpdateString("tags[0]", "New Client")
json.UpdateString("lead_status", "good_lead")
json.UpdateString("value", "$1.00")
json.UpdateBool("append_tags", True)

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

Dim sbRequestBody As ChilkatStringBuilder
sbRequestBody.Initialize
json.EmitSb(sbRequestBody)

Dim resp As ChilkatHttpResponse
resp.Initialize
success = http.HttpSb("PUT", "https://api.callrail.com/v3/a/{account_id}/calls/{call_id}.json", sbRequestBody, "utf-8", "application/json", resp)
If success = False Then
    Log(http.LastErrorText)
    Return
End If


Dim sbResponseBody As ChilkatStringBuilder
sbResponseBody.Initialize
resp.GetBodySb(sbResponseBody)
Dim jResp As ChilkatJsonObject
jResp.Initialize
jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False

Log("Response Body:")
Log(jResp.Emit)

Dim respStatusCode As Int = resp.StatusCode
Log("Response Status Code = " & respStatusCode)
If respStatusCode >= 400 Then
    Log("Response Header:")
    Log(resp.Header)
    Log("Failed.")
    Return
End If


'  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



Dim answered As Boolean = jResp.BoolOf("answered")
Dim business_phone_number As String = jResp.StringOf("business_phone_number")
Dim customer_city As String = jResp.StringOf("customer_city")
Dim customer_country As String = jResp.StringOf("customer_country")
Dim customer_name As String = jResp.StringOf("customer_name")
Dim customer_phone_number As String = jResp.StringOf("customer_phone_number")
Dim customer_state As String = jResp.StringOf("customer_state")
Dim direction As String = jResp.StringOf("direction")
Dim duration As Int = jResp.IntOf("duration")
Dim id As String = jResp.StringOf("id")
Dim recording As String = jResp.StringOf("recording")
Dim recording_duration As String = jResp.StringOf("recording_duration")
Dim start_time As String = jResp.StringOf("start_time")
Dim tracking_phone_number As String = jResp.StringOf("tracking_phone_number")
Dim voicemail As Boolean = jResp.BoolOf("voicemail")