¿Ya eres cliente de Spur?

Entrar
Spur Embed

Show a Spur conversation inside your CRM

Put one contact’s WhatsApp conversation (the thread, the reply box and the conversation header) inside your CRM, admin panel or internal tool. Your server mints a short-lived token with your workspace API key, and the frame turns it into a session. Nobody on your team signs in to Spur, types a Spur password or enters a one-time code.

The frame is served from https://embed.spurnow.com and shows one conversation at a time. It doesn’t include the conversation list, filters, the contact panel or settings: your CRM already has those, and it decides which conversation is on screen.

How it works

  1. 1

    Someone opens a record in your CRM

    Your page makes a one-time code verifier and asks your own backend for a Spur embed URL for that contact, sending only the verifier’s hash.

  2. 2

    Your backend mints a token

    It calls POST /embed/tokens with your workspace API key: which Spur user the frame acts as, which contact (by number or Spur ID), which of your WhatsApp numbers, and the hash.

  3. 3

    Spur returns a one-time embedUrl

    Plus the contact, conversation and number it resolved, so you can store the IDs on your record.

  4. 4

    Your page sets embedUrl as the iframe src

    Your page answers the frame’s spur:ready with the verifier. The frame swaps the token and the verifier for an 8-hour session and opens the conversation. Nobody types a password or a one-time code.

  5. 5

    Switching records is a message, not a new token

    Your page posts spur:openConversation to the frame. When the session ends, the frame tells your page, and your backend mints a fresh token.

A token works once, expires after 60 seconds and only loads from one of your allowed origins. The session lives in a cookie on embed.spurnow.com that is partitioned to your site, so it works with third-party cookies blocked and is never shared with other sites or with the Spur dashboard.

What’s in the frame

Header

The contact’s name and number (masked for masked users), OPEN or CLOSED status, Close ticket and, when the number has WhatsApp calling, the call button.

Thread

Messages, media, internal notes, workflow and AI agent markers and delivery ticks, rendered exactly as in Spur.

Composer

Reply and Note, templates, quick replies, attachments, emoji and voice notes.

Not included, by design: the conversation list, search and filters, the contact side panel, reports, settings, and any sign-in or sign-out controls. The frame is WhatsApp only. It works from 380 × 520 pixels and is comfortable at 480 × 640.

Browsers

Chrome, Edge, Firefox and Safari 18.4 or later. Older Safari versions drop the partitioned cookie, so the frame asks your page for a new token every time it loads. It still works; it just isn’t in our test matrix.

Documentation map

FAQ

Can I embed the whole inbox?

No. The embed shows one conversation at a time. Your CRM decides which one with spur:openConversation.

Can people browse to other conversations from inside the frame?

No. There’s no list to browse, and every conversation your page asks for is checked against the Spur user’s permissions.

Does my team need Spur logins or one-time codes?

No. They never see Spur’s sign-in or OTP screens. Each person acts as a Spur user with a seat in your workspace: their own, or one shared user for everybody.

Does being signed in to Spur affect the embed?

No. The embed has its own session on embed.spurnow.com. Signing in to or out of the Spur dashboard doesn’t touch it.

Why can’t my page open a conversation by phone number?

Because the number would then sit in your page’s JavaScript and in the frame URL, where anyone with browser devtools can read it. Numbers only go from your server to Spur; the browser works with IDs.

Does this work inside Zoho, HubSpot or Salesforce?

Yes: anywhere you can render an iframe and run a small backend. Add the host page’s origin (for example https://crm.zoho.in) to your allowed origins.

Can I put this on my storefront for customers?

No. Embed tokens sign in your team, acting as a Spur user. For chat on your website, use the Spur website widget.