Dart

CallRail API - Create an Outbound Phone Call

See more CallRail Examples

Initiates an outbound call from the target account. 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 POST \
  //      -H "Content-Type: application/json" \
  //      -d '{
  //           "caller_id": "+17703334455",
  //           "business_phone_number": "+14045556666",
  //           "customer_phone_number": "+14044442233",
  //           "recording_enabled": true,
  //           "outbound_greeting_recording_url": "http://www.test.com/greeting.mp3",
  //           "outbound_greeting_text": "These are not the droids you are looking for."
  //          }' \
  //          "https://api.callrail.com/v3/a/{account_id}/calls.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.

  // {
  //   "caller_id": "+17703334455",
  //   "business_phone_number": "+14045556666",
  //   "customer_phone_number": "+14044442233",
  //   "recording_enabled": true,
  //   "outbound_greeting_recording_url": "http://www.test.com/greeting.mp3",
  //   "outbound_greeting_text": "These are not the droids you are looking for."
  // }

  final json = CkJsonObject();
  json.updateString('caller_id', '+17703334455');
  json.updateString('business_phone_number', '+14045556666');
  json.updateString('customer_phone_number', '+14044442233');
  json.updateBool('recording_enabled', true);
  json.updateString('outbound_greeting_recording_url', 'http://www.test.com/greeting.mp3');
  json.updateString('outbound_greeting_text', 'These are not the droids you are looking for.');

  http.setRequestHeader('Authorization', 'Token token={api_token}');
  http.setRequestHeader('Content-Type', 'application/json');

  final resp = CkHttpResponse();
  try {
    http.httpJson('POST', 'https://api.callrail.com/v3/a/{account_id}/calls.json', json, '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": null,
  //   "business_phone_number": "+19044567899",
  //   "customer_city": "Atlanta",
  //   "customer_country": "US",
  //   "customer_name": null,
  //   "customer_phone_number": "+14703444700",
  //   "customer_state": "GA",
  //   "direction": "outbound",
  //   "duration": null,
  //   "id": "CAL8154748ae6bd4e278a7cddd38a662f4f",
  //   "recording": null,
  //   "recording_duration": null,
  //   "start_time": "2017-02-22T15:02:24.916-05:00",
  //   "tracking_phone_number": "+19044567899",
  //   "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 answered = jResp.stringOf('answered');
  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.stringOf('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');
}