دستاویزات

ایپس اور انٹیگریشنز

وہ ٹولز جوڑیں جو آپ کی ٹیم پہلے ہی استعمال کرتی ہے — Stripe، Shopify، Mailchimp، MailerLite، Jira اور Tracio۔ انسٹال شدہ ایپس گاہک کا لائیو ڈیٹا ان باکس کے گفتگو پینل میں کارڈز کی صورت دکھاتی ہیں، بالکل چیٹ کے ساتھ۔

جائزہ#

ایپ مارکیٹ پلیس Settings → Apps میں ہے۔ ایپس پورے ورک اسپیس کے لیے صرف ایک بار انسٹال ہوتی ہیں: ایڈمن سروس کو ورک اسپیس کی اپنی اسناد سے جوڑتا ہے، اور ان باکس رسائی رکھنے والا ہر ٹیم ساتھی گفتگو پینل میں بننے والا کارڈ دیکھتا ہے۔ نمائندے خود کچھ انسٹال نہیں کرتے — اور AI ایجنٹس بھی کبھی کچھ انسٹال نہیں کرتے۔

ورک اسپیس سطح کی انسٹالیشن

فی ورک اسپیس اسناد کا ایک ہی سیٹ۔ ایپ انسٹال، ترمیم یا حذف کرنا سب پر بیک وقت اثر ڈالتا ہے۔

ان باکس میں کارڈز

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

کوئی بھرتی نہیں

کیٹلاگ میں درج ہر چیز آج ہی انسٹال ہو سکتی ہے — کوئی "جلد آ رہا ہے" سیکشن نہیں۔ ایک درخواستی ٹائل کے ذریعے آپ بتا سکتے ہیں کہ کون سی سروس کم ہے۔

ایپس کے انتظام کے لیے Install and configure apps اجازت درکار ہے (طے شدہ طور پر Owner اور Admin کرداروں میں شامل، اور کسٹم کرداروں کو دی جا سکتی ہے)۔ جن ٹیم ساتھیوں کے پاس یہ نہیں، وہ پھر بھی گفتگوؤں میں ایپ کارڈز دیکھتے ہیں — بس کچھ انسٹال یا دوبارہ کنفیگر نہیں کر سکتے۔

ایپ کیٹلاگ#

آج چھ ایپس دستیاب ہیں:

ایپزمرہنمائندے گفتگو میں کیا دیکھتے ہیں
Stripeادائیگیاںجس شخص سے آپ بات کر رہے ہیں اس کی سبسکرپشن اور حالیہ ادائیگیاں
Shopifyکامرسحالیہ آرڈرز، ادائیگی اور ترسیل کی حیثیت کے ساتھ
Mailchimpمارکیٹنگجس شخص سے آپ بات کر رہے ہیں اس کی سبسکرپشن حیثیت، آڈینس اور ٹیگز
MailerLiteمارکیٹنگجس شخص سے آپ بات کر رہے ہیں اس کی سبسکرپشن حیثیت، گروپس اور سائن اپ کی تاریخ
Jiraاِشو ٹریکنگاس گفتگو سے جُڑے اِشوز، اور ایک کلک میں نیا اِشو کھولنے کی سہولت
Tracioسیکیورٹیانسان یا بوٹ: چیٹ ویجٹ وزیٹر پر Tracio کا فیصلہ

اپنے بیک آفس کا سادہ لنک چاہیے؟ اس کے لیے نہ اکاؤنٹ چاہیے نہ ٹوکن، اس لیے وہ ایپ کیٹلاگ کے بجائے Settings → General → Links to your systems میں رہتا ہے۔

ایپ انسٹال کرنا#

Settings → Apps کھولیں، کوئی ٹائل چنیں، اور ایپ کی مانگی گئی اسناد بھر دیں۔ ہر فیلڈ وینڈر کے ڈیش بورڈ کے اسی صفحے سے لنک ہوتی ہے جہاں وہ قدر بنائی یا پائی جاتی ہے۔

