Facebook Messenger Integration

Connect your Facebook Page to your AI agent for auto-replies to messages and comments

Facebook Messenger Integration#

Connect your Facebook Page to AlonChat to automatically respond to messages and comments 24/7. Your AI agent will handle customer inquiries, collect leads, and seamlessly hand off to human agents when needed.

Prerequisites#

Before you begin:

Facebook Page (not personal profile)
Page admin access
Trained AlonChat agent
Facebook Business Account (recommended)

Note: Personal profiles cannot be connected -- only Facebook Pages.

Step-by-Step Setup#

Step 1: Navigate to Deploy#

Log in to AlonChat
Select your agent
Go to Deploy > Facebook Messenger
Click Connect Facebook Page

Step 2: Log in to Facebook#

You'll see an OAuth popup to authorize the connection.

Required permissions:

pages_messaging -- Send and receive messages
pages_read_engagement -- Read comments and interactions
pages_manage_metadata -- Update page settings

Click Continue to grant permissions.

Step 3: Select Facebook Page#

Choose which Facebook Page to connect:

If you manage multiple pages, select the one you want
Connect different pages to different agents, or multiple pages to the same agent
If a page is already connected to another agent, you'll see a conflict dialog with a transfer option
Click Add More to connect additional pages

Click Connect Page.

Step 4: Configure Settings#

On the Facebook deploy page, configure:

Greeting Text: First message visitors see
Get Started Button: Custom welcome message/payload
Ice Breakers: Up to 4 conversation starters
Quick Replies: Up to 13 quick reply buttons
Persistent Menu: Up to 3 custom menu items (postback or web URL links)
Auto-Suggest Quick Replies: AI-generated contextual reply suggestions
Custom AI Prompt: Override or append to default prompt for Messenger
Learned Style: Use communication patterns from training
Auto-Reply Toggle: Enable/disable per connected page

Step 5: Test the Integration#

Send a message to your Facebook Page from a test account
Verify agent responds automatically
Test handoff phrase: "I want to speak to a human"
Check that conversation appears in AlonChat dashboard

How It Works#

Message Flow#

Code

User sends message to Facebook Page
          |
Facebook sends message to AlonChat via webhook
          |
AlonChat agent processes message (RAG retrieval)
          |
Agent generates response using AI model
          |
AlonChat sends response back to Facebook
          |
User receives response in Messenger

Average response time: usually just a few seconds

Conversation Syncing#

AlonChat syncs all Facebook Messenger conversations:

Real-time message sync (both directions)
Conversation history preserved
User profile information (name, profile picture)
Message read receipts
Typing indicators

View conversations: Go to Activity > Messages in AlonChat to see all your Facebook chats.

Features#

Auto-Response#

Agent automatically responds to:

Direct messages to your page
First-time messages
Follow-up questions
Messages during off-hours

Does NOT auto-respond to:

Messages you already replied to (unless new question asked)
Spam or abusive messages
Messages from blocked users

Comment Auto-Reply#

Your agent can reply to comments on your Facebook Page posts. Comment replies are rule-driven and route through Human Review, so you stay in control of what goes live.

Configure on the Comments sub-page: Deploy > Facebook Messenger > Comments. Settings are per connected page.

Mode#

Mode	Description
Off	No comment replies
Draft	Agent drafts a reply for you to approve before it posts
Auto	Agent sends the reply without approval when a detection matches

Detections#

Choose which comment signals can trigger a reply:

Detection	Description
Questions	Comments that look like a product or service question
Mentions	Comments that explicitly tag or mention your brand

Saving these settings creates connection-scoped Human Review rules. Public replies follow the public comment surface policy (the agent invites the commenter to DM for anything that needs private details).

Example flow:

Code

Customer comments: "What time do you open on Saturdays?"
          |
AlonChat detects a question comment
          |
Agent drafts a reply using your sources (routed through Human Review)
          |
You approve, and the reply posts: "We're open 9 AM to 5 PM on Saturdays!"

Handoff to Human Agents#

When a user requests human assistance:

