Skip to main content

Provider Setup

Twilio​

KeyDescription
twilio.accountSidTwilio account SID
twilio.authTokenTwilio auth token
twilio.fromNumberSender number in E.164 format

AWS SNS​

KeyDescription
aws.regionAWS region, for example us-east-1
aws.accessKeyIdIAM access key ID
aws.secretAccessKeyIAM secret access key

The IAM principal needs only sns:Publish. Publishing to a phone number is not scoped to a topic ARN, so the resource is *:

{
"Version": "2012-10-17",
"Statement": [
{ "Effect": "Allow", "Action": "sns:Publish", "Resource": "*" }
]
}

Credentials come from these three settings only; instance profiles, IRSA and the other AWS credential providers are not used.

Two AWS-side settings commonly look like plugin failures:

  • new accounts sit in the SMS sandbox, where messages only reach phone numbers you have verified — request production access before rolling out
  • SNS enforces a monthly SMS spending limit, USD 1.00 by default, after which publishes fail

Vonage​

KeyDescription
vonage.apiKeyVonage API key
vonage.apiSecretVonage API secret
vonage.fromNumberSender ID or number

Telegram​

KeyDescription
telegram.bot.tokenTelegram bot token
telegram.contact.attributeUser attribute that stores the chat ID

WhatsApp​

KeyDescription
whatsapp.api.urlAPI endpoint used to send messages
whatsapp.api.tokenAPI token
whatsapp.from.numberSender number
whatsapp.contact.attributeUser attribute for the recipient number

Signal​

KeyDescription
signal.cli.rest.urlBase URL of signal-cli-rest-api
signal.from.numberSender number
signal.contact.attributeUser attribute for the recipient number