Custom Button
Render a contextual link button in widget chat without making an external request from the action itself.
Use Custom Button to let the agent render a contextual link in widget chat. Configure a Button Label, an absolute HTTP or HTTPS Button URL, whether it opens in a new tab, and a clear When to show this button instruction. The instruction is important: it is the signal the model uses to decide when to render the button, so a button without it will not appear reliably.
Labels and URLs may contain {{variable}} placeholders that are resolved from the tool context available in the conversation. The preview uses example values to help you see the shape of the button, not to prove that every variable will be available for every real conversation. The action renders a link; it does not fetch the target URL or call an external API on the visitor’s behalf.
Custom Button is low risk and is a widget-only capability. It is stripped from channels that cannot render interactive UI, including email, Slack, REST, and MCP flows. Test the button on your live widget, verify the generated URL and new-tab behavior, and make the label tell visitors exactly what will happen when they select it.