Trigger phrase detected (e.g., "speak to human")
Agent responds: "Let me connect you with our team. They'll be with you shortly."
Notification sent to your team (email, Slack, etc.)
Auto-reply paused for that conversation
Human takes over in AlonChat dashboard or Facebook Page Inbox

Resume AI:

Click "Resume AI Agent" in conversation view
Agent will continue responding automatically

Lead Collection#

Agent can collect lead information during conversations:

Example conversation:

Code

User: Do you offer custom t-shirt printing?
Agent: Yes! We offer custom printing with full-color designs.
      Would you like to receive our pricing guide?

User: Yes please

Agent: Great! May I have your email address?

User: john@example.com

Agent: Thank you! I'll send the pricing guide to john@example.com.
      What's your name?

User: John Doe

Agent: Thanks John! Would you like to provide your phone number
      so we can discuss your project?

User: +639171234567

Agent: Perfect! We'll reach out to you shortly.

Lead captured:

Name: John Doe
Email: john@example.com
Phone: +639171234567
Source: Facebook Messenger
Timestamp: 2026-03-22 10:30 AM

Webhooks triggered:

leads.submit event fires automatically
Can integrate with external CRM tools, Google Sheets, and more

Quick Replies#

Quick replies appear as tappable buttons below agent messages, guiding customers through common conversation paths.

Configure up to 13 quick reply buttons per page
Agent can also auto-suggest contextual quick replies based on the conversation
Users can tap buttons or type their response

Message Formatting#

Agent supports rich message formatting:

Text formatting:

Bold, italic, strikethrough (Markdown syntax)
Emojis
Line breaks and paragraphs

Media:

Images (sent as attachments)
Files (PDFs, documents)
Links (auto-preview in Messenger)

Best Practices#

1. Set Clear Expectations#

Add to your agent's system prompt:

Code

You are an AI assistant for [Company Name].
Let users know you're an AI at the start of conversations:
"Hi! I'm [Company]'s AI assistant. How can I help you today?"

2. Configure Handoff Triggers#

Add these phrases to trigger human handoff:

"speak to a human"
"talk to a person"
"real person"
"customer service"
"manager"
"complaint"

3. Set Appropriate Response Time#

For customer support:

Use 2-5 second delay (natural conversation feel)
Show typing indicator
Don't respond too fast (feels robotic)

For sales/marketing:

Can use instant responses (0s delay)
Emphasize speed and availability

4. Use Business Hours Wisely#

24/7 business:

Set "Always Reply" mode
Let AI handle all initial inquiries
Have human review in morning

Office hours business:

Set "Only When Offline" mode
Business hours: 9am-5pm Mon-Fri
AI covers nights, weekends

5. Monitor Conversations#

Check AlonChat dashboard daily:

Review AI responses for accuracy
Look for patterns in unanswered questions
Add missing information to your sources
Manually respond to complex queries

6. Train Your Agent#

Add Facebook-specific content in Sources:

Common questions asked via Messenger
Typical follow-up questions
Messenger-specific FAQs
Tone appropriate for social media

Troubleshooting#

Agent Not Responding#

Check these:

Integration status:
- Go to Deploy > Facebook Messenger
- Ensure Facebook is "Connected" (green)
- If not, click "Reconnect"
Agent is trained:
- Go to Sources
- Ensure agent has been trained recently
- Re-train if you added new sources
Response mode:
- Check Facebook deploy settings
- Ensure "Auto-Reply" is toggled on for the page
- If "Only When Offline", check business hours
Facebook permissions:
- Go to Facebook Page > Settings > Advanced Messaging
- Ensure "Connected Apps" shows AlonChat
- Re-authorize if missing
Webhook health:
- Check the health indicator on the deploy page
- Should show healthy status
- If degraded, try disconnecting and reconnecting

Delayed Responses#

Possible causes:

AI model is slow:
- Go to Settings > AI
- Switch to a faster budget model (1 credit)
Large source library:
- Retrieval may be slow with 100+ sources
- Optimize by removing duplicate content
High traffic:
- During peak hours, responses may slow
- Upgrade to higher-tier plan for better performance

Duplicate Responses#

Symptoms: Agent sends the same message twice

Causes:

Facebook sends webhook twice (rare bug)
Integration was connected multiple times