مرحلہتفصیل
1. پیش منظر دیکھیںکچھ بھی پیسٹ کرنے سے پہلے کنفیگریشن صفحہ اسی کارڈ کا نمونہ دکھاتا ہے جو آپ کے نمائندے دیکھیں گے — فرضی ڈیٹا سے بنا، تاکہ سند محفوظ ہونے سے پہلے آپ جان لیں کہ ورک اسپیس سے کیا شیئر ہو رہا ہے۔
2. اسناد درج کریںAPI کلید یا ٹوکن پیسٹ کریں۔ قدریں خودکار طور پر ٹرِم ہو جاتی ہیں — کاپی پیسٹ سے آیا آخری اسپیس یا نئی لائن انسٹال نہیں توڑے گی۔
3. محفوظ اور ٹیسٹ کریںمحفوظ کرنا کنفیگریشن ذخیرہ کرتا ہے؛ کنکشن ٹیسٹ کرنا وینڈر کو حقیقی کال بھیجتا ہے اور یہی چیز اسٹیٹس چپ کو سبز کرتی ہے۔

ہر ایپ ٹائل پر ایک اسٹیٹس چپ ہوتی ہے جو بتاتی ہے کہ انسٹالیشن کس مرحلے پر ہے:

حیثیتمطلب
Not testedاسناد محفوظ ہیں، مگر ایپ نے ابھی کسی حقیقی درخواست کا جواب نہیں دیا۔
Connectedوینڈر نے واقعی جواب دیا ہے — کنکشن صرف محفوظ نہیں، تصدیق شدہ ہے۔
Needs attentionوینڈر نے محفوظ اسناد مسترد کر دیں (منسوخ یا زائدالمیعاد کلید)۔ کارڈز وینڈر کو کال کرنا روک دیتے ہیں جب تک ایڈمن ایپ کو محفوظ یا دوبارہ ٹیسٹ نہ کرے۔
Errorکچھ اور ناکام ہوا — ٹول ٹپ دیکھیں۔
Disabledایڈمن نے ایپ بند کر دی۔ کارڈ ان باکس سے غائب ہو جاتا ہے مگر اسناد حذف نہیں ہوتیں۔

اسناد اور سیکیورٹی#

ایپ کی اسناد ورک اسپیس کی ملکیت ہیں، اور چند اصول انہیں محفوظ رکھتے ہیں:

  • ذخیرے میں انکرپٹڈ۔ خفیہ فیلڈز (API کلیدیں، ٹوکن) اسٹوریج میں فی کلید انکرپٹ ہوتی ہیں اور محفوظ ہونے کے بعد کبھی واپس نہیں دکھائی جاتیں۔
  • جہاں وینڈر اجازت دے، کم از کم اختیار۔ Stripe کو محدود کلید سے جوڑنا چاہیے جو Customers، Subscriptions، Charges اور Invoices پڑھ سکے — اور Refunds کی write رسائی صرف تب، جب نمائندوں کو گفتگو سے رقم واپس کرنی ہو۔ فل ایکسیس کلید پیسٹ کریں تو بھی کام کرے گی، مگر سیٹنگز صفحہ اسے بدلنے کا مشورہ دے گا۔
  • منزل بدلنے پر راز دوبارہ مانگا جاتا ہے۔ جس فیلڈ سے سند بندھی ہے — Shopify اسٹور ڈومین، Jira سائٹ URL — اس میں ترمیم پر ٹوکن دوبارہ درج کرنا پڑتا ہے، تاکہ محفوظ سند کبھی ایسے ہوسٹ کی طرف نہ موڑی جا سکے جس کے لیے وہ نہیں تھی۔
  • منسوخی پورے ورک اسپیس پر اثر کرتی ہے۔ فی ایپ فی ورک اسپیس ایک ہی انسٹالیشن ہوتی ہے: وینڈر کے ہاں کلید گھمائیں یا منسوخ کریں تو ہر ٹیم ساتھی کا کارڈ اُس وقت تک رک جاتا ہے جب تک ایڈمن اسے Settings → Apps میں اپڈیٹ نہ کرے۔

