companion के माध्यम से WhatsApp कैप्चर
अपने द्वारा होस्ट किए गए एक companion ब्रिज का उपयोग करके, प्रतिनिधि के WhatsApp Business की हर बातचीत को सीधे Conversations टाइमलाइन में कैप्चर करें। वैकल्पिक, डिफ़ॉल्ट रूप से बंद, और इसके लिए सेवा की शर्तों की सूचना स्वीकार करना आवश्यक है।
यह कनेक्टर प्रतिनिधि के WhatsApp Business संदेशों को Conversations टाइमलाइन में लाता है, जिसे आपके संगठन द्वारा होस्ट किए गए एक companion ब्रिज द्वारा कैप्चर किया जाता है। संदेश आपकी अन्य बातचीत के समान स्थान पर आते हैं, इसलिए AI सारांश, अंतर्दृष्टि और फ़ॉलो-अप मॉनिटरिंग पहले से ही उन पर काम करते हैं।
शुरू करने से पहले: सेवा की शर्तों की सूचना
यह कैसे काम करता है
- आप अपने पर्यावरण में एक companion ब्रिज (एक ओपन-सोर्स WhatsApp Web सेवा) चलाते हैं।
- companion WhatsApp Business को QR कोड द्वारा जोड़ता है और आने वाले तथा जाने वाले संदेशों को सुनता है।
- हर संदेश के लिए, companion आपके संगठन के इंजेशन URL पर एक हस्ताक्षरित POST भेजता है।
- संदेश संग्रहीत किया जाता है, फ़ोन नंबर द्वारा संपर्क या लीड से जोड़ा जाता है (या जब नंबर अज्ञात हो तो एक नई लीड बनाता है), और Conversations टाइमलाइन में दिखाई देता है।
कैसे कनेक्ट करें
- सेटिंग्स, इंटीग्रेशन पर जाएँ और "WhatsApp: companion के माध्यम से कैप्चर" कार्ड खोलें।
- एक मज़बूत पेयरिंग सीक्रेट सेट करें और सहमति बॉक्स चेक करें (मैं सेवा की शर्तों के जोखिम को समझता हूँ)। सहेजें पर क्लिक करें।
- दिखाया गया इंजेशन URL कॉपी करें और companion को उस URL और उसी पेयरिंग सीक्रेट के साथ कॉन्फ़िगर करें।
- कार्ड पर वापस, सक्षम करें पर क्लिक करें। सहमति चेक और सहेजी बिना, कैप्चर स्वीकार नहीं किया जाता।
जब तक कनेक्टर बंद है या सहमति सहेजी नहीं गई है, इंजेशन URL हर पोस्ट को अस्वीकार करता है। इस तरह आप सूचना स्वीकार किए बिना कभी कुछ कैप्चर नहीं करते।
POST प्रारूप (companion अनुबंध)
companion एक संदेश या एक बैच भेजता है, बॉडी को पेयरिंग सीक्रेट (HMAC-SHA256) के साथ X-Sellio-Signature हेडर में हस्ताक्षरित करता है, जिसका प्रारूप sha256=<hex> होता है।
POST /api/inbound/whatsapp-capture/YOUR_TOKEN
X-Sellio-Signature: sha256=<hmac-sha256 of the body with the secret>
Content-Type: application/json
{
"messages": [
{
"messageId": "unique-message-id",
"from": "15551230000",
"to": "15559990000",
"direction": "in",
"body": "message text",
"timestamp": 1700000000,
"name": "Contact name"
}
]
}messageId सुनिश्चित करता है कि वही संदेश, अगर फिर से भेजा जाए, तो दोहराव न बने। direction "in" (प्राप्त) या "out" (प्रतिनिधि द्वारा भेजा गया) होता है। timestamp सेकंड या मिलीसेकंड स्वीकार करता है और टाइमलाइन को क्रमबद्ध करने के लिए उपयोग किया जाता है।