If you see a message on any of the lightning components (SMS Inbox, 1:1 Messaging, or SMS Campaigns) that says, "No Access: You currently do not have access to use this component. Contact your System Administrator." follow these steps:
- Check that your user is assigned either the "Twilio Administrator" or "Twilio User" permission set. This section of the set up documentation shows how to provision these permission sets.
- If you are installing the app in a production Salesforce organization, be sure that your user has been assigned a license.
- If your user Twilio for Salesforce trial has expired, contact Twilio Sales to purchase a license. Note: upgrading your Twilio Account by adding a credit card will not provision a Salesforce license for you. Licenses can only be purchased through Sales at this time.
Twilio for Salesforce costs $15 per seat per month, plus any additional Twilio usage such as phone numbers, messaging, Studio executions, and Function runs. A 50% discount is available for nonprofits through Twilio.org's Impact Access Program (apply here).
You only need to purchase seat licenses for users who will be using the package's functionality. Users who do not need SMS do not need a seat license.
For projects that are primarily using an automated process (such as Process Builder or Flows), the number of licenses you need will be determined by who runs the process being executed.
- Process builder runs as a user with system-level priveledges. Although the user has system-level priveledges in the context of process builder, they still need a license to access Twilio for Salesforce's Apex methods. Every user running the process would need a seat license.
- Lightning Flows run in user mode by default, so every user initiating the Flow would need a license.
- Lightning Flows that are launched by process builder can be run by a specific user. Using this approach it is possible to control which user runs the process so that only one license is needed. Note that Twilio support is unable to assist with this configuration. Please contact Salesforce support.
Twilio for Salesforce provides a free 30 day trial. To upgrade follow these steps:
- Make sure you have an upgraded Twilio Account with a payment method.
- In Salesforce, go to the Twilio Configuration page. Under "Purchase Licenses" enter the number of licenses you need. Then click on "Submit Order".
Yes, Twilio for Salesforce can be embedded as a visualforce component in Salesforce Classic. Note that the Lightning utility bar used by the SMS inbox does not exist in Classic, however the inbox can still be viewed as a visualforce page.
Twilio for Salesforce supports the Enterprise and Unlimited editions of Salesforce. Salesforce Essential and Professional editions are not supported.
Twilio for Salesforce's Lightning Components support messaging from Contacts, Leads, Person Accounts, and Cases. Other standard Salesforce objects and custom objects are currently unsupported.
By default, only messages with a record that the current user owns will appear in the SMS inbox. If Personal Phone Numbers are configured, a user with a Personal Number will also see all messages sent to their number in the inbox.
Additionally, administrators can configure SMS inbox message visability in the Twilio Configuration page so that users have the option to "view all" messages. This setting turns the SMS inbox into a feed of all messages coming into the organization.
Even if a user is unable to view messages in the SMS inbox, they will still be able to go directly to the record and send SMS there.
Currently Twilio for Salesforce only supports single-threaded conversations with a contact. Any person messaging from Salesforce will have the same number that was used to previously contact the customer.
The one exception to this rule is when "Personal Numbers" are enabled by an admin. In this case, a user with a personal number will send the outbound message from that number. Messages in the thread will display a "Sent from" and "Replied to" indicator, but the messages will remain in the same lightning component.
By default, visibility of the messages inherits from the record that the component is on. If the user can see the record, they will be able to see the SMS. It is not currently possible to have two users message the same contact and not see each other's messages.
It is possible to configure access to the SMS component on a per-user basis via the Twilio for Salesforce permission set.
Twilio for Salesforce makes one API call per outbound message. Additionally, we will make API calls to get messages from Twilio every 15 seconds when a contact is open, and every 15 minutes to check if there are any new messages across the entire organization.
If you are using an unlicensed and unlimited version of the package that you obtained during the beta period, Salesforce will count API calls made by the package towards your limits. If you are using a version of the app that has passed security review and is listed on the AppExchange, that version of Twilio for Salesforce will have "Ohana" status and will not count towards your API limits.
How many and what kind of numbers you need depends on your use case, and how many messages you will need to send per day.
|Message Volume||Number Pool Needs|
|Less than 250 messages per day||At least one Twilio phone number|
|250 - 1000 messages per day.||At least four Twilio phone numbers|
|More than 1,000 messages per day||Consider a short code (US and Canada), with multiple long codes to use as a fallback based on volume. Contact a Twilio expert to help plan for your needs.|
|More than 1,000 international messages per day||At least one Twilio number, ideally local in the country where you plan to send messages. Check international coverage for SMS here. Contact a Twilio expert to help plan your strategy for international messaging.|
For more information on capacity planning, check out our FAQ on the scaling Twilio phone numbers.
Twilio for Salesforce stores message data in a custom object (TwilioSF_Message__c). One record is created per message. Additionally, messages are sent to Twilio and available via our Programmable SMS API.
Twilio for Salesforce uses the Twilio Programmable SMS API, as well as the Twilio Studio API. Information sent to Twilio includes the following fields:
- From Number or Messaging Service SID
- To Number
- Message Body
- Attachment URL (optional)
Additionally, each request uses the Twilio Account SID, Twilio API Key SID, and Twilio API Key Secret to authenticate. These credentials are generated in your Twilio console.
The "Send to Studio" Process Builder Action allows custom parameters to be sent to Twilio only if configured by an administrator. These parameters can be used to provide additional information to a Twilio Studio IVR or Chat flow.
If you've set up a Twilio function to push messages from Twilio into Salesforce, this means that your Twilio function is not authenticating to Salesforce correctly. This is most frequently caused by a password or security token change.
Twilio for Salesforce does not create a lookup or relationship between a contact and message records. We don't do this because in most organizations, there are contacts with duplicate phone numbers. Creating a lookup to a single contact record would mean that the messages wouldn't appear on other contacts. In reality though, the handset connected to the phone number would see all of the messages regardless of what is displayed in Salesforce.
Instead of creating a lookup, Twilio for Salesforce queries all messages by phone number when a contact or lead is opened and displays the SMS messages that match the record's mobile number. This allows the package to maintain consistency with what is shown on a user's phone number.
Twilio for Salesforce does not integrate with Salesforce Marketing Cloud.
The Pardot platform has an integrated Twilio SMS connection, so you don't need to install Twilio for Salesforce to send messages with Pardot. Further documentation is availble from Salesforce here.
Twilio for Salesforce extends Pardot's outbound messaging capability by allowing you to message back-and-forth with individual contacts.
Twilio for Salesforce's Lightning Components currently only support SMS, although voice calls can be made via Twilio's APIs via the APEX client.
This issue is frequently caused by an error in your process builder's trigger or criteria that is unrelated to Twilio for Salesforce. To debug this issue, first check to make sure you can send any SMS at all from Salesforce. The easiest way to check is to add the 1:1 SMS Component onto a lead or contact and send yourself and SMS.
If you don't receive an SMS, review the setup instructions. If you do receive an SMS, strip your process builder flow down to the most simple flow possible (for example, trigger an SMS when a contact is created with no criteria). If you are still not receiving an SMS, check that another action, such as sending an email, can be fired.
Twilio for Salesforce is currently only for SMS and does not support WhatsApp.
Currently Twilio for Salesforce only supports sending SMS to Contacts or Leads within a campaign, although you could use Apex along with Twilio's APIs to create a custom action for a list view.
Twilio uses Scheduled Apex jobs to fetch messages. Scheduled Apex jobs are run as a Salesforce user. In most cases this will be the administrator that installs the package and initially starts the scheduled job. Occaisionally, Salesforce will reschedule Apex jobs and make them run as the user that most recently logged in. This has no impact on the behavior of Twilio for Salesforce, but may cause confusion.
To resolve this issue, go to the "Twilio Configuration" page in Salesforce and under "Message Sync" click on "Sync Now". This will create a new scheduled Apex job to be run by your user.
If the package fails to install, Salesforce should send you an email that contains an error message detailing what went wrong. For example you might see the following:
1. Apex Classes(classes/Twilio_TestMember.cls) Missing feature
Installing this package requires the following feature and its associated permissions: Apex Classes
2. Apex Triggers(triggers/BulkMessageTrigger.trigger-meta.xml) Missing feature
Installing this package requires the following feature and its associated permissions: Apex Triggers
If the error message includes "Missing feature" it most likely means that you need to upgrade to a more advanced version of Salesforce. Twilio for Salesforce works in Salesforce Enterprise and up. If your package fails for another reason, please email firstname.lastname@example.org and include the error text in your email.