ان باکس میں ایپ کارڈز#

انسٹال کے بعد ہر ایپ ان باکس کے گفتگو کی تفصیل والے پینل میں ایک ویجٹ کی صورت ظاہر ہوتی ہے۔ گفتگو کھولنے پر وینڈر سے لائیو کارڈ آتا ہے: یہ گاہک Stripe میں کون ہے، اس کے حالیہ Shopify آرڈرز، نیوز لیٹر کی حیثیت، تھریڈ سے جُڑے Jira اِشوز، یا وزیٹر پر Tracio کا فیصلہ۔ زیادہ تر کارڈز وینڈر کے اپنے ڈیش بورڈ کے متعلقہ ریکارڈ سے بھی لنک کرتے ہیں — Tracio کا فیصلہ مکمل طور پر پینل میں ہی رہتا ہے۔

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

کارڈز تصدیق شدہ شناخت پر چلتے ہیں#

Stripe، Shopify، Mailchimp اور MailerLite گاہک کو ای میل ایڈریس سے تلاش کرتے ہیں — اور صرف اُس ایڈریس سے جو واقعی تصدیق شدہ ہو: ویجٹ کی دستخط شدہ شناخت (شناخت کی تصدیق) میں شامل، یا ای میل چینل کی گفتگو کا From ایڈریس۔ جو ایڈریس وزیٹر نے محض چیٹ میں لکھ دیا ہو وہ تلاش کے لیے بالکل استعمال نہیں ہوتا — ورنہ کوئی بھی کسی حقیقی گاہک کی ای میل لکھ کر اس کی ادائیگیوں کی تاریخ دیکھ لیتا۔ ایسی صورت میں کارڈ بتا دیتا ہے کہ ایڈریس کے پیچھے تصدیق شدہ شناخت نہیں۔

Jira اور Tracio ای میل پر نہیں چلتے — Jira کارڈز گفتگو کے لنک شدہ اِشوز کے ہیں، اور Tracio ویجٹ وزیٹر کا — اس لیے وہ تصدیق شدہ ایڈریس نہ ہونے پر بھی کام کرتے ہیں۔

اگر گفتگو کے اپنے ایڈریس سے کچھ نہ ملے تو Respondo رابطے کا دوسرا معلوم ایڈریس بھی آزماتا ہے (مثلاً رابطوں کے ضم ہونے کے بعد)، اور کارڈ پر وہ ایڈریس لکھ دیتا ہے جو استعمال ہوا۔

ہر ایپ کیا دکھاتی ہے#

Stripe#

گاہک کی بلنگ پر صرف پڑھنے کی کھڑکی: نام، ای میل، اکاؤنٹ بیلنس اور کاپی ہونے والی کسٹمر ID، ساتھ سبسکرپشن — اسٹیٹس بیج، پلان، ماہانہ قدر اور آغاز کی تاریخ — اور انوائس نمبروں کے ساتھ حالیہ ادائیگیاں۔ رقم کی واپسی واحد اختیاری write ہے: ایڈمن کو ایپ کی سیٹنگز میں Allow refunds from the conversation panel آن کرنا ہوتا ہے (طے شدہ طور پر بند)، آپریٹر کے پاس Run refunds and cancellations اجازت ہونی چاہیے، اور ہر ری فنڈ کی تصدیق REFUND ٹائپ کر کے کرنی پڑتی ہے — بھیجے جانے کے بعد Stripe ری فنڈ واپس نہیں لے سکتا۔

Shopify#

