Choose a widget installation method
Use the supported plugin or site-code setup for your platform.
WordPress and WooCommerce
Use the Message WordPress plugin and connect it to the intended workspace. Configure the widget and any supported knowledge sources separately. Download and setup instructions are linked from https://app.message.com/settings/integrations/wordpress.
Shopify
Connect the Shopify app and enable its app embed on the published theme. Check https://app.message.com/settings/integrations/shopify. Installation and provider approval are separate from enabling private order access.
Other website builders
Use the platform setup offered at https://app.message.com/settings/integrations/websites or add the standard snippet through your builder’s supported site-code feature. A manual embed is not a marketplace app or a native data connector. Do not assume the directory implies marketplace approval.
Use the site embed identifier
Copy your current snippet from https://app.message.com/settings/chats/installation. Replace YOUR_EMBED_ID with the data-site-id value from that snippet. It is the site’s public embed identifier, not the workspace database ID or a secret API key.
Install once in the persistent page or application shell. The bundle renders its own launcher and panel inside Shadow DOM.
<script async src="https://app.message.com/widget.js"
data-site-id="YOUR_EMBED_ID"></script>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.