How can we Help?

Salesforce SMS Component


With the Salesforce SMS Component, agents can send and receive SMS messages directly in Talkdesk for Salesforce and supervisors can also report on the number of interactions per contact as an example.

To learn how to configure and use SMS within Talkdesk for Salesforce, please follow these step-by-step instructions.


How does it work?

How to enable SMS in your Talkdesk account

Setup of the component in Salesforce Lightning

Defining a default contact phone field to be used

How to send and receive SMS messages

Setup in Salesforce Console view

Setup in Salesforce Classic


How does it work?

  • Agents can specify to which contact the SMS will be sent. If the SMS contact has multiple phone numbers, agents can choose the phone number to which the SMS will be sent. Note: All non-numeric characters will be removed from the SMS contact phone number (for example, parenthesis and hyphens) and the phone number will be prepended with a plus sign (+).
  • The SMS contact will default to the contact specified on the case.
  • Agents can specify the number from which the SMS will be sent from, based on the numbers enabled for SMS on Talkdesk.
  • Customers can both call and send SMS messages to the phone number.
  • If your account receives an SMS from a new number that isn’t associated with a contact, Talkdesk will automatically create a new contact with the phone number set as the last name.
  • If an SMS case is already open for a particular contact and an agent receives an SMS from that contact to the SMS-enabled phone number, it will append the text of that SMS to the case.
  • For a new incoming SMS from a contact, we rely on Salesforce settings for assignment rules. See Salesforce documentation for assignment rules.
  • If there are no rules set up, the case will remain unassigned.


How to enable SMS in your Talkdesk account

  • Start by opening your Talkdesk account.
  • If you’re already on Talkdesk for Salesforce in Lightning, simply click on the Talkdesk tab.



  • In Talkdesk, go to the Admin section, select the Preferences tab and scroll down to SMS Settings.
  • Switch the toggle to the right to enable your SMS settings:



  • A pop-up window will be displayed and you can click the “X”, as we can execute this step later.



  • Drag the phone numbers of your choice to the left column and hit Save



  • Go to the Integrations tab and open your Salesforce integration settings by clicking on Configuration:




  • Save the configuration without changing anything, by simply clicking on the Save button. This will force the SMS-enabled phone numbers to immediately synchronize with Salesforce.


Now you can add the SMS component to your case or contact page layout.

You can set up the visualforce page “SmsToCaseLayout” (or “SmsToContactLayout”) using Lightning Page Layout, Classic Page Layout, and Feed Page Layout for Case (or Contact) in Salesforce.


Defining a default contact phone field to be used

You can set a default contact phone field (standard or custom) to be used in the Talkdesk SMS component.


In order to do this go to Talkdesk Admin > Settings > SMS for Contact/Case default field; next, choose the desired field and click Save.


Setup of the component in Salesforce Lightning

Please follow these guidelines to set up the Case object. If you wish to set up the Contact object, the procedure is very similar.

  • After enabling SMS in your Talkdesk account preferences, open the Setup in Lightning:



  • Select Object Manager and then Case:



  • Open the Case Page Layouts and hit New:



  • Create a new page layout:
    • In Existing Page Layout select Case Layout.
    • Type the name Talkdesk Case Layout.
    • Do not tick Feed-Based Layout.
    • Click Save.



  • Select Visualforce Pages, click on Section and drag it to the Case Detail area below so that you can add a 1-column section named “SMS”:



  • Drag the Visualforce Page SmsToCase Layout component to this “SMS” section:




  • Double click on the added component to edit it as follows:
    • Width: 100%
    • Height: 400
    • Tick Show scrollbars.
    • Tick Show label.
    • Click OK.



  • Click Save to save the layout:



  • Click on Page Layout Assignment:



  • Click on Edit Assignment:



  • Select the profiles (it’s possible to select more than one at the same time) and then pick Talkdesk Case Layout from the list. Click on Save when you’re done. 



How to send and receive SMS messages

To start sending SMS messages, select a Case and scroll until you see the SMS component.

  • Choose an outbound number (you can search by friendly name or number):



  • Select the SMS contact (you can search by name):



  • Next, select the contact’s number:


Note: If you have previously selected a default contact number, it will be displayed here by default. For more information on how to configure the default contact number, please read the instructions above, in the section “Defining a default contact phone field to be used”.

  • Finally, type the SMS message and press Send:



  • When the contact replies, the agent will be able to see the SMS on the SMS history:


The Case SMS history shows all SMS messages that are related to the Case, while the contact SMS history shows all SMS messages that are related to the contact. All inbound SMS messages are related automatically to cases and contacts.

The contact algorithm searches for a contact that shares a phone number with the sender's phone number.

The case algorithm works in the following way:

When a contact sends an SMS to the contact center, the system chooses the most appropriate case to append the SMS to. Talkdesk only appends SMS messages to cases that are open and that already have an outbound SMS sent from the chosen outbound number to the contact’s phone number. More specifically, if there are multiple outbound numbers and/or the contact has multiple phone numbers, then the case needs at least one outbound SMS between each combination of outbound numbers and contact numbers in order to appropriately append to the case all SMS messages from that contact. The SMS messages will be displayed in the SMS history of the case, with the contact’s name below the message.

To get an alert when a new SMS is received, you can use Salesforce email alerts.


Setup in Salesforce Console view

  • Choose the sidebar and add Visualforce page. Select the SmsToCase Component:


  • Click save and you are done. Now, when you go to the case view, a new Message box will allow you to start sending SMS messages:


Setup in Salesforce Classic

  • Under Setup, search for Case > Page layouts.


  • Choose the page layout you want to edit.
  • Drag and drop a new section that will be 1 column and name it “Talkdesk SMS”. Include detail Page and Edit Page checkboxes:


  • Drag and drop the “SmsToCaseLayout” to the newly created section and assign it a height of 400 pixels:



For more information, please contact your Customer Success Manager or 


All Articles ""
Please sign in to submit a request.