हम आपकी किस प्रकार सहायता कर सकते हैं?

आउटबाउंड एकीकरण

आउटबाउंड एकीकरण:
WhatsApp > CRM और आपके अन्य सिस्टम

इस लेख को अपने डेवलपर के साथ साझा करें या WhatsApp के साथ अपने सिस्टम को एकीकृत करने के लिए Zapier का उपयोग करें

सेटअप

टाइमलाइनएआई किसी वर्कस्पेस में किसी भी कनेक्टेड व्हाट्सएप अकाउंट में एक नया संदेश प्राप्त होने या भेजे जाने पर बाहरी सिस्टम को सूचित करने की अनुमति देता है। इसमें व्हाट्सएप मोबाइल ऐप के माध्यम से या टाइमलाइन के भीतर से भेजे गए व्हाट्सएप संदेश शामिल हैं।

यह अक्सर ऐसा मामला होता है कि इस तरह के एकीकरण का उपयोग कुछ मध्यस्थ सेवा जैसे कि ज़ापियर के माध्यम से किया जाता है, जहां एक वेहुक का प्रत्येक सक्रियण कार्य कोटा उपयोग की ओर मायने रखता है।

टास्क कोटा के उपयोग को अधिक कुशल बनाने के लिए, टाइमलाइनएआई चयनित अवधि में एक विशिष्ट चैट में भेजे गए या प्राप्त कई संदेशों को एकत्रित करने की संभावना प्रदान करता है। संदेश एक एकल "बंडल" के रूप में वेहुक के माध्यम से हैं। आपकी सुविधा के लिए, इस तरह के "बंडल" में संदेशों के पूर्व-स्वरूपित एकत्रीकरण के साथ एक फ़ील्ड होती है (और टाइमलाइनएआई में वार्तालाप में बिंदु का लिंक), लेकिन आप वेभौक के साथ प्रदान किए गए डेटा का उपयोग करके अपने स्वयं के स्वरूपण को लागू कर सकते हैं।

स्क्रीन शॉट 2021 11 23 पर 12 06 26
एक वेहुक के माध्यम से भेजे गए संदेशों का बंडल

आउटबाउंड वेबहुक का उपयोग करके एकीकरण सेटअप करने के लिए:

  1. अपने टाइमलाइनएआई खाते में वेबहुक मेनू पर नेविगेट करें
  2. आउटबाउंड टैब का चयन करें.

स्क्रीन शॉट 2021 11 23 पर 11.47.21

