Skip to main content
~2 minutes setup

What You'll Need

Prerequisites and permissions before starting

Quick Path

Condensed steps for fast setup

First-Time Connection

Complete walkthrough for your first Meta connection

Connecting Additional Accounts

Walkthrough for subsequent connections

Managing Your Meta Services

Enable, disable, and reset your Meta integration

Quick Checklist

Verify your setup is complete

Troubleshooting & FAQs

Common issues and fixes

​
🔓 What This Integration Unlocks

You’ve invested in a strong Facebook presence and you’re running Meta ad campaigns — but right now, every Messenger conversation and every lead form submission requires manual follow-up. Leads go cold while you’re busy, and messages pile up unanswered. Connecting your Meta assets to Irelia changes everything. Your AI agent takes over Messenger conversations automatically, and leads captured through get contacted instantly — with zero manual work. Here’s what each connection enables: By the end of this guide, you’ll have: ✅ Your Facebook Page connected to Irelia for automated Messenger conversations
✅ Your Business Manager connected for Instant Form lead capture
✅ Your desired Meta services enabled and ready to use
✅ The knowledge to connect additional accounts in the future

​
What You’ll Do

  1. Navigate to Irelia settings and open the Meta connection flow (~30 seconds)
  2. Log in with Facebook and authorize the connection (~30 seconds)
  3. Select one Facebook Page and one Business Manager (~30 seconds)
  4. Complete authorization and enable services (~30 seconds)
Connecting additional accounts later? The process is nearly identical — with one key difference covered in Connecting Additional Accounts.

​
📋 What You’ll Need

  • Full control (Admin) access — including finance permissions — to the Business Manager that manages your Facebook Page and runs your lead campaigns Required
  • A Facebook account that has this level of access on the Business Manager Required
No complex setup required. If you can log into Facebook and click a few buttons, you can do this.
For agency accounts: If you’re a marketer or agency setting up for a client, you need to be added as an Admin with full control — including finance permissions — on your client’s Business Manager. Being added as a “Partner” — which is what Meta’s own guidelines recommend — is not sufficient for the process. See Issue 1 in Troubleshooting for how to fix this before you begin.
One Page, one Business Manager — no exceptions. Select exactly one Facebook Page and one Business Manager per Irelia account. Selecting multiple causes erratic behavior (e.g., Irelia responding from the wrong page or showing the wrong Instant Forms) and requires a full reset across every Irelia account linked to that Facebook profile. Already seeing issues? Jump to Issue 2 in Troubleshooting.

​
⚡ Quick Path (Experienced Users)

Already comfortable with Meta integrations? Here’s the condensed version. Which path do you need? If you’ve never connected Meta to any Irelia account with your current Facebook profile, follow the first-time connection steps below. If you’ve connected before (even to a different Irelia account), follow the subsequent connection steps.
  1. Irelia: Go to “Settings” → “Channels Configuration” → Click the “Connect Meta” button
  2. Meta: Log in → Select ONE Facebook Page → Select ONE Business Manager
  3. Irelia: Enable desired services with toggles
Need more detail? Continue with the full guide below.

​
🔌 First-Time Connection

Follow these steps if this is your first time connecting Meta assets to any Irelia account using your Facebook profile.
1

Access Your Channel Settings

1 minuteNavigate to your Irelia settings page: 👉 https://irelia.ai/settings?menu=settings&settings_tab=generaleYou’ll see the “Channels Configuration” section.
Irelia.ai Meta Messenger and Instant Forms connection guide, Step 1 — Access Your Channel Settings. The Settings page General tab shows the Channels Configuration card with Whatsapp connected to this number 155 and the blue Connect Meta button outlined in red with an arrow pointing to it. It shows exactly where to click to start linking a Facebook Page and Business Manager to Irelia.

Channels Configuration screen with the Connect Meta button

2

Start the Meta Connection

Click the blue “Connect Meta” button. A new browser tab will open with Meta’s Embedded Signup authorization flow.
3

Log In with Facebook

If prompted, log in with your Facebook account that has full control (Admin) access to your Business Manager.
Irelia.ai Meta Messenger and Instant Forms connection guide, Step 3 — Log In with Facebook. A Facebook authorization popup asks Continue as Paolo Scirpoli, noting Irelia will receive your name and profile picture, with a red arrow pointing to the blue Continue as Paolo Scirpoli button next to the Not Now option. It confirms which Facebook account is authorizing the connection before page and Business Manager selection.

