---
title: "Meta connection troubleshooting"
description: "Solve common problems when connecting Instagram, Facebook Messenger, or WhatsApp to Interlinked AI — fix authorization errors, permission issues, expired tokens, and Meta account configuration problems."
section: "Channels and integrations"
url: https://interlinked-ai.com/en/resources/docs/meta-connection-troubleshooting
lang: en
lastUpdated: 2026-04-28
---

# Meta connection troubleshooting

## Before you start troubleshooting

Most connection issues fall into a few categories:

1. **Account type or permissions** — Your Meta account, Page, or Instagram account is not configured correctly.
2. **Authorization flow** — Something went wrong during the Meta OAuth or Embedded Signup process.
3. **Token expiration** — A previously working connection has stopped functioning.
4. **Meta platform restrictions** — Your account has limitations imposed by Meta.

Before diving into specific issues, try these general steps:

- **Clear your browser cache** and try connecting in a fresh browser tab or incognito window.
- **Check that you are logged into the correct Meta account** — the one with admin access to the Page, Instagram account, or WhatsApp Business Portfolio you want to connect.
- **Disable browser extensions** that might block popups or redirects (ad blockers, privacy extensions).

## Common issues across all channels

### "Authorization was cancelled" or blank redirect

**Symptoms:** After clicking Connect, the Meta authorization window opens but you are redirected back to Interlinked without a successful connection. The channel still shows "Not connected."

**Causes and solutions:**

- **You clicked Cancel or closed the window** — Meta's OAuth flow requires you to complete all steps and click Allow. If you cancel at any point, the authorization fails. Try again and complete the entire flow.
- **Popup blocker interfered** — Some browser settings or extensions block the OAuth popup or redirect. Disable popup blockers for the Interlinked domain and try again.
- **Multiple Meta accounts** — If you are logged into multiple Meta accounts in your browser, the OAuth flow may use the wrong one. Log out of all Meta accounts, log into the correct one, then retry.

### Connection was working but stopped

**Symptoms:** The channel was previously connected and functioning, but the AI agent has stopped receiving or sending messages. The channel may show "Reconnection needed" in AI Config.

**Causes and solutions:**

- **Token expired** — Meta OAuth tokens have a limited lifetime. Go to AI Config → Channels and click **Reconnect** to re-authorize.
- **Permissions were revoked** — If someone removed Interlinked from Facebook Business Integrations, Page settings, or Meta Business Suite, the connection breaks. Reconnect to restore permissions.
- **Page role changed** — If the admin who authorized the connection had their Page role changed or removed, the token may become invalid. Have a current admin reconnect.
- **Meta account suspended or restricted** — Check your Meta account status. If Meta has restricted your account, connections may be affected until the restriction is lifted.

<div class="docs-callout docs-callout-tip">
  <p><strong>Tip</strong></p>
  <p>When reconnecting a channel, you go through the same authorization flow as the initial connection. Your existing conversation history in the CRM is preserved — reconnecting does not create duplicate conversations.</p>
</div>

### "Insufficient permissions" error

**Symptoms:** During authorization, Meta shows an error about insufficient permissions, or the connection completes but the AI agent cannot send/receive messages.

**Causes and solutions:**

- **Not an admin on the Page** — You must have admin access to the Facebook Page (for Messenger and Instagram) or the Meta Business Portfolio (for WhatsApp). Ask a current admin to grant you admin permissions, or have them perform the connection.
- **Page permissions were restricted** — Some Pages have their messaging permissions restricted by Meta (e.g., after policy violations). Check your Page status in Meta Business Suite.

## Instagram-specific issues

### "Account is not a Professional account"

**Symptoms:** Instagram does not appear as an option during authorization, or the connection fails with a message about account type.

**Solution:** Your Instagram account must be set to Business or Creator — Personal accounts cannot use the messaging API.

To switch:
1. Open the Instagram app
2. Go to Settings → Account
3. Select **Switch to Professional account**
4. Choose Business or Creator
5. Complete the setup steps
6. Return to Interlinked and try connecting again

### "No Instagram account found for this Page"

**Symptoms:** During Meta authorization, you can select a Facebook Page but no Instagram account appears.

**Solution:** Your Instagram Professional account must be linked to the Facebook Page you selected.

