(Tcl) Send SMS Text Message to Phone Number

Uses Amazon SNS to send an SMS text message to a phone number.

See SNS Publish for more information.

For more information, see https://docs.aws.amazon.com/sns/latest/dg/sms_publish-to-phone.html

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set rest [new_CkRest]

# Connect to the Amazon AWS REST server.
# such as https://sns.us-west-2.amazonaws.com/
set bTls 1
set port 443
set bAutoReconnect 1
set success [CkRest_Connect $rest "sns.us-west-2.amazonaws.com" $port $bTls $bAutoReconnect]

# Provide AWS credentials for the REST call.
set authAws [new_CkAuthAws]

CkAuthAws_put_AccessKey $authAws "AWS_ACCESS_KEY"
CkAuthAws_put_SecretKey $authAws "AWS_SECRET_KEY"
# the region should match our URL above..
CkAuthAws_put_Region $authAws "us-west-2"
CkAuthAws_put_ServiceName $authAws "sns"

CkRest_SetAuthAws $rest $authAws

CkRest_AddQueryParam $rest "Action" "Publish"
# ----------------------------------------------------
# Please use your own phone number here for testing...
# ----------------------------------------------------
CkRest_AddQueryParam $rest "PhoneNumber" "+15551239999"
CkRest_AddQueryParam $rest "Message" "This is a test message from Amazon SNS"

set responseXml [CkRest_fullRequestNoBody $rest "GET" "/"]
if {[CkRest_get_LastMethodSuccess $rest] != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    delete_CkAuthAws $authAws
    exit
}

# A successful response will have a status code equal to 200.
if {[CkRest_get_ResponseStatusCode $rest] != 200} then {
    puts "response status code = [CkRest_get_ResponseStatusCode $rest]"
    puts "response status text = [CkRest_responseStatusText $rest]"
    puts "response header: [CkRest_responseHeader $rest]"
    puts "response body: $responseXml"
    delete_CkRest $rest
    delete_CkAuthAws $authAws
    exit
}

# Examine the successful XML response.
set xml [new_CkXml]

CkXml_LoadXml $xml $responseXml
puts [CkXml_getXml $xml]

# To get the MessageId
puts "MessageId: [CkXml_chilkatPath $xml PublishResult|MessageId|*]"

# A sample successful response:
# <?xml version="1.0" encoding="utf-8"?>
# <PublishResponse xmlns="http://sns.amazonaws.com/doc/2010-03-31/">
#     <PublishResult>
#         <MessageId>5ffca506-6ff6-502c-bca3-f098971bcb9c</MessageId>
#     </PublishResult>
#     <ResponseMetadata>
#         <RequestId>6c815022-050e-5930-a7b4-05bcfde35280</RequestId>
#     </ResponseMetadata>
# </PublishResponse>

delete_CkRest $rest
delete_CkAuthAws $authAws
delete_CkXml $xml