Dart

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

import 'package:chilkat/chilkat.dart';

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

  final http = CkHttp();

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

  final json = CkJsonObject();
  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');

  final sbRequestBody = CkStringBuilder();
  json.emitSb(sbRequestBody);

  final resp = CkHttpResponse();
  try {
    http.httpSb('PUT', 'https://api.callrail.com/v3/a/{account_id}/calls/{call_id}.json', sbRequestBody, 'utf-8', 'application/json', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  final sbResponseBody = CkStringBuilder();
  resp.getBodySb(sbResponseBody);
  final jResp = CkJsonObject();
  jResp.loadSb(sbResponseBody);
  jResp.emitCompact = false;

  print('Response Body:');
  print(jResp.emit());

  final respStatusCode = resp.statusCode;
  print('Response Status Code = $respStatusCode');
  if (respStatusCode >= 400) {
    print('Response Header:');
    print(resp.header);
    print('Failed.');
    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

  final businessPhoneNumber = jResp.stringOf('business_phone_number');
  final customerCity = jResp.stringOf('customer_city');
  final customerCountry = jResp.stringOf('customer_country');
  final customerName = jResp.stringOf('customer_name');
  final customerPhoneNumber = jResp.stringOf('customer_phone_number');
  final customerState = jResp.stringOf('customer_state');
  final direction = jResp.stringOf('direction');
  final duration = jResp.intOf('duration');
  final id = jResp.stringOf('id');
  final recording = jResp.stringOf('recording');
  final recordingDuration = jResp.stringOf('recording_duration');
  final startTime = jResp.stringOf('start_time');
  final trackingPhoneNumber = jResp.stringOf('tracking_phone_number');
}