Skip to content

Meta (Instagram & Messenger) Setup Guide

Connecting your bot to Facebook Messenger and Instagram Direct Messages requires configuring an app in the Meta Developer Portal.

This process involves several steps because Meta requires explicit permission and webhooks to route messages from their platforms to your FRENZY.BOT instance.

Prerequisites

Before starting, ensure you have: 1. A Facebook Page for your business. 2. An Instagram Professional Account (Business or Creator) linked to that Facebook Page. 3. Access to your FRENZY.BOT dashboard to get your Webhook URL.

Step 1: Create a Meta App

  1. Go to the Meta Developer Portal and log in.
  2. Click My Apps in the top right, then click Create App.
  3. Select Other as the app type and click Next.
  4. Select Business and click Next.
  5. Enter an App Display Name (e.g., "My Business Bot") and your contact email.
  6. Select your Business Account (optional but recommended) and click Create App.

Step 2: Add Products to Your App

From your App Dashboard: 1. Scroll down to Add products to your app. 2. Find Messenger and click Set Up. 3. In the left sidebar, click Messenger → Instagram settings (if you want Instagram) or stay on Messenger → settings (for Facebook Messenger).

Step 3: Generate Access Tokens

You need a Page Access Token to allow FRENZY.BOT to send messages on your behalf.

  1. Under Messenger → Settings, find the Access Tokens section.
  2. Click Add or Remove Pages and authenticate with your Facebook account.
  3. Select the Facebook Page(s) you want to connect and grant the requested permissions.
  4. Once the Page is linked, click Generate Token next to it.
  5. Copy this token immediately and save it. You will paste this into the FRENZY.BOT dashboard.

Step 4: Configure the Webhook

This tells Meta where to send incoming messages.

  1. In your FRENZY.BOT Dashboard, go to Channels → Messenger (or Instagram).
  2. Look for your unique Webhook URL and Verify Token on that page.
  3. Back in the Meta Developer Portal, scroll down to the Webhooks section (under Messenger Settings).
  4. Click Add Callback URL.
  5. Paste the Webhook URL and Verify Token from your FRENZY.BOT dashboard.
  6. Click Verify and Save.

Step 5: Subscribe to Events

You must tell Meta which events to send to your webhook.

  1. In the Webhooks section, click Manage next to your Page name.
  2. Subscribe to the following fields:
  3. messages (Required for text messages)
  4. messaging_postbacks (Required for button clicks/quick replies)
  5. messaging_optins (Optional, for "Get Started" buttons)
  6. Click Save.

Step 6: Find Your IDs

If you are setting up Instagram, you need specific IDs:

  1. Instagram Account ID:
  2. Go to Facebook Page Settings → Linked Accounts → Instagram.
  3. Or use the Graph API Explorer: GET /v18.0/me?fields=instagram_business_account
  4. Recipient IGID:
  5. This is the Instagram-scoped ID of the person you want to receive alerts (if using Instagram as an Integration). For the Channel setup, this is usually not required unless specified in the dashboard.

Step 7: Finalize in FRENZY.BOT

  1. Go back to your FRENZY.BOT Dashboard (Channels → Messenger or Instagram).
  2. Paste the Page Access Token you generated in Step 3.
  3. Paste any required IDs (like the Instagram Account ID).
  4. Toggle Enable to turn the channel on.
  5. Click Save Settings.

⚠️ Crucial: App Review (Going Live)

When you first create a Meta App, it is in Development Mode.

In Development Mode, your bot will only respond to you and other developers/testers added to the app in the Meta portal (under App Roles).

To make your bot respond to the general public, you must: 1. Complete Business Verification in the Meta Developer Portal. 2. Request Advanced Access for specific permissions (usually pages_messaging and instagram_manage_messages). 3. Submit a screencast showing how your bot works. 4. Once approved, switch the app toggle at the top of the screen from Development to Live.

Note: Meta's review process can take several days.