Facebook login during Meta authorization

4

Select Your Facebook Page

1 minuteYou’ll be asked to choose which Facebook Page to connect.
Most common mistake: Selecting multiple Facebook Pages. Select one and only one — the single page you want to use with this specific Irelia account. Selecting multiple causes erratic behavior and requires a full reset.
  1. Find your Facebook Page in the list
  2. Check the box next to one Page only
  3. Click “Next” or “Continue”
Irelia.ai Meta Messenger and Instant Forms connection guide, Step 4 — Select Your Facebook Page. The Choose the Pages you want Irelia to access screen shows Opt in to current Pages only selected, with only the Irelia.ai page checked and highlighted in red while The Smart Economist page stays unchecked. It demonstrates the required one-Page-only selection before clicking Continue.

Select exactly one Facebook Page

5

Select Your Business Manager

1 minuteNext, you’ll choose which Business Manager to connect.
Same rule applies: Select one and only one Business Manager — the one that contains the ad accounts and Instant Forms you want to use with this Irelia account.
  1. Find your Business Manager in the list
  2. Check the box next to one BM only
  3. Click “Next” or “Continue”
Irelia.ai Meta Messenger and Instant Forms connection guide, Step 5 — Select Your Business Manager. The Choose the Businesses you want Irelia to access screen shows Opt in to current Businesses only selected, with only Nextwaveai checked and highlighted in red while Nextwaveai2 stays unchecked. It shows the required one-Business-Manager-only selection before clicking Continue.

Select exactly one Business Manager

6

Confirm and Complete the Authorization

Review your selections and click “Continue” or “Done” to complete the authorization. You’ll be redirected back to Irelia.

​
🎉 Congratulations! Your Meta Connection Is Live!

Take a moment to appreciate what you just set up: ✅ Your Facebook Page is connected to Irelia for automated Messenger conversations
✅ Your Business Manager is linked for Instant Form lead capture
✅ Your AI agent is ready to handle conversations and contacts automatically What happens now: Head to Managing Your Meta Services to enable the specific services you need — Messenger, Instant Forms, or both.

​
🔄 Connecting Additional Accounts

Follow these steps if you’re connecting a second (or subsequent) Irelia account using the same Facebook profile you’ve used before.
1

Start the Connection

Go to your new Irelia account’s settings and click the “Connect Meta” button, just like before.
2

Identify the Reconnection Screen

Since you’ve connected before, Meta will show you a different screen asking if you want to reconnect with your previous settings.
Irelia.ai Meta Messenger and Instant Forms connection guide, section Connecting Additional Accounts, step Identify the Reconnection Screen. The Reconnect Paolo Scirpoli to Irelia screen offers Reconnect or Not Now, with a red arrow pointing to the Edit previous settings link instead of the Reconnect button. It shows which link to click so new assets can be added without losing the existing connection.

Meta reconnection screen — look for Edit previous settings

3

Edit Your Previous Settings

1 minuteDo not click “Reconnect” — that would reuse your old settings.Instead, click the blue “Edit previous settings” link.
Why this matters: Clicking this link lets you add new assets while keeping your previous connections intact. If you click “Reconnect” instead, you’ll reapply your old selections without adding anything new.
4

Add Your New Facebook Page

1 minuteYou’ll see your previously selected Page(s) already checked.
Important: Leave existing selections checked and add exactly one new Facebook Page.
  1. Verify your previously selected page(s) are still checked — do not uncheck them
  2. Add a checkmark to one new page for this Irelia account
  3. Do not select multiple new pages
Irelia.ai Meta Messenger and Instant Forms connection guide, step Add Your New Facebook Page. The Choose the Pages you want Irelia to access screen shows the previously connected Irelia.ai page already checked, with a red arrow pointing to the unchecked The Smart Economist page as the one new Page to add. It shows how to keep the old selection intact while adding exactly one more Page.

Keep existing Pages checked and add one new Page

5

Add Your New Business Manager

1 minuteThe same rule applies for Business Manager.
Important: Keep existing BM(s) selected and add exactly one new Business Manager.
  1. Verify your previously selected BM(s) are still checked — do not uncheck them
  2. Add a checkmark to one new BM for this Irelia account
  3. Do not select multiple new BMs
Irelia.ai Meta Messenger and Instant Forms connection guide, step Add Your New Business Manager. The Choose the Businesses you want Irelia to access screen shows the previously connected Nextwaveai business already checked, with a red arrow pointing to the unchecked Nextwaveai2 as the one new Business Manager to add. It shows how to keep the old selection intact while adding exactly one more Business Manager.

