باہر جانے والا انضمام

آؤٹ باونڈ انضمام:
واٹس ایپ > سی آر ایم اور آپ کے دیگر سسٹم

اس مضمون کو اپنے ڈویلپر کے ساتھ اشتراک کریں یا واٹس ایپ کے ساتھ اپنے سسٹم کو ضم کرنے کے لئے زپیئر کا استعمال کریں

سیٹ اپ

ٹائم لائنز اے آئی کسی بیرونی نظام کو مطلع کرنے کی اجازت دیتا ہے جب کوئی نیا پیغام کسی کام کی جگہ پر کسی بھی منسلک واٹس ایپ اکاؤنٹ میں موصول یا بھیجا جاتا ہے۔ اس میں واٹس ایپ کے ذریعے یا ٹائم لائنز کے اندر سے بھیجے گئے واٹس ایپ پیغامات شامل ہیں۔

اکثر ایسا ہوتا ہے کہ اس طرح کے انضمام کو کسی درمیانی سروس جیسے زپیئر کے ذریعہ استعمال کیا جاتا ہے ، جہاں ویبھوک کی ہر سرگرمی ٹاسک کوٹہ کے استعمال میں شمار ہوتی ہے۔

ٹاسک کوٹہ کے استعمال کو زیادہ موثر بنانے کے لئے ، ٹائم لائنز اے آئی منتخب مدت میں مخصوص چیٹ میں بھیجے گئے یا موصول ہونے والے متعدد پیغامات کو جمع کرنے کا امکان فراہم کرتا ہے۔ پیغامات ویبھوک کے ذریعے واحد "بنڈل" کے طور پر ہیں۔ آپ کی سہولت کے لئے ، اس طرح کے "بنڈل" میں پیغامات کی پہلے سے فارمیٹ شدہ جمع کاری کے ساتھ ایک فیلڈ شامل ہے (اور ٹائم لائنز اے آئی میں بات چیت کے نقطہ کا لنک) ، لیکن آپ ویبھوک کے ساتھ فراہم کردہ ڈیٹا کا استعمال کرتے ہوئے اپنی فارمیٹنگ کو نافذ کرسکتے ہیں۔

اسکرین شاٹ 2021 11 23 پر 12 06 26
ویبھوک کے ذریعے بھیجے گئے پیغامات کا بنڈل

آؤٹ باؤنڈ ویب ہوکس کا استعمال کرتے ہوئے انضمام کو ترتیب دینے کے لئے:

  1. اپنے ٹائم لائنز اے آئی اکاؤنٹ میں ویب ہوکس مینو پر جائیں
  2. آؤٹ باونڈ ٹیب منتخب کریں۔

اسکرین شاٹ 2021 11 23 پر 11.47.21

