How to enable Yonder

1. From the client’s Dashboard, go to Settings > Users & Permissions and create a new user called “Yonder.” Give this user the highest permission group available.
2. Within the settings of the new “Yonder” user, navigate to the API Keys tab. Add a new API Key, and name it “Yonder API”.
3. Go to the Webhook Tab and create a webhook. It should be labeled “Yonder Webhook”, select Booking Only schema and updated bookings.

4. Please tag @software-partnerships in #softwarepartnerships to let us know that the Yonder integration has been set up and that you have taken all the steps above.

   On the “API Keys” tab of the user – Copy the FH User Key and send it back to the client, confirming that we have enabled the integration from our end.

   BEST PRACTICE: If Yonder will manage the review management for the client, it will be best practice to disable the follow-up Emails/reviews that are sent out by FareHarbor.

   !ONLY FOR SOFTWARE PARTNERSHIPS TEAM!

5. Add Dashboard to Yonder Channel API: Go to the Settings section in the Admin Dashboard > Integrations. Find the Yonder APP key and click on Edit > Add the company to the Yonder list.

Triggering the webhook for existing bookings

The webhook will automatically send Yonder every booking moving forward, but action is still required in FareHarbor to send Yonder any existing bookings for future dates. Here are the required next steps to ensure that we send Yonder every future booking that they need in their system.

1. Run a report to see existing bookings for future dates Run a Detailed Bookings report in the charter company’s Dashboard to see all bookings for future availability dates. It is best to select a custom date range starting with today’s date and ending with 2 years from that date (or as far out as that company has future bookings.)

2. Initiating the webhook for each future bookings The Business Intelligence script can automate webhooks for companies with 100 or more future bookings (if there are fewer than 100 future bookings, follow these steps instead).

To send an automation request to the Business Intelligence team:

1. Click the Share button within your report, and copy the unique report URL:
2. Paste that report URL into a FareHarbor Automation submission request form.
3. In the Select Automation Type field, select Webhook Update.
4. In the Date automation can start field, enter today’s date.
5. In the Maximum date of completion field, enter 5pm of the next business day.
6. In the Link to FareHarbor report of bookings field, paste the URL of your future bookings report.
7. Reference this help page for more information about submitting this type of form.

Manually initiating the webhook when there are fewer than 100 future reservations

When there are fewer than 100 future reservations, the webhook can be initiated by opening each booking in the report and “touching” the booking:

• Open the booking and click Edit contact.
• Remove and re-add the contact information by cutting and pasting.
• Save your changes to trigger the webhook. Watch video example

The process is now complete, and you don’t have to submit a Business Intelligence request form.

3. Final steps (when submitting an automation request for 100+ future reservations)
   • The Business Intelligence Team will run that report through the script they designed.
   • Once completed, Business Intelligence will post in the #fareharbor-automation Slack room, confirming the Webhook Automation has been completed.
   • At that point, you may close the ticket! In the internal note, please write the date that the Webhook Automation was completed.

Watch a video, or read the steps below:

1. Within the Yonder interface, go to “Settings/Booking system setup” and select FareHarbor.
2. Client will then reach out to FareHarbor support and share the webhook information.
3. Client will expect to receive back API credentials and business shortname. Then they can enter these into the Yonder interface and “Activate”.
4. Once activated, an API call is made to retrieve a list of all items. This enables
5. Clients to select on/off which items they’d like surveys to be automatically sent (Under Booking system integration > Manage Products)
6. Item details to enable the chatbot to retrieve live availability information.
7. Note: “Organization” is something clients who have multiple organizations manually specify within Yonder. It enables them to customize certain features within Yonder to their different organizations (such as a different location or outlet).

More information on how to enable the integration within Yonder interface:

• Support page, specific to Fareharbor
• General Yonder support page: https://support.yonderhq.com/