You are here:
Automated Invitation Settings
Automated invitation settings control the invitations that prompt your customers to chat with agents on your website.
Required Editions
| View supported editions. |
Legacy Chat will be retired on February 14, 2026. To avoid service interruptions to your end users, switch to enhanced Chat (formerly Messaging for In-App and Web). Enhanced Chat offers many of the legacy Chat features that you love plus asynchronous conversations that can be picked back up at any time. Learn about migrating in Help and Trailhead.
Apply settings when you create or edit an automated chat invitation.
Basic Information
Configure the basic functionality that’s available on a particular Chat invitation.
| Setting | What It Does |
|---|---|
| Type | Determines whether to create a chat button or automated invitation. Important When creating an automated chat invitation, you must set this
option to Automated Invitation. |
| Active | Determines whether the automated invitation is active, or can automatically be sent to customers. |
| Name | Names the invitation. This invitation name, or a version of it, automatically becomes the Developer Name. |
| Developer Name | Sets the API name for the invitation. |
| Language | Sets the default language for text in the chat window. |
| Enable Customer Time-Out | Indicates whether chats are ended if the customer doesn’t respond within a specified period. |
| Customer Time-Out (seconds) | Sets the amount of time that a customer has to respond to an agent message before the session ends. The timer stops when the customer sends a message and starts again from 0 on the next agent's message. |
| Customer Time-Out Warning (seconds) | Sets the amount of time that a customer has to respond to an agent message before a warning appears and a timer begins a countdown. The warning disappears (and the timer stops) each time the customer sends a message. The warning disappears (and the timer resets to 0) each time the agent sends message. The warning value must be shorter than the time-out value (we recommend at least 30 seconds). |
| Custom Agent Name | Sets the agent’s name in the chat window. |
| Auto Greeting | Sets a customized greeting message that the customer receives automatically when an agent accepts the customer’s chat request. Optionally, use merge fields to customize the information in your greeting by using the Available Merge Fields tool. For example, you can personalize the chat experience by using merge fields to include the customer’s name in the greeting. Note If you specify an automatic
greeting message in your Chat configuration and chat invitation, the message in
the invitation overrides the message in the configuration. |
Routing Information
Specify how this invitation routes chats to the best-fit agent.
| Setting | What It Does |
|---|---|
| Routing Type | Sets how chats are routed to an agent. |
| Skills | Associates skills with the invitation. If you select Omni-Channel Skills as the routing type, incoming chat requests are routed to agents with the skills that you specify. |
| Enable Queue | Indicates that queueing is enabled. Queueing allows incoming chat requests to wait in a queue until an agent with the appropriate skills is available to accept the chat. |
| Queue Size Per Agent | Determines the queue’s capacity to hold chat requests per available agent. For Live Agent routing or when chats have a size of 1, this setting controls the number of chats allowed to queue for each agent. |
| Overall Queue Size | Determines the queue’s capacity to hold chat requests. For Live Agent routing or when chats have a size of 1, this number is the maximum number of chats allowed to queue. |
Invitation Animation
Customize your invitation’s animations to determine how the animation appears to customers.
| Setting | What It Does |
|---|---|
| Display Time | Determines how long the invitation is displayed to customers before it disappears. |
| Allow invitation to be triggered again after accepting | Indicates whether the invitation can be sent to the customer again after the customer has accepted a previous invitation. |
| Allow invitation to be triggered again after rejecting | Indicates whether the invitation can be sent to the customer again after the customer has rejected a previous invitation. |
| Animation | Determines the type of animation for your invitation. Depending on which animation you choose, you’re prompted to select the positions where the invitation appears on-screen to customers. |
Invitation Customization
You can optionally customize your invitation with custom images by associating your deployment with a Salesforce site and its static resources.
| Setting | What It Does |
|---|---|
| Site for Resources | Determines the Salesforce site that’s associated with the invitation. By associating your invitation with a Salesforce site, you can customize the invitation with branding images. Store your branding images as static resources with your Salesforce site. |
| Online Image | Sets the custom invitation graphic that appears when the chat invitation is available for customers to request new chats. |
| Offline Image | Sets the custom invitation graphic that appears when the chat invitation is unavailable. |
| Custom Chat Page | Replaces the standard chat window with a custom chat window page that you’ve developed. Use this option only to use a chat window other than the default chat window. |
| Pre-Chat Form Page | Directs chats to the Lightning Platform page that hosts your customized pre-chat form that customers see before they begin a chat with an agent. |
| Pre-Chat Form URL | The absolute URL of your pre-chat form page. |
| Post-Chat Page | Directs chats to your customized post-chat page that customers see after they complete a chat. |
| Post-Chat Page URL | The absolute URL of the web page that hosts your post-chat page. |
Sending Rule
Create sending rules for your invitation to determine when to trigger and send the invitation to customers. You can include multiple criteria in your sending rule. Also, if your sending rule requires more complicated logic, you can apply Boolean operators to your sending rule.
| Setting | What It Does |
|---|---|
| Criteria | Sets the criteria that the sending rule evaluates. For example, you can create a rule that sends the invitation based on how many seconds a customer has been viewing a web page for. |
| Operator | Sets the operator to evaluate your criteria. For example, you can create a rule that sends the invitation when a customer has been on a page for more than a specified number of seconds. |
| Value | Sets the value to evaluate the formula against. For example, you can create a rule that sends the invitation when a customer has been on a page for more than 30 seconds. |

