Sample code for 30+ languages & platforms
Tcl Requires Chilkat v11.0.0+

Schedule or cancel an SMS with Twilio

See more Twilio Examples

Live messaging operation. Choose one action per run. Scheduling requires an SMS-capable sender in a Twilio Messaging Service. Supply its MG SID, a recipient in E.164 format, and a send time from 15 minutes to 35 days in the future. The example uses UTC one hour from now. Twilio will send the scheduled message unless it is canceled in time.

Save the returned Message SID. To cancel later, select the cancel action and supply that SID under the same account. Check the returned status. If the message has already left the scheduled state, fetch its current status.

Twilio documentation

Chilkat Tcl Downloads

Tcl

load ./chilkat.dll

set success 0

#  Assumes Chilkat is unlocked. See Global Unlock Sample.
#  Load an API key for the Twilio account from private application configuration.
set http [new_CkHttp]

CkHttp_put_RequireSslCertVerify $http 1
CkHttp_put_BasicAuth $http 1
CkHttp_put_Login $http "YOUR_API_KEY_SID"
CkHttp_put_Password $http "YOUR_API_KEY_SECRET"

set url [new_CkStringBuilder]

CkStringBuilder_Append $url "https://api.twilio.com/2010-04-01/Accounts/"
CkStringBuilder_Append $url "YOUR_ACCOUNT_SID"
CkStringBuilder_Append $url "/Messages"
#  Set this to true on a later run to cancel the saved message.
set cancelMessage 0
set req [new_CkHttpRequest]

set sendTime [new_CkDateTime]

CkHttpRequest_put_HttpVerb $req "POST"
CkHttpRequest_put_ContentType $req "application/x-www-form-urlencoded"
set expectedHttp 201
set expectedStatus "scheduled"
if {$cancelMessage != 1} then {
    set timeOk [CkDateTime_SetFromCurrentSystemTime $sendTime]
    if {$timeOk != 1} then {
        puts [CkDateTime_lastErrorText $sendTime]
        delete_CkHttp $http
        delete_CkStringBuilder $url
        delete_CkHttpRequest $req
        delete_CkDateTime $sendTime
        exit
    }

    set timeOk [CkDateTime_AddSeconds $sendTime 3600]
    if {$timeOk != 1} then {
        puts [CkDateTime_lastErrorText $sendTime]
        delete_CkHttp $http
        delete_CkStringBuilder $url
        delete_CkHttpRequest $req
        delete_CkDateTime $sendTime
        exit
    }

    CkHttpRequest_AddParam $req "MessagingServiceSid" "YOUR_MESSAGING_SERVICE_SID"
    CkHttpRequest_AddParam $req "To" "RECIPIENT_E164_NUMBER"
    CkHttpRequest_AddParam $req "Body" "Scheduled message."
    CkHttpRequest_AddParam $req "ScheduleType" "fixed"
    CkHttpRequest_AddParam $req "SendAt" [CkDateTime_getAsTimestamp $sendTime 0]
} else {
    #  Update the individual message. This branch never creates another message.
    CkStringBuilder_Append $url "/"
    CkStringBuilder_Append $url "SAVED_SCHEDULED_MESSAGE_SID"
    CkHttpRequest_AddParam $req "Status" "canceled"
    set expectedHttp 200
    set expectedStatus "canceled"
}

CkStringBuilder_Append $url ".json"
set resp [new_CkHttpResponse]

set reply [new_CkJsonObject]

set success [CkHttp_HttpReq $http [CkStringBuilder_getAsString $url] $req $resp]
if {[CkHttpResponse_get_StatusCode $resp] == 0} then {
    puts "No HTTP response from Twilio."
    delete_CkHttp $http
    delete_CkStringBuilder $url
    delete_CkHttpRequest $req
    delete_CkDateTime $sendTime
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

set parsed [CkJsonObject_Load $reply [CkHttpResponse_bodyStr $resp]]
if {expr [$success != 1]  ||  [[CkHttpResponse_get_StatusCode $resp] != $expectedHttp]} then {
    puts "Twilio returned HTTP [CkHttpResponse_get_StatusCode $resp]"
    if {expr [$parsed == 1]  &&  [[CkJsonObject_JsonTypeOf $reply "code"] == 2]} then {
        puts "Twilio error: [CkJsonObject_IntOf $reply code]  [CkJsonObject_stringOf $reply message]"
    }

    delete_CkHttp $http
    delete_CkStringBuilder $url
    delete_CkHttpRequest $req
    delete_CkDateTime $sendTime
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

if {$parsed != 1} then {
    puts "Expected a JSON response from Twilio."
    delete_CkHttp $http
    delete_CkStringBuilder $url
    delete_CkHttpRequest $req
    delete_CkDateTime $sendTime
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

if {expr [[CkJsonObject_JsonTypeOf $reply "sid"] != 1]  ||  [[CkJsonObject_JsonTypeOf $reply "status"] != 1]} then {
    puts "The response is missing the message SID or status."
    delete_CkHttp $http
    delete_CkStringBuilder $url
    delete_CkHttpRequest $req
    delete_CkDateTime $sendTime
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

puts "Message SID: [CkJsonObject_stringOf $reply sid]"
puts "Current status: [CkJsonObject_stringOf $reply status]"
if {[CkJsonObject_StringOfEquals $reply "status" $expectedStatus 1] != 1} then {
    puts "The requested state was not confirmed. Check this SID before trying again."
    delete_CkHttp $http
    delete_CkStringBuilder $url
    delete_CkHttpRequest $req
    delete_CkDateTime $sendTime
    delete_CkHttpResponse $resp
    delete_CkJsonObject $reply
    exit
}

if {$cancelMessage != 1} then {
    puts "Save the Message SID to check or cancel the scheduled message."
}


delete_CkHttp $http
delete_CkStringBuilder $url
delete_CkHttpRequest $req
delete_CkDateTime $sendTime
delete_CkHttpResponse $resp
delete_CkJsonObject $reply