How to send SMS messages with AWS SNS
Knock integrates with AWS Simple Notification Service (SNS) to send SMS notifications to your recipients.
Features
- Knock link tracking
- Per environment configuration
- Sandbox mode
Getting started
You can create a new AWS SNS channel in the dashboard under the Integrations > Channels section. From there, you'll need to take some steps in AWS before you can configure your SNS channel within Knock.
Choose an AWS Authentication Scheme
Knock supports two authentication schemes with AWS SNS:
Configuring SNS in Knock
Now that you have either an AWS User's credentials or an AWS IAM Role to delegate to Knock, you're ready to configure your SNS channel in the Knock dashboard under the Integrations > Channels section.
Here are a few other things to keep in mind once you have your SNS channel configured in Knock:
- SNS sandbox mode. By default, AWS places all new accounts in the SNS sandbox. While your account is in the sandbox, you can only send messages to verified destination phone numbers—keep this in mind if you're testing in development before you've moved your account out of the SNS sandbox. For more information on the SNS sandbox and how to move your account out of it, see the SNS sandbox documentation.
- Deliverability tracking. We cannot currently track deliverability through SNS channels. This means that all notifications sent through SNS will show up as "Sent" in the Knock messages log, but not "Delivered".
Channel configuration
The following channel settings should be configured per environment. Navigate to Integrations > Channels in your dashboard, select your AWS SNS channel, then click "Manage configuration" under the environment that you'd like to configure.
Recipient data requirements
In order to send an SMS notification you'll need a valid phone_number
property set on your recipient.