Skip to content

Get started as a developer

What you can build with Presence Orbit, which credential each part needs, and your first request, from reviews on your own website to review requests sent by your shop system.

Tutorial3 min read

Presence Orbit keeps your organisation's locations, their reviews from Google, Facebook, Trustpilot and other sites, and the review requests you send. As a developer you can show those reviews on your own website, send review requests from your own systems, and let AI assistants work with Presence Orbit.

What to use for what

Show reviews on any website, with no code to maintain
Credential
None
Plan
Every plan
Show reviews with your own markup
Credential
None
Plan
Every plan
Show reviews on a website built with CMS Orbit
Use
CMS Orbit's own review blocks. See Your reviews on websites built with CMS Orbit
Credential
None
Plan
Every plan
Ask customers for a review from your till, booking or shop system
Credential
Secret key, pre_sk_
Plan
Growth and above
Let Claude, ChatGPT or another assistant work with Presence Orbit
Use
Credential
OAuth sign-in as a person
Plan
Every plan
React when a review arrives
Use
Events through Orbit Exchange, for Orbit's own satellites
Credential
None for you to manage
Plan
Every plan

Reviews for travel bookings, orders and appointments in Orbit's own satellites need no code: see Ask for reviews after trips and orders.

Addresses

Everything lives under one address:

Text
https://app.bifrostorbit.com/presence
Public reviews API
Address
/presence/api/public/{business}/reviews
Review requests API
Address
/presence/api/v1/organisations/{organisationId}/requests
Widget script
Address
/presence/embed.js
MCP server
Address
/presence/mcp

{business} is your organisation's Short name under Settings, such as northwilds. {organisationId} is the id in the address bar when you open Presence Orbit: /presence/o/{organisationId}.

1Read your reviews

The public reviews API needs no key, so you can try it in a terminal:

Shell
curl "https://app.bifrostorbit.com/presence/api/public/northwilds/reviews?location=northwilds-oslo&limit=3"

It answers with the average, the number of reviews, the newest reviews and a sentence that says where they come from:

JSON
{  "data": {    "business": "Northwilds Oslo",    "average": 4.6,    "total": 131,    "reviews": [{ "author": "Ingrid B.", "rating": 5, "text": "Great advice on boots for the Lofoten trip.", "sourceName": "Google" }],    "disclosure": "Reviews from Google, Facebook, Trustpilot and Imported, the newest first, none left out. 3 of 131 shown. Published as written by customers; we reply but never edit them.",    "howUrl": "https://app.bifrostorbit.com/presence/l/northwilds/northwilds-oslo"  }}

Each review has more fields than shown here. See Public reviews API.

2Put them on a page

The quickest way is the widget. Build it under Widgets in the sidebar, or paste this and change the names:

HTML
<div data-presence-reviews data-business="northwilds" data-location="northwilds-oslo" data-layout="list"></div><script src="https://app.bifrostorbit.com/presence/embed.js" async></script>

See Embed review widgets for every attribute and for styling.

3Choose who may load them

By default any website can load your reviews. To allow only your own, an Admin lists them under Settings, Your website: your main website and up to 19 more, such as https://staging.northwilds.com. Browsers on other websites then get 403.

4Send a review request

For requests from your own systems, an Admin creates a key under API keys. Every key is a secret key, starting pre_sk_, which stays on your server: Presence Orbit refuses it from a browser.

Shell
curl -X POST "https://app.bifrostorbit.com/presence/api/v1/organisations/{organisationId}/requests" \  -H "Authorization: Bearer pre_sk_…" \  -H "Content-Type: application/json" \  -d '{ "name": "Ingrid Berg", "email": "ingrid@example.com", "location": "northwilds-oslo" }'

Presence Orbit waits the delay and quiet hours set under Review requests, then sends it. See Review requests API.

What isn't there yet

  • The API playground has nothing to try yet. It fills in as Presence Orbit gets endpoints for locations and reviews.
  • There is no SDK, no GraphQL and no API for locations, replies or listings.
  • The MCP server has one tool so far. See The MCP server.
  • Presence Orbit's events reach your own systems through webhooks in Orbit. See Events.

Was this page helpful?

Read next