وہ بوٹس جو آپ کے اپنے سسٹمز اور دستاویزات استعمال کرتے ہیں

یہ بوٹ کا ایک اختیاری حصہ ہے۔ OmniBrand کے انجینئرز آپ کی درخواست پر اسے آپ کے لیے ترتیب دیتے ہیں؛ آپ کی ورک اسپیس میں کچھ بھی ترتیب دینے کی ضرورت نہیں۔

یہ کیا کر سکتا ہے

• اپنی معیاری دستاویزات بھیجیں: کمپنی پروفائل، قیمتوں کی فہرست، مینو، بروشر — وہ فائلیں جو آپ آن لائن رکھتے ہیں۔ آپ ہر ایک کو ایک نام اور ایک لنک دیتے ہیں؛ بوٹ وہی بھیجتا ہے جو گاہک مانگتا ہے۔
• اپنے سسٹم میں ڈیٹا تلاش کریں چیٹ کے دوران: گاہک مثلاً انوائس یا آرڈر نمبر دیتا ہے، بوٹ آپ کے سسٹم سے پوچھتا ہے اور جواب دیتا ہے — "انوائس 204 ادا ہو چکی ہے"، "آپ کا آرڈر ڈیلیوری کے لیے روانہ ہو چکا ہے"۔
• آپ کے سسٹم کی بنائی ہوئی دستاویز بھیجیں، جیسے اسی انوائس کی PDF، اس لنک کے ذریعے جو آپ کا سسٹم واپس کرتا ہے۔
• جمع شدہ جوابات اپنے سسٹم کو بھیجیں، مثلاً اپنے سی آر ایم میں لیڈ بنانے کے لیے۔

دستاویز چیٹ میں فائل کے طور پر پہنچتی ہے: WhatsApp پر دستاویزی پیغام کے طور پر، ای میل میں اٹیچمنٹ کے طور پر، اور ویب سائٹ چیٹ میں ایسی فائل کے طور پر جسے وزیٹر کھول سکتا ہے۔ آپ کے ان باکس تھریڈ میں بوٹ کا پیغام فائل کا نام 📄 کے ساتھ دکھاتا ہے۔

OmniBrand کو آپ سے کیا چاہیے

معیاری دستاویزات کے لیے:

• ہر دستاویز کا نام جیسے گاہک اسے مانگیں گے، اور فائل کا ایک لنک جو https:// سے شروع ہو اور سائن اِن کیے بغیر ڈاؤن لوڈ ہو سکے۔ WhatsApp، Instagram اور Messenger پر میسجنگ سروس اس لنک سے فائل حاصل کرتی ہے؛ ای میل اور ویب سائٹ چیٹ کے لیے OmniBrand اسے ڈاؤن لوڈ کرتا ہے (زیادہ سے زیادہ 25 MB) اور اپنے اسٹوریج سے بھیجتا ہے۔

آپ کے سسٹم میں ڈیٹا تلاش کرنے کے لیے:

1. آپ کے سسٹم کی اس سروس کا پتا (URL) جو ایک سوال کا جواب دیتی ہے، https:// سے شروع ہوتا ہوا — مثلاً https://erp.example.com/api/invoices/{number}، اس جگہ کے ساتھ جہاں گاہک کی ویلیو آتی ہے۔
2. آیا اسے GET سے کال کیا جاتا ہے یا POST سے۔
3. کریڈنشل: ایک API کلید یا ٹوکن، اور اس ہیڈر کا نام جس میں یہ جاتا ہے (عموماً Authorization)۔ اسے اس چینل کے ذریعے بھیجیں جو سپورٹ آپ کو دے، کسی عوامی پیغام میں نہیں۔
4. ایک ٹیسٹ ویلیو جو موجود ہو اور ایک جو موجود نہ ہو (مثلاً ایک اصل انوائس نمبر اور ایک فرضی)، تاکہ انجینئرز لائیو ہونے سے پہلے آپ کے اصل ڈیٹا سے ٹیسٹ کر سکیں۔
5. جواب کی مختصر تفصیل: اس میں کون سے فیلڈز ہیں (مثلاً status، amount، pdf_url) اور ان میں سے کون سے بوٹ گاہک کو بتا سکتا ہے۔
6. آپ کا سسٹم "نہیں ملا" کیسے کہتا ہے: اسے HTTP اسٹیٹس 404 کے ساتھ جواب دینا ہوگا۔ کوئی بھی دوسری خرابی "سسٹم دستیاب نہیں" سمجھی جاتی ہے۔
7. بوٹ کے ڈیٹا ظاہر کرنے سے پہلے گاہک کو اپنی شناخت ثابت کرنے کے لیے کیا دینا ہوگا (مثلاً انوائس پر درج فون نمبر)، تاکہ بوٹ اس کے بارے میں پوچھے۔

آپ کا ڈیٹا کیسے محفوظ رہتا ہے

• صرف https پتے قبول کیے جاتے ہیں۔
• آپ کا کریڈنشل انکرپٹڈ حالت میں محفوظ کیا جاتا ہے۔ محفوظ ہونے کے بعد OmniBrand کا عملہ اس کے صرف آخری چار حروف دیکھ سکتا ہے؛ یہ صرف آپ کے سسٹم کو جانے والی درخواست میں شامل کیا جاتا ہے اور گاہکوں کو کبھی نہیں دکھایا جاتا۔
• گاہک جو ویلیوز ٹائپ کرتے ہیں وہ محفوظ طریقے سے پتے میں انکوڈ کی جاتی ہیں؛ POST کے ساتھ وہ JSON کے طور پر بھیجی جاتی ہیں۔
• OmniBrand کے سرورز اندرونی یا نجی نیٹ ورک پتوں کو کال کرنے سے انکار کرتے ہیں، اور ہر ری ڈائریکٹ کو دوبارہ جانچتے ہیں۔ جب آپ کا سسٹم کسی دوسرے پتے پر ری ڈائریکٹ کرتا ہے تو آپ کا کریڈنشل وہاں نہیں بھیجا جاتا۔
• ہر کال زیادہ سے زیادہ 10 سیکنڈ انتظار کرتی ہے اور جواب کا زیادہ سے زیادہ 256 KB پڑھتی ہے۔
• ان کنکشنز میں ہر تبدیلی اور ہر ٹیسٹ اسے کرنے والے انجینئر کے نام کے ساتھ ریکارڈ کیا جاتا ہے۔

اگر آپ کا سسٹم جواب نہ دے

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

اگر کوئی دستاویز اپنے لنک سے ڈاؤن لوڈ نہ ہو سکے (ای میل اور ویب سائٹ چیٹ کے لیے: عوامی https لنک نہ ہو، یا 25 MB سے بڑی ہو)، تو بوٹ گفتگو آپ کی ٹیم کو bot-error ٹیگ اور ایک نوٹ کے ساتھ سونپ دیتا ہے جس میں دستاویز کا نام ہوتا ہے۔

متعلقہ

• ان باکس بوٹس: یہ کیا کرتے ہیں اور کیسے حاصل کریں
• گاہکوں کی بتائی ہوئی باتیں بوٹ کہاں محفوظ کرتا ہے
• سپورٹ سے رابطہ