This article describes how to set up the Twilio connector.
In this article:
Connector Actions
Action Name |
AudienceStream |
EventStream |
Send SMS or MMS |
✓ |
✓ |
Configure Settings
Go to the Connector Marketplace and add a new connector. See the Connector Overview for general instructions on how to add a connector.
After adding the connector, configure the following settings:
- Account SID (username)
- HTTP requests to the REST API are protected with HTTP Basic authentication.
- Use your Twilio account SID as the username and your auth token as the password for HTTP Basic authentication.
- For more information, see: SMS API: Messaging.
- Auth Token (password)
- HTTP requests to the REST API are protected with HTTP Basic authentication.
- Use your Twilio account SID as the username and your auth token as the password for HTTP Basic authentication.
- For more information, see: SMS API: Messaging.
Action Settings - Parameters and Options
Click Next or go to the Actions tab. This is where you configure connector actions.
This section describes how to set up parameters and options for each action.
Action - Send SMS or MMS
Parameters
Parameter |
Description |
Account SID |
- You can find your Account SID in your console.
- For more information on this endpoint, see: Sending Messages.
|
To |
- The destination phone number.
- Format with a plus sign (+) and country code, in (E.164 format).
- Example: +16175551212
|
From |
|
Messaging Service SID |
|
Body |
|
Media URL |
|
Status Callback |
- A URL where Twilio will POST each time your message status changes to one of the following:
- queued
- failed
- sent
- delivered
- undelivered
- Twilio will POST the
MessageSid along with the other standard request parameters as well as MessageStatus and ErrorCode .
- If this parameter is passed in addition to a
MessagingServiceSid , Twilio will override the Status Callback URL of the Messaging Service.
- URLs must contain a valid hostname.
- The underscore character (_) is not allowed in the hostname.
|
Application SID |
- Twilio will POST
MessageSid as well as MessageStatus=sent or MessageStatus=failed to the URL in the MessageStatusCallback property of this Application.
- If the
StatusCallback parameter above is also passed, the MessageStatusCallback parameter for the application takes precedence.
|
Max Price |
- The total maximum price up to the fourth decimal (0.0001) in US dollars acceptable for the message to be delivered.
- All messages will be queued for delivery, regardless of the price point.
- A POST request is later made to your Status Callback URL with a status change of Sent or Failed.
- When the price of the message is above this value the message will fail and not be sent.
- When
MaxPrice is not set, all prices for the message are accepted.
|
Provide Feedback |
- Set this value to true if you are sending messages that have a trackable user action and you intend to confirm delivery of the message using the Message Feedback API.
- This parameter is set to false by default
|
Validity Period |
- The number of seconds that the message can remain in a Twilio queue.
- After exceeding this time limit, the message will fail and a POST request is later made to your Status Callback URL.
- Valid values are between 1 and 14400 seconds (default).
- Twilio cannot guarantee that a message will not be queued by the carrier after they accept the message.
- We do not recommend setting validity periods of less than five (5) seconds
|