Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Proactive Recommendations configuration for Engagement Messenger

The Proactive Recommendations feature enables you to show context-based suggestions in real time and to configure the recommendations experience on Engagement Messenger.

Note: To integrate Proactive Recommendations on a web page, you need to enable recommendations in the embed code of Engagement Messenger.

FieldDescription
Enable recommendationOption to show or hide the recommendations.
Title textTitle of the recommendation screen in the messenger.
Subtitle textHelpful text about the recommendations that displays at the top of the recommendations screen.
Show the search barOption to display the search bar on the Recommendation page that enables you to search content in addition to the provided recommendations.
Maximum number of recommendationsThe maximum number of recommendations to be shown on the recommendations screen.
Link text for additional recommendationsText for the link that enables the user to view an additional recommendations.
Link text for Engagement MessengerText displayed in the footer of the messenger to enable navigation to the Engagement Messenger home page. Use the `[[display text]]` format to add a clickable link to messenger.
- If AI Search does not return any recommendations, then the Engagement Messenger home page is displayed. - You need to enable AI Search to make Recommendations available to users.
FieldDescription
TypeType of display to show the suggestions proactively on messenger after 30 seconds of inactivity. Select None to disable proactive behavior.
Choose an animation typeThe type of animation for the launcher icon that activates when the user is inactive. - Ripple \(like a wave\) - Bounce
Show a tooltip above the iconOption to show the tooltip message above the launcher icon.
Tooltip textThe message displayed on the tooltip.
Offer search
Title textTitle of the widget that appears when Offer search is selected as the proactive help type.
Subtitle textDescription of the widget that appears on the widget body and appears below the title text.
Placeholder textPlaceholder text that appears in the search box.
Offer chat
Title textTitle of the widget in the messenger.
Subtitle textDescription of the widget in the messenger.
Chat button labelLabel of the button that is displayed for the user to start the conversation.
Offer the recommendation you configured
Select the Offer the recommendation you configured option to show the knowledge article and catalog items recommendations proactively as per the configuration in the Recommendations section.
Note: AI Search needs to be enabled for Offer search and Offer the recommendation you configured options.