(Lianja) 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 Lianja Extension Download Chilkat Lianja Extension

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

loRest = createobject("CkRest")

// Connect to the Amazon AWS REST server.
// such as https://sns.us-west-2.amazonaws.com/
llBTls = .T.
lnPort = 443
llBAutoReconnect = .T.
llSuccess = loRest.Connect("sns.us-west-2.amazonaws.com",lnPort,llBTls,llBAutoReconnect)

// Provide AWS credentials for the REST call.
loAuthAws = createobject("CkAuthAws")
loAuthAws.AccessKey = "AWS_ACCESS_KEY"
loAuthAws.SecretKey = "AWS_SECRET_KEY"
// the region should match our URL above..
loAuthAws.Region = "us-west-2"
loAuthAws.ServiceName = "sns"

loRest.SetAuthAws(loAuthAws)

loRest.AddQueryParam("Action","Publish")
// ----------------------------------------------------
// Please use your own phone number here for testing...
// ----------------------------------------------------
loRest.AddQueryParam("PhoneNumber","+15551239999")
loRest.AddQueryParam("Message","This is a test message from Amazon SNS")

lcResponseXml = loRest.FullRequestNoBody("GET","/")
if (loRest.LastMethodSuccess <> .T.) then
    ? loRest.LastErrorText
    release loRest
    release loAuthAws
    return
endif

// A successful response will have a status code equal to 200.
if (loRest.ResponseStatusCode <> 200) then
    ? "response status code = " + str(loRest.ResponseStatusCode)
    ? "response status text = " + loRest.ResponseStatusText
    ? "response header: " + loRest.ResponseHeader
    ? "response body: " + lcResponseXml
    release loRest
    release loAuthAws
    return
endif

// Examine the successful XML response.
loXml = createobject("CkXml")
loXml.LoadXml(lcResponseXml)
? loXml.GetXml()

// To get the MessageId
? "MessageId: " + loXml.ChilkatPath("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>


release loRest
release loAuthAws
release loXml