Meta (Facebook) Integration
Connect your agent to Facebook Messenger through your Facebook Page.
Overview
Meta integration provides:
- Facebook Messenger conversations
- Page-based messaging
- Automatic responses to customer inquiries
- Rich message formatting
Prerequisites
- A Facebook Page you manage
- Admin or Editor role on the Page
- Cuneiform Chat account with an active agent
Setup Steps
1. Start Integration Setup
- Go to Agents → Select your agent
- Navigate to Integrations tab
- Click Meta (Facebook)
- Click Connect Page
2. Authorize with Facebook
- Select which Agent should respond
- Click Connect with Facebook
- Log in to Facebook (if needed)
- Select the Page you want to connect
- Grant Messenger permissions
- You'll be redirected back with a success message
3. Verify Connection
Once connected, your Page will appear in the integrations list showing:
- Page name and status
- Page ID
- Last activity timestamp
How It Works
When users message your Facebook Page through Messenger:
- Message arrives via Facebook Messenger
- Cuneiform Chat receives the message
- Your agent processes the question
- Response is sent back through Messenger
Features
Automatic Responses
Your agent automatically responds to incoming Messenger conversations based on your knowledge base.
Rich Formatting
Responses support:
- Text messages
- Links
- Basic formatting
24-Hour Messaging Window
Facebook's policy allows responses within 24 hours of the last user message. Your agent responds in real-time, well within this window.
Facebook requires user consent before businesses can message them. Users must initiate conversations first.
Managing Pages
View Connected Pages
Each connected Page displays:
- Page name and connection status
- Associated agent
- Activity information
Available Actions
| Action | Description |
|---|---|
| Test Connection | Verify the integration is working |
| Disconnect | Remove the Page connection |
Access these via the three-dot menu on each connected Page.
Troubleshooting
Page Not Appearing
- Verify you have Admin or Editor role on the Page
- Check you granted all requested permissions
- Try disconnecting and reconnecting
Messages Not Receiving Responses
- Use "Test Connection" to verify the integration
- Check your agent is configured and working (test in Playground)
- Ensure Messenger permissions are granted
Authorization Errors
- Clear Facebook login session and try again
- Verify your Facebook account has Page access
- Check Page isn't restricted by Facebook
Security
- OAuth tokens are encrypted and stored securely
- No access to Page content beyond Messenger conversations
- Compliant with Facebook Platform policies
Disconnecting
To remove the Meta integration:
- Go to Agents → Select agent → Integrations
- Click the three-dot menu on your Page
- Select Disconnect
To fully revoke access:
- Go to Facebook Settings → Business Integrations
- Remove the Cuneiform Chat app