Use Orbit Flows with Make
Send events from every satellite to a Make scenario, with a webhook or a flow step, check that they really came from Bifröst Orbit and use the booking, order or review in the next modules.
How-to guide4 min read
Make runs scenarios: a trigger, then modules that act in other apps. With Orbit Flows and webhooks, the trigger can be anything that happens in your satellites. For example, Northwilds sends every Travel Orbit booking to a Make scenario that adds the traveller to its newsletter and creates a deal in its CRM.
You need an owner or admin role in your organisation, a paid satellite plan (see Who can use webhooks) and a Make account.
Choose how to send
Use a webhook when Make should decide what happens. Use a flow step when Orbit should filter first, for example only bookings over €2,000 that the trip lead approved.
1Get an address from Make
- In Make, create a scenario and choose + to add the first module.
- Search for Webhooks and choose Custom webhook.
- Choose Add, name it, such as Orbit bookings, and choose Save.
- Make shows an address like
https://hook.eu2.make.com/n7k2v4qz8wbookings. Choose Copy address to clipboard.
Leave Make open: it is now waiting for the first message, so it can learn the data structure.
2Send events to Make
With a webhook
- In Orbit, open Organisations, choose your organisation, then Webhooks, and choose Add webhook.
- Name it, such as Bookings to Make, and paste the address from Make into Address.
- Tick the events, such as
travel.booking.createdandtravel.booking.cancelled, and choose Add webhook. - Copy the signing secret Orbit shows once and keep it somewhere safe. You need it to check the signature.
Choose ⋯ next to the webhook, then Send a test. Make shows Successfully determined, and the fields of the message are now available in later modules.
Or from a flow
- In Orbit, open Flows and open a flow, or choose New flow.
- Under Then, choose Add a step, then Send to a webhook.
- Paste the address from Make and choose JSON for your own system.
- Write a message, such as
Booking {{event.data.reference}} is paid., and choose Save flow.
To send a first message for Make to learn from, choose Run now on the flow, or wait for the next event. Test the flow only shows what would be sent; it sends nothing.
3Use the fields
In the next module, such as a CRM's Create a deal, pick fields from the webhook:
- From a webhook in Orbit:
eventis the event's type, and the details are indata, such asdata.reference,data.travellersanddata.total. Amounts are in cents, so 249000 is €2,490. - From a flow step: the same event is in
event, so the reference isevent.data.reference. Your message is inmessage, and what earlier steps did is insteps, such assteps.draft001.textfrom an AI step.
Every field each event has is in the event reference.
When several kinds of event go to one scenario, add a Router after the webhook, with a filter on event for each route, such as travel.booking.created on one and travel.booking.cancelled on the other.
4Check the signature
Messages from a webhook in Orbit carry x-orbit-timestamp and x-orbit-signature headers. Checking them stops anyone else who learns the address from sending fake bookings.
- Open the Custom webhook's settings, choose Show advanced settings, and turn on Get request headers and JSON pass-through. The body then arrives as text, exactly as it was signed.
- Add a filter after the webhook. Make the condition:
x-orbit-signatureequal to Make'ssha256function over the timestamp, a full stop and the body, with your signing secret as the key andhexas the encoding. - Optionally, refuse messages whose
x-orbit-timestampis more than five minutes old.
The signature is the HMAC-SHA256 described in Verify webhooks from Bifröst Orbit. Flow steps are not signed, so treat their address like a password.
5Switch the scenario on
Turn the scenario on with the switch at the bottom of Make's editor. Make's webhooks answer straight away, so Orbit counts each message as delivered. If Make is down, Orbit tries again for up to 24 hours; see When your system is down.
Ideas
- New Travel Orbit bookings to your CRM and newsletter.
- Commerce Orbit orders over 500 to your accounting system.
- Careers Orbit hires to your HR system.
- Presence Orbit one-star reviews to a ticket in your help desk, after an Orbit Flows approval.
Was this page helpful?