صرف پڑھنے کے حالیہ آرڈرز — آرڈر نمبر، تاریخ، کل رقم، ادائیگی اور ترسیل کی حیثیت — ہر آرڈر اور آپ کے Shopify ایڈمن میں گاہک کے ریکارڈ کے لنکس کے ساتھ۔ کنکشن آپ کے اسٹور ڈومین اور ایسی کسٹم ایپ کے Admin API ٹوکن سے ہوتا ہے جس کے پاس read_customers اور read_orders اسکوپس ہوں۔

Mailchimp#

سبسکرائبر ویسا ہی جیسا Mailchimp اسے دیکھتا ہے: اسٹیٹس بیج، آڈینس، ٹیگز، انگیجمنٹ اور حالیہ مہم کی سرگرمی (بھیجے گئے، کھولے گئے، کلکس)۔ ایک ہی ایکشن دستیاب ہے: Unsubscribe — گفتگو چھوڑے بغیر "مجھے ای میل بھیجنا بند کرو" درخواست پوری کرنے کے لیے۔ یہ API کے ذریعے ناقابلِ واپسی ہے — Mailchimp میں کوئی شخص صرف خود سائن اپ فارم سے دوبارہ شامل ہو سکتا ہے — اس لیے ٹائپ شدہ تصدیق مانگی جاتی ہے۔ خیال رہے کہ Mailchimp کی API کلیدیں اسکوپ نہیں ہوتیں: جو کلید آپ جوڑتے ہیں وہ اکاؤنٹ کی ہر چیز پڑھ اور لکھ سکتی ہے۔

MailerLite#

سبسکرپشن حیثیت، گروپس، سائن اپ کی تاریخ، انگیجمنٹ اور حالیہ مہم کی سرگرمی۔ دو ایکشن: Unsubscribe (قابلِ واپسی — MailerLite کی API دوبارہ سبسکرائب کی حمایت کرتی ہے) اور Resubscribe، تاکہ کسی کو اس کی اپنی درخواست پر فہرست میں واپس ڈالا جا سکے۔

Jira#

گفتگوؤں اور Jira Cloud اِشوز کے درمیان دو طرفہ ربط۔ کارڈ اس گفتگو سے جُڑے اِشوز ان کی موجودہ حیثیت کے ساتھ دکھاتا ہے، اور Create issue (آپ کے چنے ہوئے پراجیکٹ میں درج، خودکار لنک شدہ) نیز پہلے سے موجود اِشوز کے لیے Link existing / Unlink پیش کرتا ہے۔ Jira میں ہونے والی اسٹیٹس تبدیلیاں ویب ہُک سے واپس آتی ہیں: ایپ کا سیٹنگز صفحہ ایک خفیہ ویب ہُک ایڈریس دکھاتا ہے جو آپ اپنی Jira سائٹ میں پیسٹ کرتے ہیں، اور اس کے بعد کارڈ اِشو کی لائیو حیثیت دکھاتا رہتا ہے۔ اِشوز اسی Atlassian اکاؤنٹ کے نام سے بنتے ہیں جو آپ جوڑتے ہیں، اور کارڈ بالکل وہی دیکھتا ہے جو وہ اکاؤنٹ دیکھتا ہے۔

پینل سے چلنے والا ہر ایکشن کردار کی اجازتوں سے مشروط ہے — unsubscribe، resubscribe اور Jira اِشوز کے لیے Use app actions، اور ری فنڈز کے لیے Run refunds and cancellations۔ جہاں ایپ ورک اسپیس سطح کا صلاحیتی ٹوگل بھی دیتی ہے — آج وہ Stripe کا Allow refunds from the conversation panel ہے — وہاں ٹوگل طے کرتا ہے کہ صلاحیت سرے سے موجود ہے یا نہیں، اور اسے بند کرنا سب کو روک دیتا ہے، ورک اسپیس مالک سمیت۔

Tracio: انسان یا بوٹ#

