Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

The 1:1 SMS Lightning Component

With Twilio for Salesforce, you can send 1:1 messages to contacts and leads directly from your Salesforce instance. You don't need to reveal your personal number, and conversations are visible on the contact record.

The component can be be set up under Lightning, but it can also be added with Classic.



Your recipient must have a mobile phone number on their record to use this feature — other phone numbers can't be used.

Video Tutorial

video-tutorial page anchor

This short video will show you how to set up the 1:1 SMS component using Lightning, but you can also jump down to a step-by-step guide.

  1. Open an individual Contact, Lead, Person Account, or Case record.
  2. Under the gear icon in the top right corner, click on Edit Page . You'll be brought to the Lightning editor:

    Instructions to Edit Page.
  3. In the menu on the left-hand side, scroll down to Custom — Managed . Drag and drop the Lightning component into the page layout:

    Scroll down to Custom Managed Lightning component.
  4. Click Save in the top-right corner:
    Click on Save.
  5. You'll now need to assign this layout as the organization's default. To do this, click the Activation... button:
    Click on Activation.
  6. Click on the Assign as Org Default button in the Activation: Contact Record Page panel that appears:
    Click on the Assign as Org Default.
  7. Click the Close button.
  8. Verify that the 1:1 Component is appearing correctly by clicking the Back button at the top of the page. You'll see the 1:1 Messaging Component on the record's layout.


If you don't see any custom components in Step 3, you probably need to enable MyDomain for your Salesforce Organization. You can read more about enabling MyDomain by checking out Salesforce's documentation(link takes you to an external page).

  1. Click on the Setup button in the top-right corner Salesforce:

    Click on Setup.
  2. In the side bar under Customize , click on the object that you would like to add the 1:1 Messaging Component to. Twilio for Salesforce currently supports Leads, Contacts, Person Accounts, and Cases. In this example, we're customizing our Contacts layout, so open that entry:

    Click Page Layouts.
  3. Clock on Page Layouts and select the layout that you would like to customize for your object. In this example, we're customizing the general object layout, Contact Layout , but you could also only customize the sales or service layout for your organization:

    Edit Contact Layout.
  4. On the layout editor page, click on Visualforce Pages . You'll see Twilio - Two Way Messages as a visualforce component that you can add to the layout:

    Click on. Visualforce Pages.
  5. Drag and drop the visualforce component onto the layout page where you would like to have it be displayed to users:

    Drag and drop the visualforce component.
  6. Once it is in the right spot, click Save .
  7. Configure the height of the visualforce component by clicking on the wrench icon in the top-right corner of the component:

    Instructions to configure the height of the visualforce component.
  8. Set the component's height to 600 pixels so that the message thread is visible, then click OK :

    Visualforce Page Properties.

Rate this page: