Website widget

Publish proactive widget messages

Show announcements, videos, and helpful links without starting a support conversation.

Open Widget → Manage proactive messages and choose the correct inbox. Messages belong to that inbox’s widget.

Create an announcement

Choose Announcement, add an internal name and heading, then write the message. You can include a subheading, a public YouTube or Vimeo video, and an HTTPS call-to-action link.

Use the preview to check the message and button color. Videos don’t autoplay. Previewing doesn’t record real views or start chat or AI work.

Save as a draft while you’re working. Publish when it’s ready, or pause it to stop new delivery. Editing a published message does not reset its viewing history.

Choose delivery

Use automatic delivery with the configured delay, or trigger a specific message from your application after the widget has loaded:

await OutcomeArc.showMessage(messageId);

For signed-in audiences, identify the customer first. Your application can decide when to call this—for example, after a customer reaches a particular page or milestone.

Show once prevents repeated delivery for the same recognized recipient. If you’re testing a published message and it no longer appears, check its publication state, delivery mode, show-once history, widget availability, and identification result.

Personalize a destination

A CTA can use signed customer properties in supported URL placeholders. Use Preview customer data (JSON) to check the resolved destination before publishing. Missing or invalid values hide the personalized button, not the whole announcement.

Identify before delivery when the link depends on customer data; otherwise an automatic announcement may be shown without its button and still use its show-once opportunity. The destination app still controls access to its content.

Review reach

Viewers shows message viewing activity. Reports’ Widget Messages tab compares views and popularity across messages. Views measure reach; they aren’t proof that the customer completed the action linked from a button.

Browse all topics →

Still need a hand? Ask our team.