Skip to contentSkip to navigationSkip to topbar
On this page

The SMS Inbox Lightning Component


(warning)

Warning

If you are using any version of the Twilio for Salesforce app older than 4.84, then before upgrading to latest version, please ensure you perform these two mandatory tasks:

  1. Update the custom fields TwilioSF__Contact__c, TwilioSF__Lead__c, and TwilioSF__Account__c on the TwilioSF__Message__c object for all existing messages .
  2. The TwilioSF__Account__c field needs to be populated only if the customer organization is using a personal account.

These steps are necessary for the Inbox to show the correct Lead or Contact record on the incoming message.

The SMS Inbox Lightning Component allows users to see messages from all of the leads and contacts that they own. Instead of visiting a contact or lead record to view recent messages, you can configure the SMS Inbox in the Lightning toolbar or on a dashboard.

The SMS Inbox includes these key features:

  • Unread message count.
  • Unread messages highlighted in blue.
  • Click-to-reply within the SMS Inbox component.
  • Click on the contact or lead to visit the record page.
  • Optional message archiving.

Configure the component

configure-the-component page anchor

To configure the SMS Inbox, just follow these steps:

  1. In Salesforce, go to Setup > Apps > App Manager .

  2. Here you can either add SMS Inbox to an existing Lightning app or create a new one.

    1. To create a new app, click on New Lightning App in the top right corner.
    2. To add to an existing app, click on the down arrow on the right side of the app's row and select Edit .
  3. Once inside the Lightning App Builder, click on Utility Items in the side nav.

  4. Click on Add Utility Item :

    Add Utility Item.
  5. Select Twilio — Inbox .

  6. To optimize readability, set the component width to 500 pixels in the utility item configuration screen.

  7. To make sure that the component shows the new messages automatically, check the Start Automatically checkbox:

    Twilio for Salesforce Inbox Updated.
  8. Click the Save button.

  9. Launch your lightning app and be sure to refresh. Twilio — Inbox will now appear in your utility bar.


Choose which messages appear in the Inbox

choose-which-messages-appear-in-the-inbox page anchor

By default, the SMS Inbox only shows messages from Contacts, Leads, and Person Accounts that belong to the Salesforce user. Additionally, if a message is sent to a personal phone number that is configured for a Salesforce user, that message will appear in that user's SMS inbox.

Twilio for Salesforce optionally allows users to see all the messages intended for their organization. This is useful if you have Salesforce users who collaborate across conversations. This option must be enabled by an administrator. To enable the option:

  1. Go to the Twilio for Salesforce configuration page.

  2. Under the Inbox Config section, select Users can see all messages and then click the Save button:

    Configure the Twilio for Salesforce SMS Inbox.

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.