message.comDevelopers

Configure proactive chat campaigns

Use supported widget campaign triggers and verify the visitor experience.

Create a campaign

Open https://app.message.com/settings/chats/campaigns. Configure the offered trigger conditions and visitor-facing content. The current widget supports configured URL matching, time on page, exit intent and scroll-depth behavior.

Test frequency and eligibility

Save the campaign and test a page that should match and one that should not. Check the configured frequency and the visitor’s active-chat state before concluding a campaign failed.

No public sendProactive or track method

The shipped widget does not expose those browser methods. Do not add old Message.sendProactive or custom-event snippets. A campaign trigger must be supported by the widget that is actually installed.

Verify the published installation

Test the published page in a separate browser session. Confirm widget.js loads, the launcher opens, a visitor message reaches Inbox and an agent reply returns. Test with your site’s actual content security policy, consent controls and mobile layout.

The script connects to its own origin by default. With the standard snippet, allow the relevant script and HTTPS/WSS requests to app.message.com. Check image, media and injected-style requirements separately. Do not put an agent JWT or integration secret in the page.