Setting up the Smartwaiver Integration Add-on to FareHarbor

Integrate your Smartwaiver system with Fotaflo. This integration provides a more seamless photo delivery experience for you and your guests.

This guide helps you integrate your Smartwaiver system with Fotaflo by sending waiver data using webhooks from Smartwaiver and combined with reservation information from FareHarbor.

When a webhook waiver is sent, Fotaflo will parse the request and store

  1. the name and contact information of the guests

It will then create or update a label for that reservation using the contact names provided in each waiver. A tour guide using the Fotaflo app to take photos of guests will be able to select any labels for tours which begin within 24 hours (12 hours in the past to 12 hours in the future). Once one or more labels are selected they can continue the tour and any photos taken will be labelled when uploaded to Fotaflo.

The primary benefit of adding the Smartwaiver integration on top of the FareHarbor integration is to gather contact information for each tour participant in order to seamlessly deliver all their photos using a single label.

Deliveries are automatically sent according to the following default settings:

  • If your location does purchase or giveaway deliveries, within 5 minutes of the first photo uploaded to that label after the tour start time.
  • If your location does preview deliveries, one hour after the tour end time

FareHarbor Integration

To get started, you'll need to already have set up the FareHarbor integration and your FareHarbor account must already be connected to Smartwaiver.

Smartwaiver Integration Setup Summary

  1. Log in to Smartwaiver and obtain a new API Key following these instructions.
  2. Go to the Fotaflo integration settings page and select Smartwaiver from the list of possible integrations.  If you are unable to reach the page, please contact Fotaflo support.
  3. Enter the API Key you obtained from Smartwaiver and paste it into the Smartwaiver API Key field then click Create:
  4. Select the Manage Integration Keys button
    Screen Shot 2020-05-22 at 2.05.05 PM
  5. Click the Generate Integration Key button in the lower right-hand corner:
                                              Screen Shot 2020-05-22 at 2.01.51 PM
  6. In Smartwaiver, go to the API Webhook settings and enter the following URL in the 'Your Webhook URL' section: https://[INTEGRATION KEY]:@2.fotaflo.com/reservations/smartwaiver.json
    1. Replace [INTEGRATION KEY] with the key you generated in step 5
    2. For example, if the [INTEGRATION KEY] were abcd1234abcd1234abcd1234 then the URL should be: https://abcd1234abcd1234abcd1234:@2.fotaflo.com/reservations/smartwaiver.json
    3. Make sure 'Web Endpoint' and 'Do not wait for email validation' are set, then click the Update button to save

Warning: If it looks like you are going to remove the FareHarbor Integration or any other integrations you will need to contact Smartwaiver to set up a second webhook, so email them the ‘Webhook URL’ to support@smartwaiver.com

  1. The integration should now be active and ready to test.  If you would like to import upcoming waivers that were created before the integration was enabled please contact Fotaflo support.

Testing the Smartwaiver Integration 

  1. Make a booking with Fareharbor
  2. Sign the waiver that gets emailed with a different name/email than the original booking.
  3. Look in Fotaflo for a matching label for the name in step 2.
  4. Add the label to a photo and make sure the album gets delivered to both email addresses.