आपको निम्न सेटिंग्स के साथ प्रस्तुत किया जाएगा:

  • एकत्रीकरण विवरण - संदेशों को चयन के अनुसार (हर 1 / 6 / 12 / 24 घंटे) वेभौक का उपयोग करके एकत्र और भेजा जाएगा या जैसे ही वे टाइमलाइन में दिखाई देंगे ("कुल न करें)।
  • वेहुक यूआरएल - यहां आपको वास्तविक यूआरएल इनपुट करने की आवश्यकता है जिसे सूचित करने की आवश्यकता है।
  • वेपहुक सक्षम - यदि आप एकीकरण को रोकना चाहते हैं तो आप वेपहुक को अक्षम कर सकते हैं।

एक बार जब एक वेपहुक सक्षम हो जाता है और कुछ संदेश भेजे जाते हैं, तो एक गतिविधि लॉग प्रदर्शित किया जाएगा (10 सबसे हालिया क्रियाओं तक)।

त्रुटियाँ और समस्या निवारण

एकीकरण के सही संचालन को सुनिश्चित करने के लिए, यदि प्राप्त करने वाले छोर से 10 से अधिक लगातार त्रुटियों का सामना करना पड़ेगा (कोई भी त्रुटि, अमान्य यूआरएल से लेकर प्रतिक्रिया कोड तक जो 200 नहीं है), तो सिस्टम स्वचालित रूप से एकीकरण को अक्षम कर देगा। ऐसे मामले में, कार्यस्थान स्वामी को एक ईमेल सूचना प्राप्त होगी।

यदि आपको किसी त्रुटि का निवारण करने की आवश्यकता है, तो आप एक विस्तृत लॉग डाउनलोड कर सकते हैं (लिंक पृष्ठ के निचले भाग में उपलब्ध हो जाएगा), जहां भेजे गए डेटा और प्राप्त प्रतिक्रिया के सभी विवरणों के साथ 100 सबसे हालिया अनुरोध दिखाई देंगे।

डेटा स्वरूप

डेटा JSON प्रारूप में HTTP POST अनुरोध के माध्यम से एक वेपहुक के URL पर भेजा जाएगा। डेटा 2 अलग-अलग स्वरूपों में प्रदान किया जाता है, जो एकत्रीकरण ग्रैन्यूलैरिटी सेटिंग पर निर्भर करता है, जैसा कि नीचे वर्णित है।

प्रत्येक X घंटे में एकत्रित करें

संदेश ों को "बंडल" में एकत्रित किया जाएगा। निम्न डेटा उपलब्ध होगा:

  • "व्हाट्सएप अकाउंट" - व्हाट्सएप खाते (और वर्कस्पेस टीम मेट, जो खाते से जुड़ा था) का विवरण, जिसके माध्यम से संदेश प्राप्त या भेजा गया था
    • "फोन" - डब्ल्यूए खाते का फोन नंबर
    • "full_name" - WA खाता स्वामी का पूरा नाम, जैसा कि टाइमलाइन में पंजीकृत है
    • "ईमेल" - WA खाता स्वामी का ईमेल, जैसा कि टाइमलाइन में पंजीकृत है
  • "चैट" – चैट (प्रत्यक्ष चैट या समूह) का विवरण, जिसमें संदेश भेजा या प्राप्त किया गया था
    • "full_name" - चैट नाम (जैसा कि टाइमलाइन में दिखाई देता है)
    • "responsible_name" - एक टीम के साथी का नाम जिसे इस चैट के लिए जिम्मेदार के रूप में सौंपा गया है
    • "responsible_email" - एक टीम के साथी का ईमेल जिसे इस चैट के लिए जिम्मेदार के रूप में सौंपा गया है
    • "chat_url" - यूआरएल, जिस पर चैट को टाइमलाइनयूआई में एक्सेस किया जा सकता है
    • "chat_id" - टाइमलाइनयूआई में चैट की आईडी (चैट यूआरएल बनाने के लिए या इनबाउंड वेबहुक के साथ इस्तेमाल किया जा सकता है)
    • "is_new_chat" - सच है, अगर यह चैट अभी बनाई गई थी, अन्यथा गलत
    • "is_group" – सच है, अगर यह चैट एक सीधी चैट है, अन्यथा गलत है।
    • "फोन" - चैट का फोन नंबर (समूह चैट के लिए खाली)
  • "संदेश" – संदेशों की एक सूची, जहाँ प्रत्येक संदेश ऑब्जेक्ट में निम्न फ़ील्ड होते हैं
    • "निर्देश" - "प्राप्त" या "भेजा" जा सकता है
    • "टाइमस्टैम्प" - यूटीसी टाइमज़ोन में एक संदेश का टाइमस्टैम्प
    • "message_id" - उपयोग में नहीं
    • "message_uid" - संदेश की आंतरिक अद्वितीय आईडी जिसका उपयोग सार्वजनिक एपीआई के साथ संदेश विवरण और स्थिति अपडेट लोड करने के लिए किया जा सकता है ( विवरण यहां देखें)
    • "प्रेषक" - एक संदेश के प्रेषक (चैट के प्रतिभागी) का विवरण
      • "full_name" - टाइमलाइन में चैट या टीम के साथी के नाम का शीर्षक (यदि टाइमलाइन के भीतर से भेजा जाता है)
      • "फोन" - प्रेषक का फोन नंबर (या समूह चैट के लिए खाली)
    • "प्राप्तकर्ता" - एक संदेश के प्रेषक (चैट के प्रतिभागी) का विवरण
      • "full_name" - टाइमलाइन में चैट या टीम के साथी के नाम का शीर्षक
      • "फोन" - प्राप्तकर्ता का फोन नंबर (या समूह चैट के लिए खाली)
    • "पाठ" - संदेश पाठ (प्लेनटेक्स्ट)
    • "अनुलग्नक" - संदेश अनुलग्नक का वर्णन करने वाला एक ऑब्जेक्ट, जिसमें निम्न फ़ील्ड शामिल हैं
      • "temporary_download_url" - एक अस्थायी डाउनलोड URL, 15 मिनट के लिए मान्य
      • "फ़ाइल नाम" - फ़ाइल का नाम
      • "आकार" - फ़ाइल का आकार, बाइट्स में
      • "Mimetype" - फ़ाइल का माइम-प्रकार
  • "first_message_timestamp" - यूटीसी टाइमज़ोन में बंडल में सबसे पहले संदेश का टाइमस्टैम्प
  • "last_message_timestamp" - यूटीसी टाइमज़ोन में बंडल में सबसे हालिया संदेश का टाइमस्टैम्प
  • "एकत्रीकरण" - HTML प्रारूप में संदेश का समेकित पाठ, CRM या इसी तरह के सिस्टम के साथ नोट्स के लिए सामग्री के रूप में उपयोग के लिए उपयुक्त है, जिसमें टाइमलाइन में पहले संदेश का सीधा लिंक भी शामिल है।

उदाहरण

{
    "whatsapp_account" :
    {
        "full_name" : "Amnon Haha",
        "email" : "Amnon@acme.com",
        "phone" : "+972500000000"
    },
    "chat": 
    {
        "full_name": "John Doe>",
        "responsible_name": "Amnon",
        "responsible_email": "Amnon@acme.com",
        "chat_url" : "https://app.timelines.ai/chat/10010001/messages/",
        "chat_id" : "10010001",
        "is_new_chat" : true,
        "is_group": false, 
        "phone": "+97254000000"
    },
    "messages" :
    [
        {
            "direction": "sent", 
            "timestamp": "2021-02-24T16:25:29+0000",
            "message_id": "ddfskhsd76dsfs6dsd5skjsdhf",
            "sender": {
                "full_name": "John Doe",
                "phone": "+972540000000"
            },
            "recipient": {
                "full_name": "Jane Smith",
                "phone": "+972550000000"
            },
            "text": "lorem ipsum",
            "attachment": {
                "temporary_download_url": "https://acme.com/path",
                "filename": "someimage.png",
                "size": 128909,
                "mimetype": "image/png"
            }
        },
        {
            "direction": "received", 
            "timestamp": "2021-02-24T16:30:29+0000",
            "message_id": "ddfskhsd76dsfs6dsd5skjsdhf",
            "sender": {
                "full_name": "John Doe",
                "phone": "+972540000000"
            },
            "recipient": {
                "full_name": "Jane Smith",
                "phone": "+972550000000"
            },
            "text": "lorem ipsum"
        }
    ],
    "first_message_timestamp" : "2021-02-24T16:25:29+0000",
    "last_message_timestamp" : "2021-02-24T16:30:29+0000",
    "aggregation":
        "from John Doe on 2021-02-24 16:25: Hi! How are you?<br/>from Jane Smith on 2021-02-24 16:30: I am fine, how are you?<br/>Click <a href='https://app.timelines.ai/permalink/77a28d55-5345-5435-8c72-3a7bcad8ded9/'>here</h> to open the conversation in TimelinesAI"
}

एकत्रित मत करो

जैसे ही यह उपलब्ध हो जाता है, प्रत्येक संदेश व्यक्तिगत रूप से भेजा जाता है। कोई "बंडलिंग" नहीं होता है। निम्न डेटा उपलब्ध होगा:

  • "व्हाट्सएप अकाउंट" - व्हाट्सएप खाते (और वर्कस्पेस टीम मेट, जो खाते से जुड़ा था) का विवरण, जिसके माध्यम से संदेश प्राप्त या भेजा गया था
    • "फोन" - डब्ल्यूए खाते का फोन नंबर
    • "full_name" - WA खाता स्वामी का पूरा नाम, जैसा कि टाइमलाइन में पंजीकृत है
    • "ईमेल" - WA खाता स्वामी का ईमेल, जैसा कि टाइमलाइन में पंजीकृत है
  • "चैट" – चैट (प्रत्यक्ष चैट या समूह) का विवरण, जिसमें संदेश भेजा या प्राप्त किया गया था
    • "full_name" - चैट नाम (जैसा कि टाइमलाइन में दिखाई देता है)
    • "responsible_name" - एक टीम के साथी का नाम जिसे इस चैट के लिए जिम्मेदार के रूप में सौंपा गया है
    • "responsible_email" - एक टीम के साथी का ईमेल जिसे इस चैट के लिए जिम्मेदार के रूप में सौंपा गया है
    • "chat_url" - यूआरएल, जिस पर चैट को टाइमलाइनयूआई में एक्सेस किया जा सकता है
    • "chat_id" - टाइमलाइनयूआई में चैट की आईडी (चैट यूआरएल बनाने के लिए या इनबाउंड वेबहुक के साथ इस्तेमाल किया जा सकता है)
    • "is_new_chat" - सच है, अगर यह चैट अभी बनाई गई थी, अन्यथा गलत
    • "is_group" – सच है, अगर यह चैट एक सीधी चैट है, अन्यथा गलत है।
    • "फोन" - चैट का फोन नंबर (समूह चैट के लिए खाली)
  • "संदेश" - संदेश का विवरण
    • "निर्देश" - "प्राप्त" या "भेजा" जा सकता है
    • "टाइमस्टैम्प" - यूटीसी टाइमज़ोन में एक संदेश का टाइमस्टैम्प
    • "message_id" - संदेश की आंतरिक अद्वितीय आईडी
    • "प्रेषक" - एक संदेश के प्रेषक (चैट के प्रतिभागी) का विवरण
      • "full_name" - टाइमलाइन में चैट या टीम के साथी के नाम का शीर्षक (यदि टाइमलाइन के भीतर से भेजा जाता है)
      • "फोन" - प्रेषक का फोन नंबर (या समूह चैट के लिए खाली)
    • "प्राप्तकर्ता" - एक संदेश के प्रेषक (चैट के प्रतिभागी) का विवरण
      • "full_name" - टाइमलाइन में चैट या टीम के साथी के नाम का शीर्षक
      • "फोन" - प्राप्तकर्ता का फोन नंबर (या समूह चैट के लिए खाली)
    • "पाठ" - संदेश पाठ (प्लेनटेक्स्ट)
    • "अनुलग्नक" - संदेश अनुलग्नक का वर्णन करने वाला एक ऑब्जेक्ट, जिसमें निम्न फ़ील्ड शामिल हैं
      • "temporary_download_url" - एक अस्थायी डाउनलोड URL, 15 मिनट के लिए मान्य
      • "फ़ाइल नाम" - फ़ाइल का नाम
      • "आकार" - फ़ाइल का आकार, बाइट्स में
      • "Mimetype" - फ़ाइल का माइम-प्रकार

उदाहरण

{
    "whatsapp_account" :
    {
        "full_name" : "Amnon Haha",
        "email" : "Amnon@acme.com",
        "phone" : "+972500000000"
    },
    "chat": 
    {
        "full_name": "John Doe>",
        "responsible_name": "Amnon",
        "responsible_email": "Amnon@acme.com",
        "chat_url" : "https://app.timelines.ai/chat/10010001/messages/",
        "chat_id" : "10010001",
        "is_new_chat" : true,
        "is_group": false, 
        "phone": "+97251111111"
    },
    "message" :
       {
            "direction": "sent", 
            "timestamp": "2021-02-24T06:25:29+0000",
            "message_id": "ddfskhsd76dsfs6dsd5skjsdhf",
            "sender": {
                "full_name": "John Doe",
                "phone": "+972540000000"
            },
            "recipient": {
                "full_name": "Jane Smith",
                "phone": "+972550000000"
            },
            "text": "lorem ipsum",
            "attachment": {
                "temporary_download_url": "https://acme.com/path",
                "filename": "someimage.png",
                "size": 128909,
                "mimetype": "image/png"
            }
        }
}
सामग्री तालिका