Meta Integration Guide
Purpose
This document provides a comprehensive guide to onboard your venues seamlessly onto Facebook and Instagram using Mozrest integration options.
Important Notes
- Meta requires that the Facebook page and Instagram business profile be linked.
- Due to limitations in Meta's sandbox, the installation flow for Meta can only be tested in a live environment.
Install Options
Mozrest offers two options for enabling the Reserve button on Facebook and Instagram:
1. Use Mozrest Install Link
You can embed a Mozrest-generated installation link within your app, allowing venues to enable Facebook and Instagram booking buttons directly from your interface. Mozrest provides this pre-built link (fbInstallLink) when you create a new venue or fetch details of an existing venue.
Additionally, Mozrest allows you to filter venues based on Facebook and Instagram installation statuses. Refer to the Get Available Venues documentation to learn more about using filters[fbInstalled] and filters[igInstalled].
Demo of the End-User Flow
Watch a demo of how the end-user flow appears.
2. Install from Facebook or Instagram via Single Sign-On
Mozrest offers a Single Sign-On (SSO) flow, enabling venues to initiate the Reserve button setup directly from Facebook or Instagram. In this flow, the venue can use their existing credentials from your app, and Mozrest will identify the venue without storing any personal data.
To implement this:
- Your SSO page receives an
mz_callbackparameter. - Display a login page on your SSO page, allowing users to authenticate.
- After authenticating, redirect to the
mz_callbackURL with avenueIDparameter. - Mozrest will verify the venue and continue the Meta onboarding process.
After developing your SSO page, provide Mozrest with its URL for configuration.
Note: The venue must exist in the Mozrest system for this integration.
Refer to the SSO flow diagram for a detailed visual representation of the setup.