Inbound Webhook Integration

پر بنایا گیا ہے

ٹائم لائنز اے آئی آپ کو ان ٹولز میں واقعات یا اقدامات کے جواب میں واٹس ایپ پیغامات بھیجنے کو خودکار بنانے کی اجازت دیتا ہے جو آپ پہلے سے استعمال کر رہے ہیں: سی آر ایم ، سپورٹ ، بھرتی کے نظام ، وغیرہ۔

"پیغام بھیجیں" واقعہ

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

انضمام کو سیٹ اپ کرنے کے لئے ، ورک اسپیس کے مالک کو "انضمام / ان باؤنڈ ویب ہوکس" اسکرین پر جانا چاہئے اور نیا یو آر ایل تیار کرنا چاہئے۔ بیرونی نظام کو اس یو آر ایل پر مخصوص شکل میں پیغام پوسٹ کرنا چاہئے (ذیل میں تفصیلات دیکھیں)۔

حدود

  • زیادہ سے زیادہ اٹیچمنٹ سائز 2 ایم بی ہے۔
  • وصول کنندہ کے فون نمبر فارمیٹ یا واٹس ایپ سے کنکشن کی فوری طور پر کوئی توثیق نہیں کی گئی ہے۔ پیغامات بھیجنے / پڑھنے کی حیثیت کی تصدیق کرنے کے لئے ٹائم لائنز UI پر جائیں۔

ان باؤنڈ ویب ہوکس کے ذریعے فائلیں بھیجنا

فائل بھیجنا: براہ راست ڈاؤن لوڈ بمقابلہ فائل ہوسٹنگ خدمات

براہ راست ڈاؤن لوڈ لنکس کا استعمال کرتے ہوئے فائلیں بھیجنا ضروری ہے۔ یہ وصول کنندہ کو اصل میں فائل وصول کرنے کی اجازت دیتا ہے۔

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

فائل ہوسٹنگ سروس لنکس کا معاملہ یہ ہے کہ فائلیں ڈاؤن لوڈ نہیں کی جاسکتی ہیں۔ اس کے بجائے جو کچھ ڈاؤن لوڈ اور بھیجا جاتا ہے ، وہ ایک شیئرنگ ویب پیج ہے ، جو "خراب" فائل کا باعث بن سکتا ہے۔

اس کے نتیجے میں ، یہ آپ کے پیغام کو متاثر کرے گا کیونکہ وصول کنندگان اس میڈیا تک رسائی حاصل نہیں کرسکتے ہیں جو آپ انہیں بھیجتے ہیں ، جس سے فائلیں ناقابل استعمال ہوجاتی ہیں۔ اس طرح ، یہ ضروری ہے کہ آپ اس بات کو یقینی بنائیں کہ آپ براہ راست ڈاؤن لوڈ لنکس بھیج رہے ہیں ، کیونکہ اس سے انہیں بغیر کسی مسئلے کے فائل تک رسائی حاصل کرنے کی اجازت ملے گی۔

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

کریڈٹ کا استعمال

  • پیغام بھیجنے میں پیغام بھیجنے والے کوٹے سے 1 کریڈٹ خرچ ہوتا ہے۔
  • غیر خالی متن اور اٹیچمنٹ کے ساتھ پیغام بھیجنے میں پیغام بھیجنے والے کوٹے سے 2 کریڈٹ استعمال ہوتے ہیں۔
  • اگر کوئی پیغام نہیں بھیجا جا سکتا ہے (غیر قانونی یا واٹس ایپ نمبر سے منسلک نہیں ہے، واٹس ایپ سرور کی خرابی) تو پیغام بھیجنے کا کوٹہ بحال ہوجائے گا (عام طور پر چند گھنٹوں کے اندر)۔

پیغام بھیجنے کی شرح

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

ویبھوک ترتیب اور اعمال

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

Webhook request format

ویبھوک پوسٹ کی درخواست کے ذریعہ جے ایس او این فارمیٹ میں ڈیٹا قبول کرتا ہے۔

  • "عمل" (لازمی) - فی الحال، صرف ایک ممکنہ قدر "بھیجنے" کی حمایت کی جاتی ہے
  • "متن" (لازمی) - ایک سادہ متن یو ٹی ایف -8 انکوڈ ڈ پیغام بھیجنے کے لئے (کوئی مارک ڈاؤن سپورٹ نہیں ہے، سوائے "\n" لائن جدا کار کے) کو خالی چھوڑا جاسکتا ہے، اگر فائل مخصوص ہے.
  • "file_url" (اختیاری) - کسی فائل کا عوامی طور پر قابل رسائی یو آر ایل جسے ڈاؤن لوڈ کیا جائے گا اور منسلکہ کے طور پر بھیجا جائے گا۔
  • "file_name" (اختیاری) - اٹیچمنٹ کے لئے ایک نام (اگر URL کی وضاحت کی گئی ہے تو فراہم کیا جانا ضروری ہے).