آپ کو مندرجہ ذیل ترتیبات کے ساتھ پیش کیا جائے گا:

  • - پیغامات کو انتخاب (ہر 1 / 6 / 12 / 24 گھنٹے) کے مطابق ویبھوک کا استعمال کرتے ہوئے جمع اور بھیجا جائے گا یا جیسے ہی وہ ٹائم لائنز میں ظاہر ہوں گے بھیجے جائیں گے ("مجموعی نہ کریں)
  • ویبھوک یو آر ایل - یہاں آپ کو اصل یو آر ایل ان پٹ کرنے کی ضرورت ہے جسے مطلع کرنے کی ضرورت ہے۔
  • ویبھوک فعال ہے - اگر آپ انضمام کو روکنا چاہتے ہیں تو آپ ویبھوک کو غیر فعال کرسکتے ہیں۔

ایک بار جب ویبھوک فعال ہوجاتا ہے اور کچھ پیغامات بھیجے جاتے ہیں تو ، ایک سرگرمی لاگ ظاہر ہوگا (10 تازہ ترین اقدامات تک)۔

نوٹ: فی الحال ، صرف ٹیکسٹ اور ایموجی پیغامات کی حمایت کی جاتی ہے۔ وہ پیغامات جن میں منسلکات موجود ہوں انہیں چھوڑ دیا جائے گا۔

غلطیاں اور مسائل کا ازالہ

انضمام کے صحیح آپریشن کو یقینی بنانے کے لئے ، اگر وصول کنندہ سے لگاتار 10 سے زیادہ غلطیوں کا سامنا کرنا پڑے گا (کوئی بھی غلطی ، غیر قانونی یو آر ایل سے لے کر جوابی کوڈ تک جو 200 نہیں ہے) تو سسٹم خود بخود انضمام کو غیر فعال کردے گا۔ ایسی صورت میں ، کام کی جگہ کے مالک کو ایک ای میل اطلاع موصول ہوگی۔

اگر آپ کو کسی غلطی کو حل کرنے کی ضرورت ہے تو ، آپ ایک تفصیلی لاگ ڈاؤن لوڈ کرسکتے ہیں (لنک صفحے کے نچلے حصے میں دستیاب ہوجائے گا) جہاں 100 تک تازہ ترین درخواستیں بھیجے گئے ڈیٹا اور موصول ہونے والے جواب کی تمام تفصیلات کے ساتھ ظاہر ہوں گی۔

ڈیٹا فارمیٹ

ڈیٹا جے ایس او این فارمیٹ میں ایچ ٹی ٹی پی پوسٹ کی درخواست کے ذریعہ ویبھوک کے یو آر ایل پر بھیجا جائے گا۔ اعداد و شمار 2 مختلف فارمیٹس میں فراہم کیے جاتے ہیں ، جیسا کہ ذیل میں بیان کیا گیا ہے ، ایگریگیشن گرینولٹی سیٹنگ پر منحصر ہے۔

مجموعی طور پر ہر ایکس گھنٹے

پیغامات کو "بنڈل" میں جمع کیا جائے گا۔ مندرجہ ذیل اعداد و شمار دستیاب ہوں گے:

  • "واٹس ایپ اکاؤنٹ" - واٹس ایپ اکاؤنٹ کی تفصیلات (اور ورک اسپیس ٹیم، جس نے اکاؤنٹ کو منسلک کیا) جس کے ذریعے پیغام موصول یا بھیجا گیا تھا
    • "فون" - ڈبلیو اے اکاؤنٹ کا فون نمبر
    • "full_name" - ڈبلیو اے اکاؤنٹ کے مالک کا پورا نام، جیسا کہ ٹائم لائنز میں رجسٹرڈ ہے
    • "ای میل" - ڈبلیو اے اکاؤنٹ کے مالک کا ای میل، جیسا کہ ٹائم لائنز میں رجسٹرڈ ہے
  • "چیٹ" - چیٹ کی تفصیلات (براہ راست چیٹ یا گروپ)، جس میں پیغام بھیجا یا موصول ہوا تھا
    • "full_name" - چیٹ کا نام (جیسا کہ ٹائم لائنز میں ظاہر ہوتا ہے)
    • "responsible_name" - ایک ساتھی کا نام جسے اس چیٹ کے ذمہ دار کے طور پر تفویض کیا گیا ہے
    • "responsible_email" - ایک ساتھی کا ای میل جسے اس چیٹ کے ذمہ دار کے طور پر تفویض کیا گیا ہے
    • "chat_url" - یو آر ایل ، جس پر چیٹ کو ٹائم لائنز یو آئی میں رسائی حاصل کی جاسکتی ہے۔
    • "chat_id" - ٹائم لائنز یو آئی میں چیٹ کی آئی ڈی (چیٹ یو آر ایل بنانے یا ان باؤنڈ ویب ہوکس کے ساتھ استعمال کیا جاسکتا ہے)
    • "is_new_chat" - سچ، اگر یہ چیٹ صرف بنائی گئی تھی، تو غلط بصورت دیگر
    • "is_group" - سچ ہے، اگر یہ چیٹ براہ راست چیٹ ہے، تو غلط بصورت دیگر
    • "فون" - چیٹ کا فون نمبر (گروپ چیٹ کے لئے خالی)
  • "پیغامات" - پیغامات کی ایک فہرست، جہاں ہر پیغام آبجیکٹ مندرجہ ذیل فیلڈز پر مشتمل ہوتا ہے
    • "ہدایت" - "وصول" یا "بھیجا" جا سکتا ہے
    • "ٹائم اسٹیمپ" - یو ٹی سی ٹائم زون میں ایک پیغام کا ٹائم اسٹیمپ
    • "message_id" - پیغام کی اندرونی منفرد شناخت
    • "بھیجنے والا" - پیغام بھیجنے والے (چیٹ کے شریک) کی تفصیلات
      • "full_name" - ٹائم لائنز میں چیٹ کا عنوان یا ٹیم کے ساتھی کا نام (اگر ٹائم لائنز کے اندر سے بھیجا گیا ہو)
      • "فون" - مرسل کا فون نمبر (یا گروپ چیٹ کے لئے خالی)
    • "وصول کنندہ" - پیغام بھیجنے والے (چیٹ کے شریک) کی تفصیلات
      • "full_name" - ٹائم لائنز میں چیٹ یا ٹیم کے ساتھی کا نام
      • "فون" - وصول کنندہ کا فون نمبر (یا گروپ چیٹ کے لئے خالی)
    • "متن" - پیغام متن (سادہ متن)
  • "first_message_timestamp" - یو ٹی سی ٹائم زون میں بنڈل میں سب سے پہلے پیغام کا ٹائم اسٹیمپ
  • "last_message_timestamp" - یو ٹی سی ٹائم زون میں بنڈل میں تازہ ترین پیغام کا ٹائم اسٹیمپ
  • "جمع" - پیغام کا جمع متن ، ایچ ٹی ایم ایل فارمیٹ میں ، سی آر ایم یا اسی طرح کے سسٹم کے ساتھ نوٹوں کے لئے مواد کے طور پر استعمال کرنے کے لئے موزوں ہے ، جس میں ٹائم لائنز میں پہلے پیغام کا براہ راست لنک بھی شامل ہے۔

مثال

{
    "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"
        },
        {
            "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" - ڈبلیو اے اکاؤنٹ کے مالک کا پورا نام، جیسا کہ ٹائم لائنز میں رجسٹرڈ ہے
    • "ای میل" - ڈبلیو اے اکاؤنٹ کے مالک کا ای میل، جیسا کہ ٹائم لائنز میں رجسٹرڈ ہے
  • "چیٹ" - چیٹ کی تفصیلات (براہ راست چیٹ یا گروپ)، جس میں پیغام بھیجا یا موصول ہوا تھا
    • "full_name" - چیٹ کا نام (جیسا کہ ٹائم لائنز میں ظاہر ہوتا ہے)
    • "responsible_name" - ایک ساتھی کا نام جسے اس چیٹ کے ذمہ دار کے طور پر تفویض کیا گیا ہے
    • "responsible_email" - ایک ساتھی کا ای میل جسے اس چیٹ کے ذمہ دار کے طور پر تفویض کیا گیا ہے
    • "chat_url" - یو آر ایل ، جس پر چیٹ کو ٹائم لائنز یو آئی میں رسائی حاصل کی جاسکتی ہے۔
    • "chat_id" - ٹائم لائنز یو آئی میں چیٹ کی آئی ڈی (چیٹ یو آر ایل بنانے یا ان باؤنڈ ویب ہوکس کے ساتھ استعمال کیا جاسکتا ہے)
    • "is_new_chat" - سچ، اگر یہ چیٹ صرف بنائی گئی تھی، تو غلط بصورت دیگر
    • "is_group" - سچ ہے، اگر یہ چیٹ براہ راست چیٹ ہے، تو غلط بصورت دیگر
    • "فون" - چیٹ کا فون نمبر (گروپ چیٹ کے لئے خالی)
  • "پیغام" - پیغام کی تفصیلات
    • "ہدایت" - "وصول" یا "بھیجا" جا سکتا ہے
    • "ٹائم اسٹیمپ" - یو ٹی سی ٹائم زون میں ایک پیغام کا ٹائم اسٹیمپ
    • "message_id" - پیغام کی اندرونی منفرد شناخت
    • "بھیجنے والا" - پیغام بھیجنے والے (چیٹ کے شریک) کی تفصیلات
      • "full_name" - ٹائم لائنز میں چیٹ کا عنوان یا ٹیم کے ساتھی کا نام (اگر ٹائم لائنز کے اندر سے بھیجا گیا ہو)
      • "فون" - مرسل کا فون نمبر (یا گروپ چیٹ کے لئے خالی)
    • "وصول کنندہ" - پیغام بھیجنے والے (چیٹ کے شریک) کی تفصیلات
      • "full_name" - ٹائم لائنز میں چیٹ یا ٹیم کے ساتھی کا نام
      • "فون" - وصول کنندہ کا فون نمبر (یا گروپ چیٹ کے لئے خالی)
    • "متن" - پیغام متن (سادہ متن)

مثال

{
    "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"
        }
}
مندرجات کا جدول