Tracio چیٹ ویجٹ وزیٹر کے بارے میں ایک سوال کا جواب دیتا ہے: یہ انسان ہے یا بوٹ؟ ایپ انسٹال کرنے سے آپ کے Respondo چیٹ ویجٹ کے اندر Tracio کی ڈیٹیکشن SDK فعال ہو جاتی ہے — نئی ویجٹ گفتگوؤں پر فیصلہ خودکار آتا ہے، جو گفتگو پینل میں Tracio کارڈ پر چپ کی صورت دکھتا ہے۔

چپمطلب
HumanTracio کی سرور سائیڈ جانچ کو اس وزیٹر میں بوٹ کے کوئی اشارے نہیں ملے۔
Bot · 93%بوٹ کا پتہ چلا، Tracio کے اعتماد کے ساتھ۔ کارڈ فیصلے کے پیچھے کے اشارے بھی درج کرتا ہے۔
UncheckedTracio کی سرور سائیڈ جانچ ابھی دستیاب نہیں — کارڈ براؤزر کے بتائے فیصلے پر آ جاتا ہے اور یہ بات لکھ دیتا ہے۔
Forged IDبراؤزر کا بھیجا وزیٹر ID Tracio کے لیے اجنبی ہے — دعویٰ جعلی لگتا ہے۔

دو کلیدیں جوڑی جاتی ہیں: پبلک کلید جو ویجٹ میں SDK فعال کرتی ہے، اور خفیہ Data API کلید جو فیصلے کی سرور سائیڈ جانچ کے لیے استعمال ہوتی ہے۔ سرور سائیڈ جانچ کے بغیر براؤزر کے "بوٹ نہیں ہوں" دعوے پر اکیلے بھروسہ نہیں کیا جا سکتا — اور جب براؤزر کا دعویٰ سرور کے فیصلے سے ٹکرائے تو کارڈ دونوں دکھاتا ہے۔

Tracio صرف چیٹ ویجٹ گفتگوؤں کے لیے کام کرتا ہے۔ ای میل، Telegram اور دیگر چینلز میں جانچنے کو کوئی وزیٹر نہیں، اس لیے ان کا Tracio کارڈ بتا دیتا ہے کہ جانچنے کو کچھ نہیں۔ فیصلے کا نہ ہونا شک کی بات نہیں: ایڈ بلاکرز حقیقی انسانوں کی SDK ہر وقت کاٹتے رہتے ہیں، اور Tracio جوڑنے سے پہلے شروع ہوئی پرانی گفتگوؤں پر بھی کوئی فیصلہ نہیں ہوتا۔
Tracio کی SDK آپ کی سائٹ کے وزیٹرز کا فنگر پرنٹ بناتی ہے۔ وزیٹر کی رضامندی لینا (اپنے CMP / کوکی بینر کے ذریعے) سائٹ کے مالک کے طور پر آپ کی ذمہ داری ہے۔

حدود#

  • Stripe اور Shopify کارڈز صرف پڑھنے کے ہیں — پورے Stripe ایپ میں واحد write وہ اختیاری، صراحتاً فعال کیا گیا ری فنڈ ایکشن ہے۔
  • ای میل پر چلنے والی ایپس (Stripe، Shopify، Mailchimp، MailerLite) کو تصدیق شدہ ای میل ایڈریس چاہیے۔ گمنام ویجٹ وزیٹرز یا بغیر ایڈریس والے چینلز کی گفتگوئیں ایماندار "تلاش کے لیے کچھ نہیں" کارڈ دکھاتی ہیں۔
  • Jira کی حمایت صرف Jira Cloud تک ہے۔
  • Mailchimp میں resubscribe نہیں: ایک بار unsubscribe کے بعد صرف وہ شخص خود سائن اپ فارم سے واپس آ سکتا ہے۔ اگر یہ فلو آپ کے لیے اہم ہے تو MailerLite کا resubscribe استعمال کریں۔
  • Tracio کے فیصلے صرف SDK لوڈ ہونے والی ویجٹ گفتگوؤں پر ہوتے ہیں — ای میل یا میسنجر چینلز پر کبھی نہیں۔