(Tcl) Twilio: Send SMS using Basic Authentication

Demonstrates how to use Twilio to send an SMS message using Basic authentication.

For more information, see https://www.twilio.com/docs/sms/send-messages

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

# Demonstrates how to use Basic Authentication in a REST API call for Twilio.
# Sends an SMS text message..

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

set rest [new_CkRest]

# Use Basic Authentication.
# Your Twilio Account SID is the username.
# Your Twilio Auth Token is the password.
set success [CkRest_SetAuthBasic $rest "TWILIO_ACCOUNT_SID" "TWILIO_AUTH_TOKEN"]

# Make the initial connection (without sending a request yet) to Twilio.
set bTls 1
set port 443
set bAutoReconnect 1
set success [CkRest_Connect $rest "api.twilio.com" $port $bTls $bAutoReconnect]
if {$success != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    exit
}

# Provide the information for the SMS text message:
set success [CkRest_AddQueryParam $rest "To" "+16518675309"]
set success [CkRest_AddQueryParam $rest "From" "+15005550006"]
set success [CkRest_AddQueryParam $rest "Body" "Hey Jenny! Good luck on the bar exam!"]
set success [CkRest_AddQueryParam $rest "MediaUrl" "http://farm2.static.flickr.com/1075/1404618563_3ed9a44a3a.jpg"]

# Send the SMS text message.
# Your Twilio Account SID is part of the URI path:
set responseJson [CkRest_fullRequestFormUrlEncoded $rest "POST" "/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json"]
if {[CkRest_get_LastMethodSuccess $rest] != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    exit
}

# When successful, the response status code will equal 201.
if {[CkRest_get_ResponseStatusCode $rest] != 201} then {
    # Examine the request/response to see what happened.
    puts "response status code = [CkRest_get_ResponseStatusCode $rest]"
    puts "response status text = [CkRest_responseStatusText $rest]"
    puts "response header: [CkRest_responseHeader $rest]"
    puts "response body (if any): $responseJson"
    puts "---"
    puts "LastRequestStartLine: [CkRest_lastRequestStartLine $rest]"
    puts "LastRequestHeader: [CkRest_lastRequestHeader $rest]"
    delete_CkRest $rest
    exit
}

# The response is JSON.  We'll show how to get a few bits of information from it.
# A full sample JSON response is shown below..

set json [new_CkJsonObject]

CkJsonObject_put_EmitCompact $json 0
set success [CkJsonObject_Load $json $responseJson]

# First show the entire JSON.
puts [CkJsonObject_emit $json]

# Now get some individual pieces of information:
puts "sid: [CkJsonObject_stringOf $json sid]"
puts "body: [CkJsonObject_stringOf $json body]"
puts "media: [CkJsonObject_stringOf $json subresource_uris.media]"

puts "Success."

# Sample JSON response:

# {
#   "sid": "MM97ecfd43e9f24e99b0c2c6ee016949e3",
#   "date_created": null,
#   "date_updated": null,
#   "date_sent": null,
#   "account_sid": "112e1111e0151133d11112101111d1111",
#   "to": "+16518675309",
#   "from": "+15005550006",
#   "messaging_service_sid": null,
#   "body": "Sent from your Twilio trial account - Hey Jenny! Good luck on the bar exam!",
#   "status": "queued",
#   "num_segments": "1",
#   "num_media": "0",
#   "direction": "outbound-api",
#   "api_version": "2010-04-01",
#   "price": null,
#   "price_unit": "USD",
#   "error_code": null,
#   "error_message": null,
#   "uri": "/2010-04-01/Accounts/AC2e9b6bc0f51133df24926f07341d3824/Messages/MM97ecfd43e9f24e99b0c2c6ee016949e3.json",
#   "subresource_uris": {
#     "media": "/2010-04-01/Accounts/AC2e9b6bc0f51133df24926f07341d3824/Messages/MM97ecfd43e9f24e99b0c2c6ee016949e3/Media.json"
#   }
# }

delete_CkRest $rest
delete_CkJsonObject $json