(JavaScript) 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

Note

This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.

var success = false;

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

var rest = new CkRest();

// Connect to the Amazon AWS REST server.
// such as https://sns.us-west-2.amazonaws.com/
var bTls = true;
var port = 443;
var bAutoReconnect = true;
success = rest.Connect("sns.us-west-2.amazonaws.com",port,bTls,bAutoReconnect);

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

rest.SetAuthAws(authAws);

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

var responseXml = rest.FullRequestNoBody("GET","/");
if (rest.LastMethodSuccess !== true) {
    console.log(rest.LastErrorText);
    return;
}

// A successful response will have a status code equal to 200.
if (rest.ResponseStatusCode !== 200) {
    console.log("response status code = " + rest.ResponseStatusCode);
    console.log("response status text = " + rest.ResponseStatusText);
    console.log("response header: " + rest.ResponseHeader);
    console.log("response body: " + responseXml);
    return;
}

// Examine the successful XML response.
var xml = new CkXml();
xml.LoadXml(responseXml);
console.log(xml.GetXml());

// To get the MessageId
console.log("MessageId: " + xml.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>