Keep existing BMs checked and add one new Business Manager

6

Confirm and Complete the Authorization

Finish the authorization process by clicking “Continue” or “Done”.
Success! Your new Irelia account is now connected to its own Facebook Page and Business Manager.

​
⚙️ Managing Your Meta Services

After a successful connection, you’ll be redirected to the “Channels Configuration” screen where you can manage your Meta services.
Irelia.ai Meta Messenger and Instant Forms connection guide, section Managing Your Meta Services. The Channels Configuration card, highlighted in red, shows Whatsapp connected to this number 393, Meta Connected with its reset icon, and both the Meta Instant Form and Meta Messenger toggles turned on and blue. It shows where to enable, disable, or reset each connected Meta service after authorization completes.

Meta Connected status with service toggles and reset icon

​
Available Controls

​
Enabling and Disabling Services

  1. To enable a service: Click the toggle so it turns blue
  2. To disable a service: Click the toggle so it turns white
Prefer manual Messenger conversations? Disable the “Meta Messenger” toggle if you want to handle Facebook conversations yourself instead of through Irelia.

​
Resetting Your Connection

If you need to start over with a completely new connection:
  1. Click the reset icon next to “Meta Connected”
  2. Confirm the reset
  3. Click the “Connect Meta” button again to set up a new connection

​
➕ Adding New Meta Services

We continuously add new Meta integration capabilities. When new services become available, you’ll see an “Add missing Meta service” button on your “Channels Configuration” screen.
Irelia.ai Meta Messenger and Instant Forms connection guide, section Adding New Meta Services. The Channels Configuration card shows Meta Connected with a red arrow pointing to the blue Add missing Meta service button, while Meta Instant Form is toggled on and the greyed-out Meta Messenger toggle is still off. It shows where the new-service button appears once Irelia adds another Meta integration to authorize.

Add missing Meta service button on Channels Configuration

  1. Click the blue “Add missing Meta service” button
  2. Follow the same Meta authorization flow
  3. Grant permissions for the new service
  4. Return to Irelia and enable the new service with its toggle

​
✅ Quick Checklist

Use this checklist for every connection:

Essential Setup

  • Navigated to “Settings” → “Channels Configuration”
  • Clicked the “Connect Meta” button
  • Logged in with Facebook (if prompted)
  • Selected ONE Facebook Page only
  • Selected ONE Business Manager only
  • Completed the authorization
  • Enabled desired services with toggles
  • Confirmed “Meta Connected” status appears
  • Tested your integration
✅ All checked? You’re good to go!

​
🛠️ Troubleshooting & FAQs

What this means: During the Meta authorization flow, the Facebook Page or Business Manager you need doesn’t show up in the selection screen — usually because your Facebook account doesn’t have the right permission level on the Business Manager.How to fix it:Step 1: Verify you’re logged into the correct Facebook account
  • The selection screen only shows assets where your logged-in Facebook account has the required permissions.
  • If you have multiple Facebook accounts, make sure you’re using the right one.
Step 2: Check your Business Manager permissions
  • How to check: Go to “Meta Business Suite” → “Settings” → “People” → Find your name → Verify your role is Admin with full control and that finance permissions are enabled.
Step 3: If you’re an agency or marketer connecting for a clientThis is by far the most common cause. Your client likely added you as a Partner on their Business Manager — which is exactly what Meta recommends for agencies — but Partner access is not enough for the Embedded Signup connection process.Ask your client to add you (temporarily or permanently) as an Admin with full control — including finance permissions — on their Business Manager.Share the instructions below directly with your client:

​
Instructions for your client

  1. Go to Meta Business Suite and click the gear icon to open “Business Settings”
  2. In the left sidebar, click “People”, then click the blue “Invite People” button
    Irelia.ai Meta Messenger and Instant Forms connection guide, Issue 1 troubleshooting, Instructions for your client step 2. The Meta Business Settings People page for the Nextwaveai business portfolio lists Kristian Di Lillo and Paolo Scirpoli, both with Full control access, with a red arrow pointing to the blue Invite people button in the top right corner. It shows the client exactly where to start inviting the agency's Facebook account with the correct permission level.

    Invite People button in Meta Business Settings

  3. Enter the email address associated with the marketer or agency’s Facebook account
  4. Select “Full control” (Admin access) and ensure finance permissions are enabled — this is critical, do not select “Partial access”
    Irelia.ai Meta Messenger and Instant Forms connection guide, Issue 1 troubleshooting, Instructions for your client step 4. The Give access to the business portfolio screen in the Invite people wizard shows red arrows on the Full control Everything Manage toggle turned on and the Advanced options Finance Manage toggle turned on, with the Finance View toggle left off. It shows exactly which toggles to enable so the agency gets full control with finance permissions instead of only partial access.

    Select Full control with finance permissions enabled

  5. Click the “Send Invitation” button