Fix:

Disconnect Facebook integration
Wait 5 minutes
Reconnect Facebook page
Test with fresh message

Agent Says "I don't know"#

Causes:

Your sources are missing relevant information
Question phrasing doesn't match sources

Fix:

Add missing information in Sources:
- Upload documents
- Create Q&A pairs
- Add text sources
Re-train agent
Test with exact phrases used by customers

Handoff Not Working#

Symptoms: Handoff phrase doesn't trigger human takeover

Fix:

Review handoff trigger settings
Add the exact phrase used by customer
Case-insensitive, so "Human" = "human"

Default triggers:

speak to a human
talk to a person
real person
customer service
manager

Comment Auto-Reply Not Working#

Check these:

Reply mode is set:
- Go to Deploy > Facebook Messenger > Comments
- Ensure Mode is set to "Draft" or "Auto" (not "Off")
A detection matches the comment:
- Make sure the relevant detection (Questions or Mentions) is selected
- A comment only triggers a reply when it matches a selected detection
Drafts are waiting for approval:
- In Draft mode, replies wait in Human Review and Activity until you approve them
Page permissions:
- Ensure pages_read_engagement permission is granted
- Re-authorize if needed

Disconnecting Facebook Page#

To disconnect a Facebook Page:

Go to Deploy > Facebook Messenger
Find the connected page
Click the disconnect option
Confirm disconnection

What happens:

Agent stops auto-responding
Webhook is removed from Facebook
Existing conversations are preserved
Can reconnect anytime

Manual Replies & the 24-Hour Window#

Meta enforces a 24-hour messaging window on Facebook Messenger: you can only send a message to a customer within 24 hours of their last message to your page.

When you open a Facebook conversation in AlonChat to reply manually:

If the window is open, the reply box works normally.
If the window is closed, AlonChat shows an inline warning explaining the window is expired and suggests replying from Facebook's native inbox (where you can send approved template messages).

This keeps your page compliant with Facebook's rules and avoids silently failed sends.

Limitations#

One agent per page: Each Facebook Page can only connect to one agent at a time
Message limits: Facebook enforces its own per-page messaging rate limits
No group chats: Agent only responds to 1-on-1 conversations
24-hour messaging window: Follow-ups outside this window may require template messages in Facebook's native inbox

Privacy and Compliance#

Data Collection#

AlonChat collects:

Message content (encrypted at rest)
User profile information (name, profile picture)
Conversation timestamps
Message read status

AlonChat does NOT collect:

Facebook account passwords
Private messages to other pages
User's friend list
User's posts or photos

AlonChat is GDPR-compliant:

User data is encrypted
Data is stored in secure servers
Users can request data deletion
Data is not sold to third parties

Data Retention#

Active conversations: Retained indefinitely
Archived conversations: 90 days (configurable)
User deletion: All data deleted within 30 days

Next Steps#

Instagram Integration -- Connect Instagram DMs and comments
Telegram Integration -- Connect Telegram
Webhook Examples -- Integrate with external systems

Facebook Messenger Integration

Facebook Messenger Integration#

Prerequisites#

Step-by-Step Setup#

Step 1: Navigate to Deploy#

Step 2: Log in to Facebook#

Step 3: Select Facebook Page#

Step 4: Configure Settings#

Step 5: Test the Integration#

How It Works#

Message Flow#

Conversation Syncing#

Features#

Auto-Response#

Comment Auto-Reply#

Mode#

Detections#

Handoff to Human Agents#

Lead Collection#

Quick Replies#

Message Formatting#

Best Practices#

1. Set Clear Expectations#

2. Configure Handoff Triggers#

3. Set Appropriate Response Time#

4. Use Business Hours Wisely#

5. Monitor Conversations#

6. Train Your Agent#

Troubleshooting#

Agent Not Responding#

Delayed Responses#

Duplicate Responses#

Agent Says "I don't know"#

Handoff Not Working#

Comment Auto-Reply Not Working#

Disconnecting Facebook Page#

Manual Replies & the 24-Hour Window#

Limitations#

Privacy and Compliance#

Data Collection#

GDPR Compliance#

Data Retention#

Next Steps#