There are a few settings in Twilio to note when configuring the Chili Piper SMS integration.
- Chili Piper does work with Twilio sub-accounts!
- Chili Piper will use the first number (top of the list) in your Twilio account. Please ensure this number has SMS capabilities enabled and has no other use but for Chili Piper (i.e.: Not a rep's voice number!)
- We can work with Twilio trial accounts, but each number needs to be verified first via caller ID.
Account SID / Authorization Token
You must add your Twilio account's SID and auth token to Chili Piper. You can find these after logging into Twilio and browsing https://www.twilio.com/console.
Note: if you are using subaccounts, the subaccount SID can be used. Find this under the subaccount dashboard within Twilio.
Once you have them, head over to Chili Piper's admin integrations page, and you will find a section to copy/paste them in:
Configure Messaging Number
In Twilio, click the 3-dots on the left-hand menu, then "Phone Numbers" from your super network:
The first number on the list is the one that will be associated with Chili Piper. Click this number to edit it.
Configure the Messaging section with "Webhooks, TwiML Bins, Functions, Studio, or Proxy," and paste in the following webhook that Chili Piper will use to communicate with Twilio:
https://api.chilipiper.com/api/v1/twilio/messages
Type is HTTP POST
You do not select a "Messaging Service," and this field can remain blank.
You may want to configure Voice & Fax section here with a blank webhook so that it's effectively disabled, as the primary use for this number will be SMS messaging.
When this is set up correctly, it will look like this in your Active Numbers list, with messaging set to our webhook and voice unconfigured:
Next, create your first reminder, then Test your SMS reminders
ℹ️ Note: Since 2023/07/01, the United Kingdom started blocking SMS messages submitted with international long codes, as they consider "an abuse of Person-to-Person (P2P) routes".
Starting 11/26/2024, "in an effort to prevent potential fraud, messages sent from international long codes and unregistered Alphanumeric Sender IDs to the Philippines will be blocked".
Chili Piper uses the first number that a customer has configured in their connected Twilio instance, so we would advise using one of the three approaches suggested by Twilio if you're willing to or you already send messages to the UK from any other countries outside of the UK:
If you're US based, according to this Twilio's documentation, alphanumeric codes are not supported in the US.
The above scenario should have no impact if you are not sending messages to the UK and the Philippines from countries outside these same two countries.