# The SMS Inbox Lightning Component

> \[!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

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** :

   ![Utility Items section with Add Utility Item button highlighted in Lightning App Builder.](https://docs-resources.prod.twilio.com/8c8df19ae4ccc3d54e24f4aac3928695af4069f3ebc431a41fc14732a67867fc.png)
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 Inbox utility item properties with panel width 500, height 480, and start automatically checked.](https://docs-resources.prod.twilio.com/19d12439bc80a7834c454dad9eac60c890b2789811ab69ad2915c703e5cd00de.png)
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

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:

   ![Twilio for Salesforce SMS Inbox configuration with options to view all messages or user-specific messages.](https://docs-resources.prod.twilio.com/c4a24f36a9a99cc5a5b68df364d6c8bc3253595047f2482a5a9d5d792520f73a.png)