Three parties
Apps never talk to you directly, and you never hold a publisher’s secret.
What happens when an agent opens a contact
- 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.
mountEmbeddedApps()loads the Rollout frame from Rollout’s origin, and hands it the token and the contact.- 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.
- 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.
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 samecontext 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.