WhatsApp Integration
Customer communication के लिए अपने agent को WhatsApp Business से connect करें।
अवलोकन
WhatsApp integration प्रदान करती है:
- Business messaging capabilities
- Rich media support
- Automated responses
- Global reach
- 24-hour messaging window compliance
पूर्व-आवश्यकताएं
- एक active AI agent (Agents section में बनाया गया)
- एक WhatsApp Business Account (WABA)
- WhatsApp Business में एक verified phone number
- Meta Developer Portal का access
Setup Steps
1. Embedded Signup से Connect करें (Recommended)
WhatsApp connect करने का सबसे आसान तरीका embedded Meta signup flow है:
- Agents में जाएं → अपना agent चुनें
- Integrations tab पर जाएं
- WhatsApp पर क्लिक करें
- Meta signup popup खोलने के लिए Connect with Facebook पर क्लिक करें
- अपने Facebook/Meta account से log in करें
- WhatsApp Business Account चुनें या बनाएं
- Connect करने के लिए phone number चुनें
- Popup बंद होता है और आपका connection establish हो जाता है
Embedded signup flow ज़्यादातर configuration automatically handle करता है। यह अधिकांश users के लिए recommended method है।
2. Phone Verification (अगर जरूरी हो)
Meta signup पूरा करने के बाद, आपको अपना phone number verify करना पड़ सकता है:
- अपना verification code प्राप्त करने का तरीका चुनें: SMS या Voice Call
- Send Code पर क्लिक करें
- मिला 6-digit code दर्ज करें
- Verify पर क्लिक करें
अगर code नहीं मिला, retry के लिए “Didn’t receive the code? Send again” पर क्लिक करें।
3. Two-Step Verification (अगर Enable हो)
अगर आपके WhatsApp Business account में Two-Step Verification enabled है:
- Prompt होने पर अपना 6-digit PIN दर्ज करें
- Complete Registration पर क्लिक करें
यह PIN WhatsApp Business Manager → Security Center में set किया गया था। यह SMS verification code से अलग है।
4. Webhook Configure करें (अगर जरूरी हो)
Setup के बाद, आपको Meta Business Suite में अपना webhook configure करना पड़ सकता है:
- Connection के बाद provide किया गया webhook URL copy करें
- Meta Developer Portal में, WhatsApp → Configuration पर जाएं
- Webhook URL add करें
messageswebhook field को subscribe करें
Bot का उपयोग करना
Customer Messages
जब customers आपके WhatsApp number पर message करते हैं:
- Message WhatsApp के माध्यम से आता है
- Cuneiform Chat request process करता है
- Agent content से response generate करता है
- Response customer को वापस भेजा जाता है
Conversation Flow
Customer → WhatsApp → Cuneiform Chat → Agent → Response → CustomerFeatures
24-Hour Messaging Window
WhatsApp Business API rules:
- आप customer-initiated messages का 24 घंटे तक respond कर सकते हैं
- 24 घंटे के बाद, window बंद हो जाती है जब तक customer दोबारा message न करे
- हर नया customer message window दोबारा खोलता है
आपका agent automatically 24-hour window के भीतर respond करता है। Re-engagement के लिए template messages currently supported नहीं हैं।
Rich Media
Responses में शामिल हो सकते हैं:
- Text messages
- Links
- Formatted text
Multi-Language
आपका agent automatically customer की language detect करता है और उसी में respond करता है — 176 languages supported, कोई configuration जरूरी नहीं।
Connected Numbers Manage करना
प्रत्येक connected WhatsApp number दिखाता है:
- Business name या display phone number
- Status badge - Active, Inactive, या Error
- Phone number
- Last activity timestamp
उपलब्ध Actions
| Action | विवरण |
|---|---|
| Test Connection | Verify करता है कि integration काम कर रहा है |
| Disconnect | यह integration हटाता है |
Integration card पर three-dot menu के माध्यम से इन्हें access करें।
Troubleshooting
Connection Failed
- Ensure करें कि आपके पास valid WhatsApp Business Account है
- Check करें कि आपका phone number verified है
- Embedded signup flow दोबारा try करें
Phone Verification काम नहीं कर रहा
- Ensure करें कि SMS/Voice के लिए phone number का access है
- नया code request करने से पहले कुछ मिनट wait करें
- Check करें कि phone number कहीं और connected तो नहीं है
Two-Step Verification Error
- WhatsApp Business Manager → Security Center में set किया PIN दर्ज करें
- यह SMS verification code से अलग है
- अगर PIN नहीं पता, तो अपने WhatsApp Business admin से contact करें
Messages नहीं आ रहे
- Verify करें कि Meta Business Suite में webhook सही तरह configured है
- Check करें कि webhook subscription में
messagesशामिल है - Confirm करें कि integration status “Active” है
Response Failures
- Check करें कि Playground में agent काम करता है
- Verify करें कि 24-hour window active है (customer ने recently message किया हो)
- Admin panel में integration status check करें
Security
- Access tokens encrypted और सुरक्षित रूप से stored हैं
- Messages secure connections पर process होते हैं
Compliance
WhatsApp Business की usage policies हैं:
- केवल customer-initiated conversations का respond करें
- Opt-out options provide करें
- Meta की Commerce और Business policies follow करें
Disconnect करना
WhatsApp integration हटाने के लिए:
- Agents में जाएं → Agent चुनें → Integrations
- अपने WhatsApp integration पर three-dot menu पर क्लिक करें
- Disconnect चुनें
यह agent को respond करने से रोकता है। पूरी तरह हटाने के लिए:
- Meta Developer Portal में webhook delete करें
- Optionally अपने Meta app से WhatsApp product हटाएं
सामान्य सवाल
Q: WhatsApp कैसे connect करूं? A: Integrations tab में “WhatsApp” पर क्लिक करके, फिर “Connect with Facebook” पर क्लिक करके embedded signup का उपयोग करें। यह automatically Meta signup process के माध्यम से guide करता है।
Q: Verification code क्यों मांगा जाता है? A: WhatsApp नए connections के लिए phone verification require करता है। SMS या Voice Call चुनें 6-digit code प्राप्त करने के लिए, फिर setup complete करने के लिए दर्ज करें।
Q: Two-Step Verification PIN क्या है? A: अगर आपने WhatsApp Business Manager में Two-Step Verification enable किया है, तो setup के दौरान वह 6-digit PIN दर्ज करना होगा। यह SMS verification code से अलग है।
Q: क्या मैं कई WhatsApp numbers connect कर सकता हूं? A: हाँ, आप कई WhatsApp Business numbers connect कर सकते हैं। प्रत्येक number को एक अलग (या same) AI agent से connect किया जा सकता है।