​
After your client sends the invitation

  1. Check your email and Facebook notifications for the invitation
  2. Accept the invitation
  3. Restart the Meta connection process from Step 1 of First-Time Connection
  4. Your client’s Page and Business Manager should now appear in the selection screens
Concerned about long-term permissions? You can ask your client to downgrade your access back to Partner after the Meta setup is fully complete and working. The connection will continue to function.
What this means: Multiple Pages or multiple Business Managers were selected during the connection flow — either in this account or in another Irelia account that shares the same Facebook profile.Symptoms:
  • Irelia sends Messenger replies from a Page that doesn’t belong to this account
  • The “Meta Instant Form” module displays forms from the wrong Business Manager
  • Generally unpredictable behavior across connected accounts
How to fix it:Step 1: Identify all affected accounts
  • Find every Irelia account that was connected using the same Facebook profile.
Step 2: Reset every Meta connection
  • In each affected account, go to “Settings” → “Channels Configuration” → Click the reset icon next to “Meta Connected” and confirm.
  • Wait until all connections are removed before proceeding. All the connections made from the same Facebook account must be resetted before moving to step 3.
Step 3: Reconnect each account one by one
  1. Click the reset icon next to “Meta Connected” to disconnect
  2. Click the “Connect Meta” button again
  3. Select your new Page and BM
What this means: The connection process completed successfully and “Meta Connected” appears in Irelia, but the integration isn’t functioning — services appear broken or unresponsive.This is usually caused by Irelia not being automatically registered in your Business Manager’s CRM access. It normally happens automatically during the connection process, but in some cases it doesn’t.How to fix it:Step 1: Check CRM access in Meta
  • In Meta Business Suite, go to Business Settings → Integrations and locate the Leads Access (or CRM) section
  • Look for Irelia in the list of connected platforms
Step 2: If Irelia is not listed, add it manually
  • Click the option to add or connect a new CRM platform
  • Search for and add Irelia manually
What this means: Irelia can’t manage Messenger conversations because messaging isn’t enabled on your Facebook Page itself.How to fix it:Step 1: Enable messaging on your Facebook Page
  • Go to your Facebook Page “Settings” → “Messaging” and make sure messaging is turned on.
Step 2: Return to Irelia and try the toggle again
  • Go to “Settings” → “Channels Configuration” and enable the “Meta Messenger” toggle.
What this means: Irelia isn’t receiving lead data from your Meta ad campaign forms.How to fix it:Step 1: Verify the form is attached to an active campaign
  • Open Meta Ads Manager and confirm the campaign using your Instant Form is active and running.
Step 2: Check your Business Manager connection
  • Make sure the BM you connected to Irelia contains the ad account running the campaign.
Step 3: Verify the toggle is enabled
  • Go to “Settings” → “Channels Configuration” and make sure the “Meta Instant Form” toggle is enabled (blue).
What this means: Irelia is receiving lead data from your forms but can’t send WhatsApp messages to the captured leads.How to fix it:Step 1: Check phone number format
  • Leads may be entering their phone number without the correct country code or with an incorrect format.
  • If possible, set a default country prefix in your Meta form based on the country where you’re advertising.
Step 2: Verify your form includes a phone number field
  • Your Instant Form might not include a phone number field, so Irelia can’t contact leads.
  • Edit your form in Meta Ads Manager and add a phone number field.
Step 3: Use Meta’s standard fields
  • Irelia pulls data from Meta’s default fields (name and phone number). If you’re using custom fields, Irelia won’t recognize them.
  • Use Meta’s standard “Name” and “Phone Number” fields in your Instant Form. Irelia uses the name for personalization and the phone number to send messages.

🆘 Need Help?

Irelia.ai Support:
  • Contact support in the WhatsApp priority support group or send an email to info@irelia.ai
  • Include: screenshots of your configuration, the error message, and what you expected vs. what happened
Meta Support: