Org Setup for Chat in Lightning Experience with a Guided Flow

Use the guided setup flow in Lightning Experience to add chat to your org.

The legacy chat product is scheduled for retirement on February 14, 2026, and is in maintenance mode until then. During this phase, you can continue to use chat, but we no longer recommend that you implement new chat channels. To avoid service interruptions to your customers, migrate to Messaging for In-App and Web before that date. Messaging offers many of the chat features that you love plus asynchronous conversations that can be picked back up at any time. Learn about chat retirement in Help.

Important

If you use the Permitted Domains setting in your Chat deployment, you’ll get unreliable information from the chat availability check in the SDK. For instance, the agent availability status may always return false. If you want to use Permitted Domains for your web chat deployment, we strongly advise that you create a separate deployment for the Service SDK.

Warning

These instructions walk you through a basic chat setup in Lightning Experience. To learn more about chat, check out the Web Chat Basics Trailhead module.

  1. Click the Setup gear icon and select Service Setup.

    Service setup

  2. Under Recommended Setup, click View All.

    Recommended setup

  3. In the search box, enter Chat, and select Chat with Customers.

    If you don’t see the Chat with Customers setup flow, verify that your org includes the Digital Engagement add-on SKU.

    Note

  4. After you read the overview page, click Start.
  5. Enter the name of your queue (for example, Chats) and agent group name (for example, Chat Agents). Then select the members for this group and click Next.

    Create queue

  6. If you're asked to prioritize chats with your other work, enter the routing configuration name (for example, Chats) and give it a priority (for example, 1).

    Routing configuration

  7. (Optional) Adjust the work item size and agent capacity.

    Agent workload

  8. For the website URL, enter either:
    1. The URL of your site.
    2. https://, followed by the last part of your site’s URL: https://*.my.site.com, https://*.salesforce-sites.com, or https://*.force.com.
    Then create or select a site.

    Set up website

  9. For the type of chat, select Service.

    Service type

  10. Choose whether you want to provide offline support for customers.

    Offline support

  11. Copy the code snippet by clicking Copy to Clipboard, and paste it into a text editor. You must extract a few pieces of information from this code snippet.

    Copy to clipboard

  12. In the text editor, copy the following configuration information from the embedded_svc.init function.
    • (1) Chat Endpoint Hostname—This value is the hostname of the baseLiveAgentURL property. When copying the hostname, be sure not to include the protocol or the path. For instance, if the value for baseLiveAgentURL is https://MyDomainName.my.salesforce-scrt.com/chat, then the hostname is MyDomainName.my.salesforce-scrt.com.

    • (2) Org ID—If you don’t already know this value, it’s the fourth argument in the embedded_svc.init function call.

    • (3) Deployment ID—This value can be found in the deploymentId property.

    • (4) Button ID—This value can be found in the buttonId property.

    Chat snippet

    Give these four settings to your developer.

    If you don’t copy this information now, you can copy it later using the instructions in Get Chat Settings from Your Org.

    Note

  13. Go back to the guided setup flow and click Finish.

    Finish setup

  14. (Optional) If you want to build a chatbot to complement your chat experience, see Einstein Bots in Salesforce Help. In broad strokes, you must enable Einstein Bots, deploy the bot to your channel, and activate the bot. If you want to learn about building a more robust bot, see the Einstein Bots Developer Cookbook.
You’re all set! Chat is now set up in your org. You can always fine-tune these settings from Setup. To learn more, see Chat in Salesforce Help.

To learn about chat timeout limitations on iOS devices, see When does a chat session time out?

Note