Skip to main content

Three parties

Apps never talk to you directly, and you never hold a publisher’s secret.

What happens when an agent opens a contact

  1. Your page asks your server for a token. Your server signs a short-lived user token for the agent signed in to your CRM, with your Rollout client secret. It names the agent, their org, and the contact on screen.
  2. mountEmbeddedApps() loads the Rollout frame from Rollout’s origin, and hands it the token and the contact.
  3. Rollout finds the apps the agent, or their org, turned on. For each one, it signs a context with that app’s publisher’s secret: who is looking, at which contact, in which marketplace.
  4. The Rollout frame loads each app in its own sandboxed app frame, with its context in the URL. The app checks the signature, tells Rollout it’s ready, and is shown, sized to its content.
The marketplace works the same way: your page asks your server for a token that lets the user turn apps on, and mountEmbeddedAppMarketplace() lists your approved apps and saves each switch with Rollout.

How the pieces fit

The signed contexts and the apps’ traffic stay inside the Rollout frame, out of reach of your page’s scripts.

How an app gets into your marketplace

An app reaches your users only after its publisher lists it and you approve it: Users see an app only while its listing is approved and its publisher’s account is active. Suspending or withdrawing a listing hides it, but keeps every user’s and org’s choice to turn it on, so reinstating or re-approving it restores them all.

Compatible with Follow Up Boss apps

The marketplace follows Follow Up Boss’s embedded apps model: the same context and signature parameters, the same signing, and the same protocol for showing and sizing an app. A publisher with an app for FUB keeps its signature check and FUB’s script, and changes the fields it reads. The Follow Up Boss guide takes publishers through it.

Current limits

  • Apps show on person (contact) records only.
  • Rollout sets up marketplace owners and app publishers. Contact Rollout to get started.
  • Marketplaces are public or invite-only, but invites can’t be sent yet. An invite-only marketplace is hidden from every publisher not already listed in it.
  • An app has one URL for every marketplace. There is no versioning, no per-app secret and no sandbox marketplace yet.
  • No emails are sent when an app is listed or reviewed. Check the dashboard.

Glossary

Next

The implementation plan takes you from first call to a live marketplace.