Quickstart

From signup to your first chat in three minutes. No build step, no framework lock-in, no credit card.

1. Create a workspace

Open app.message.com/register. Pick a workspace name (this becomes your subdomain for inbound email tickets later). The onboarding wizard captures your brand colour, your site URL, and which channels you plan to use.

The onboarding wizard takes about 90 seconds. If you skip it you can run through it later from Settings → Onboarding.

2. Copy your install snippet

Navigate to Settings → Chats → Installation. Click Copy snippet. The snippet looks like this with your workspace ID filled in:

HTML

<!-- Paste before </body> -->
<script>
  (function(d,s,o){
    var j=d.createElement(s);j.async=1;j.src='https://app.message.com/widget.js';
    j.dataset.workspace=o;
    d.head.appendChild(j);
  })(document,'script','YOUR_WORKSPACE_ID');
</script>

What this snippet does

Creates an asynchronous <script> tag so the widget never blocks page render.
Loads our bundle from app.message.com/widget.js (cached aggressively by Cloudflare).
Tags the request with your workspace ID so the bundle knows which workspace it belongs to.
Mounts inside a Shadow DOM root, so your site CSS cannot leak in or out.

3. Paste it on your site

Paste the snippet anywhere on the page (ideally right before </body>). Reload. A launcher appears in the bottom-right corner.

If you already use a content management system or a one-click install platform, see the relevant tutorial:

4. Send your first message

Open your site in one browser window. Open app.message.com in another. You should see a fresh visitor appear in the inbox within two seconds.

From your site, click the launcher in the bottom-right corner.
Type a message and send it.
From app.message.com, reply.
Watch the reply land back on your site in real time.

5. Identify your visitors

By default, every visitor is anonymous. Identifying them lets you link conversations across sessions, surface their CRM data inside the inbox, and feed AI with their actual history.

HTML · identify visitor

<script>
  // Once the widget bundle has loaded, identify the visitor.
  // window.Message is exposed by the snippet above.
  window.MessageOnReady = function () {
    window.Message.identify({
      email: '[email protected]',
      name: 'Alice Johnson',
      userId: 'crm-4567'
    });
  };
</script>

For production use, sign the identify payload with HMAC to prevent impersonation. See Identifying visitors.