Skip to content
This site is under construction. Content, screenshots, and workflows may change at any time.

Custom buttons and suggested messages

Two actions help visitors take the next step. A Custom button shows a button that opens a page you choose. Suggested messages shows choices the visitor can tap to send as their next message.

Open Bot > Actions > Action library, then select Custom button or Suggested messages.

Before you start

  • You need the Owner, Team Admin or Bot Admin role.
  • Both actions work on website channels only: Chat bubble, Help page and Center stage.

Custom button

Best for: sending visitors to a page such as pricing, a sign-up form or a help article.

Common requests:

  • “Where can I learn more?”
  • “How do I sign up?”
  • “Where’s your pricing page?”

Add a custom button

  1. Open the template. In Action library, select Custom button, then Start customizing.

  2. Complete General. Enter an Action name, describe in When to use when the button helps, and set Button Text and URL. Select Save and continue.

  3. Choose channels. Turn on the website channels that may show the button, then select Save, or Save & enable.

  4. Enable the action. Turn on Enable action if you didn’t use Save & enable.

Custom button settings

SettingWhat it does
Action nameThe name the bot uses to call this action. Use 3–64 characters. Spaces become underscores.
When to useTells the bot when to show the button. The default is: “Show the configured link when it helps the visitor. This displays a navigation button; it does not perform an operation or confirm that the visitor clicked it.”
Button TextThe text displayed on the button, up to 80 characters.
URLThe website to open when the visitor clicks the button. Use an http or https address, such as https://www.example.com/pricing, without a username or password.

To offer several links, add one Custom button action for each.

Suggested messages

Best for: guiding visitors through common next steps without typing.

Common requests:

  • “What can I do next?”
  • “I have a problem with my order.”
  • “Which plan is right for me?”

Add suggested messages

  1. Open the template. In Action library, select Suggested messages, then Start customizing.

  2. Complete General. Enter an Action name and describe in When to use when to offer suggestions. Choose Auto generate suggested messages, or turn it off and add your own. Select Save and continue.

  3. Choose channels. Turn on the website channels that may show suggestions, then select Save, or Save & enable.

  4. Enable the action. Turn on Enable action if you didn’t use Save & enable.

Suggested messages settings

SettingWhat it does
When to useRequired. Tells the bot when to offer suggestions and what kind. It starts empty; the placeholder shows an example of follow-up guidance.
Auto generate suggested messagesOn by default. The bot proposes up to 5 relevant next messages. Turn it off to write your own.
Add suggested messageShown when auto generation is off. Add up to 5 messages, 200 characters each. Each must be unique.
Disable input fieldPrevents the visitor from typing while the suggestions are shown. The suggestion buttons still work.
Generate after every messageChecks for suggestions after every reply, instead of letting the bot decide. It runs even when no suggestions fit and uses credits on each reply. Only one enabled action per bot can use it.

Suggestions become inactive after the visitor sends a new message or the conversation switches to a person. Visitors can still type their own message unless Disable input field is on.

Channel compatibility

ChannelCustom buttonSuggested messages
Chat bubbleYesYes
Help pageYesYes
Center stageYesYes
APINoNo
Fluent SupportNoNo

Limitations

  • A button only opens a link. It doesn’t run an operation, and the bot can’t tell whether the visitor clicked it.
  • One button per action. Add another Custom button action for each extra link.
  • Up to 5 suggestions. This applies to both generated and manual messages.
  • A suggestion sends an ordinary message. It can’t run an operation directly.

Troubleshooting

Add unique, nonempty messages or enable contextual suggestions.

Possible cause: Auto generate suggested messages is off and the list is empty, has a blank entry, or repeats a message.

Solution: Add at least one unique message, remove blank rows, or turn auto generation back on.

Only one enabled action can generate suggestions after every message.

Possible cause: Another enabled Suggested messages action already uses Generate after every message.

Solution: Turn off the setting on one of the actions, or disable the other action.

Use a URL without embedded credentials.

Possible cause: The button URL contains a username or password.

Solution: Remove them from the address.

Next steps