# 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**
1. Meta requires that the Facebook page and Instagram business profile be linked.
2. 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](https://rms-docs.mozrest.com/partner-api/venues#create-venue) or [fetch details of an existing venue](https://rms-docs.mozrest.com/partner-api/venues#get-a-specific-venue).

Additionally, Mozrest allows you to filter venues based on Facebook and Instagram installation statuses. Refer to the [Get Available Venues documentation](https://rms-docs.mozrest.com/partner-api/venues#get-available-venues) 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.

div
iframe
### 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:

1. Your SSO page receives an `mz_callback` parameter.
2. Display a login page on your SSO page, allowing users to authenticate.
3. After authenticating, redirect to the `mz_callback` URL with a `venueID` parameter.
4. 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.

## Resources

- Postman Collection
- Meta SSO Onboarding Flow
- SSO Code Example
- Meta Support & FAQ


## End-user Guides to Add Your Branding

- Add the Reserve Button to the Facebook Page
- Add the Reserve Button to the Instagram Business Profile
- Connecting Instagram and Facebook Accounts
- Disconnecting Instagram and Facebook Accounts