To link them:
1. Go to your Facebook Page Settings
2. Select **Instagram** in the left menu
3. Click **Connect Account** and log in to your Instagram account
4. Return to Interlinked and try connecting again

### Instagram stories and reels interactions not appearing

**Symptoms:** The AI agent responds to Direct messages but does not seem to receive Story replies or other interaction types.

**Explanation:** The Instagram messaging API processes Direct messages. Story replies that generate a Direct message conversation are handled normally. However, not all interaction types (likes, comments, mentions) create Direct message conversations. The AI agent handles all messages that arrive as Direct conversations.

## Facebook Messenger-specific issues

### "Messaging is not enabled on this Page"

**Symptoms:** The connection completes but the AI agent does not receive Messenger conversations.

**Solution:** Enable messaging on your Facebook Page:
1. Go to your Facebook Page
2. Open **Settings** → **General**
3. Find **Messages** and enable "Allow people to contact my Page privately"
4. Save changes

### Customers receive both AI responses and Page auto-responses

**Symptoms:** Customers receive duplicate or conflicting messages — one from the AI agent and one from your Page's built-in auto-responses.

**Solution:** Disable your Facebook Page's built-in auto-responses:
1. Go to your Facebook Page → **Inbox** → **Automations** (or **Automated Responses**)
2. Turn off any instant replies, away messages, or custom auto-responses
3. The AI agent through Interlinked will handle all messaging going forward

## WhatsApp-specific issues

### "Phone number is already registered"

**Symptoms:** During Embedded Signup, Meta shows an error that the phone number is already registered on WhatsApp or WhatsApp Business App.

**Solution:** A phone number can only be active on one WhatsApp platform at a time. If the number is currently registered on the WhatsApp Business App:
1. The Embedded Signup flow should offer a migration option — follow the on-screen instructions.
2. If migration is not offered, unregister the number from the WhatsApp Business App first (WhatsApp Business App → Settings → Account → Delete Account), then retry the Embedded Signup.

<div class="docs-callout docs-callout-warning">
  <p><strong>Important</strong></p>
  <p>Migrating a number from the WhatsApp Business App to the WhatsApp Business Platform (API) means messages will no longer appear in the phone app. All conversations will be handled through Interlinked's CRM instead.</p>
</div>

### Verification code not received

**Symptoms:** During Embedded Signup, the SMS or voice call verification code does not arrive.

**Solutions:**
- Wait at least 60 seconds before requesting a new code.
- Try the **alternative method** — if SMS is not working, request a voice call, or vice versa.
- Ensure the phone number can receive SMS or calls from international numbers (some carriers block these).
- Check that the number is not a landline without SMS capability (use the voice call option instead).

### "Payment method required"

**Symptoms:** Embedded Signup cannot be completed because a payment method is missing.

**Solution:** Meta requires a valid payment method for all WhatsApp Business Platform accounts because conversation charges are billed directly by Meta. Add a credit card or PayPal during the Embedded Signup flow. This is separate from your Interlinked subscription.

### Low messaging limit or quality rating

**Symptoms:** You can send messages to a limited number of customers, or Meta has flagged your quality rating.

**Explanation:** WhatsApp assigns a messaging limit tier based on your account's quality rating. New accounts start at 250 unique customers per 24 hours. To increase your limit:
- Send relevant, high-quality messages
- Avoid sending messages to customers who have not opted in
- Respond to customer complaints promptly
- Maintain a low block/report rate

See [Connect WhatsApp Business](/en/resources/docs/connect-whatsapp-business) for the full messaging limit tier breakdown.

## Security reminders

<div class="docs-callout docs-callout-warning">
  <p><strong>Important</strong></p>
  <p>Interlinked will <strong>never</strong> ask for your Meta password, Facebook login credentials, or WhatsApp verification codes through email, chat, or support tickets. All connections happen exclusively through Meta's official authorization screens. If someone claiming to represent Interlinked asks for your credentials, do not share them.</p>
</div>

## When to contact support

If you have tried the solutions above and your channel still cannot connect:

1. **Note the exact error message** or behavior you are experiencing.
2. **Check the Meta Business Help Center** for any platform-wide issues or restrictions on your account.
3. **Contact Interlinked support** with your workspace details and a description of the problem. Include screenshots of any error messages if possible.
