Meta (Facebook) Integration
अपने Facebook Page के माध्यम से अपने agent को Facebook Messenger से connect करें।
अवलोकन
Meta integration प्रदान करती है:
- आपके Page के माध्यम से Facebook Messenger conversations
- Typing indicators के साथ background processing
- लंबे responses के लिए automatic message splitting
- 24-hour messaging window compliance
- Sessions के भीतर conversation memory
पूर्व-आवश्यकताएं
- एक Facebook Page जिसे आप manage करते हैं
- Page पर Admin या Editor role
- Active agent के साथ Cuneiform Chat account
Setup Steps
1. Integration Setup शुरू करें
- Agents में जाएं → अपना agent चुनें
- Integrations tab पर जाएं
- Meta (Facebook) पर क्लिक करें
- Connect Page पर क्लिक करें
2. Facebook से Authorize करें
- चुनें कि कौन सा Agent respond करे
- Connect with Facebook पर क्लिक करें
- Facebook में log in करें (अगर जरूरी हो)
- जो Page connect करना चाहते हैं उसे चुनें
- Messenger permissions grant करें
- आपको success message के साथ redirect किया जाएगा
3. Connection Verify करें
Connect होने के बाद, आपका Page integrations list में दिखेगा:
- Page name और status
- Page ID
- Last activity timestamp
यह कैसे काम करता है
जब users Messenger के माध्यम से आपके Facebook Page पर message करते हैं:
- Message Facebook Messenger के माध्यम से आता है
- Bot processing करते समय typing indicator दिखाता है
- आपका agent question process करता है
- Response Messenger के माध्यम से वापस भेजा जाता है
Messages background में process होते हैं। Bot typing indicator दिखाता है जबकि आपका agent response generate कर रहा होता है।
Features
Automatic Responses
आपका agent आपके content के आधार पर incoming Messenger conversations का automatically respond करता है। सभी text messages response trigger करते हैं — कोई commands या prefixes जरूरी नहीं।
Typing Indicators
जब आपका agent message process कर रहा होता है, users Messenger में typing indicator (”…”) देखते हैं, जो natural conversation feel प्रदान करता है।
Message Splitting
2,000 characters से लंबे responses automatically कई messages में split हो जाते हैं, readability के लिए paragraph breaks और sentence boundaries preserve करते हैं।
Conversation Memory
Bot एक session के भीतर context याद रखता है, इसलिए users बिना खुद को दोहराए follow-up questions पूछ सकते हैं।
Message Queuing
अगर bot अभी process कर रहा है तो user additional messages भेजता है, तो वे queued हो जाते हैं और अगले response में शामिल होते हैं।
24-Hour Messaging Window
Facebook की policy last user message के 24 घंटों के भीतर responses allow करती है। आपका agent real-time में, इस window के भीतर respond करता है। 24 घंटे की inactivity के बाद, user को conversation restart करने के लिए नया message भेजना होगा।
Users को पहले आपके Page पर message करना होगा — आप unsolicited messages नहीं भेज सकते। अगर उनके last message के बाद 24 घंटे से अधिक बीत जाते हैं, तो bot तब तक reply नहीं कर सकता जब तक user दोबारा message न करे।
Pages Manage करना
Connected Pages देखें
प्रत्येक connected Page दिखाता है:
- Page name और connection status
- Associated agent
- Activity information
उपलब्ध Actions
| Action | विवरण |
|---|---|
| Test Connection | Integration काम कर रहा है verify करें |
| Disconnect | Page connection हटाएं |
प्रत्येक connected Page पर three-dot menu के माध्यम से access करें।
Troubleshooting
Page नहीं दिख रहा
- Verify करें कि Page पर आपका Admin या Editor role है
- Check करें कि आपने सभी requested permissions grant किए हैं
- Disconnect और reconnect करने की कोशिश करें
Messages को Responses नहीं मिल रहे
- Integration verify करने के लिए “Test Connection” का उपयोग करें
- Check करें कि आपका agent configured और working है (Playground में test करें)
- Ensure करें कि Messenger permissions granted हैं
- Verify करें कि user ने last 24 घंटों में message किया है (messaging window policy)
Authorization Errors
- Facebook login session clear करें और दोबारा try करें
- Verify करें कि आपके Facebook account में Page access है
- Check करें कि Page Facebook द्वारा restricted तो नहीं है
Security
- OAuth tokens encrypted और सुरक्षित रूप से stored हैं
- Webhook signatures हर incoming request पर HMAC-SHA256 का उपयोग करके verified हैं
- Messenger conversations से परे Page content का कोई access नहीं
- Facebook Platform policies के अनुरूप
Disconnect करना
Meta integration हटाने के लिए:
- Agents में जाएं → Agent चुनें → Integrations
- अपने Page पर three-dot menu पर क्लिक करें
- Disconnect चुनें
Access पूरी तरह revoke करने के लिए:
- Facebook Settings → Business Integrations पर जाएं
- Cuneiform Chat app हटाएं
महत्वपूर्ण Notes
- प्रति Page एक agent: प्रत्येक Facebook Page एक समय में केवल एक AI agent से connect हो सकता है
- केवल Messenger: यह integration Facebook Messenger के माध्यम से काम करती है, Page comments या posts से नहीं
- Message limit: Individual messages 2,000 characters तक limited हैं; लंबे responses automatically split होते हैं
- Agent बदलने के लिए: पहले existing integration disconnect करें, फिर अलग agent के साथ reconnect करें