وصول کنندہ کو مندرجہ ذیل پیرامیٹرز میں سے ایک فراہم کرکے واضح کیا جاسکتا ہے:

  • "chat_id" - چیٹ کی ایک شناخت جیسا کہ ٹائم لائنز اے آئی میں ظاہر ہوتا ہے (چیٹ پیج کے یو آر ایل میں پایا جاسکتا ہے، یا بیرون ملک جانے والے ویبھوک کے پے لوڈ میں پایا جاسکتا ہے)۔ یہ کسی گروپ کو پیغامات بھیجنے کی حمایت کرتا ہے۔
  • "جید" - ایک واٹس ایپ جے آئی ڈی جو رابطے یا گروپ کی وضاحت کرتا ہے
  • "فون" - ایک فون نمبر، بین الاقوامی فون نمبر کے معیار کے مطابق فارمیٹ کیا گیا ہے، یعنی:
    [+] [ملک کا کوڈ] [علاقے کا کوڈ] [مقامی فون نمبر] (مثال کے طور پر: +14151231234)
  • "chat_name" - چیٹ کا ایک درست نام جیسا کہ ٹائم لائنز اے آئی میں ظاہر ہوتا ہے

اگر ورک اسپیس میں متعدد واٹس ایپ اکاؤنٹس منسلک ہیں تو ، واٹس ایپ اکاؤنٹ کو استعمال کرنے کی وضاحت کرنے کے لئے مندرجہ ذیل اضافی پیرامیٹر استعمال کریں:

  • "واٹس ایپ اکاؤنٹ فون" (اختیاری) - واٹس ایپ اکاؤنٹ کی وضاحت (فون نمبر کے طور پر، بین الاقوامی فارمیٹ میں) ہمیں بھیجنے کے لئے کرتا ہے. اگر خارج کر دیا جاتا ہے تو ، ورک اسپیس میں حال ہی میں منسلک فعال واٹس ایپ اکاؤنٹ بھیجنے کے لئے استعمال کیا جائے گا۔ نوٹ: اگر "chat_id" پیرامیٹر کی وضاحت کی گئی ہے تو ، "واٹس ایپ اکاؤنٹ فون" کو نظر انداز کردیا جائے گا ، کیونکہ ہر چیٹ پہلے ہی ایک مخصوص واٹس ایپ اکاؤنٹ سے منسلک ہے۔

ویبھوک کا جواب

کامیابی کی صورت میں (درخواست کی توثیق کی گئی تھی اور بھیجنے کے لئے قبول کیا گیا تھا) ، ویبھوک ایچ ٹی ٹی پی اسٹیٹس 200 اور جے ایس او این کے ساتھ جواب دے گا ، جس میں تخلیق کردہ پیغام کا message_id شامل ہوگا:

{
    "status": "success",
    "data": {
        "message_id": "wa_backend:3EB09FCC85FE99662E46"
    }
}

 

غلطی کی صورت میں ، ویبھوک غلطی کی تفصیلات کے ساتھ ایچ ٹی ٹی پی اسٹیٹس 40 ایکس اور جے ایس او این کے ساتھ جواب دے گا ، مثال کے طور پر:

{
"status": 40X,
"data": {},
"message": "Webhook not found"
}

مثالیں

مثال 1 - مخصوص ڈبلیو اے اکاؤنٹ کے ذریعے کسی مخصوص فون نمبر پر پیغام بھیجنا:

{
"action": "send",
"whatsapp account phone" : "+15105566777", 
"phone": "+14151231234", 
"text": "lorem ipsum"
}

مثال 2 - آئی ڈی کے ذریعہ بیان کردہ چیٹ (یا گروپ) میں متن اور اٹیچمنٹ کے ساتھ پیغام بھیجنا:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://timelines.ai/logo.png",
"file_name" : "logo.png"
}
ایڈمن
ایڈمن کی تازہ ترین پوسٹس (سب دیکھیں)
مندرجات کا جدول