ڈیش بورڈ میں ویب ویجیٹ بنائیں
ویب ویجٹس صفحہ (/dashboard/web-widgets) قابلِ اشاعت کلیدیں بناتا اور ان کا نظم کرتا ہے جو ThunderPhone کے ایمبیڈ کیے جانے والے وائس ویجٹ کو چلاتی ہیں۔
اس گائیڈ کا API ورژن جو کچھ cURL کے ذریعے کرتا ہے، یہ صفحہ وہی کام ایک فارم کے ذریعے کرتا ہے — اور آپ کے لیے ایمبیڈ کوڈ بھی تیار کرتا ہے۔
ویجٹ بنائیں
- نیا ویجٹ پر کلک کریں اور موڈ منتخب کریں
- ایجنٹ موڈ — ویجٹ ہمیشہ ڈراپ ڈاؤن سے آپ کے منتخب کردہ ایک ایجنٹ کو چلاتا ہے۔ سب سے آسان سیٹ اپ۔
- ویب ہک موڈ — ہر ویجٹ سیشن پر، ThunderPhone آپ کے ویب ہک URL کو کال کرتا ہے اور آپ کا سرور اس وزیٹر کے لیے ایجنٹ کنفیگریشن واپس کرتا ہے (ہر صفحے کے لیے روٹنگ، لاگ اِن صارفین، رول آؤٹس)۔ اپنی تنظیم کا ڈیفالٹ ویب ہک استعمال کرنے کے لیے URL خالی چھوڑ دیں؛ جب آپ نیا URL درج کرتے ہیں تو اسے تنظیم کے ڈیفالٹ کے طور پر بھی سیٹ کر سکتے ہیں۔
- اجازت یافتہ ڈومینز درج کریں
قابلِ اشاعت کلیدیں اوریجن سے مقفل ہوتی ہیں: کم از کم ایک ڈومین درکار ہے، اور ویجٹ صرف ان ہوسٹ نیمز پر کام کرتا ہے جو آپ درج کرتے ہیں۔ ذیلی ڈومین وائلڈ کارڈز، جیسے
*.example.com، کی اجازت ہے (یہ ذیلی ڈومینز سے ملتے ہیں، بنیادی ڈومین سے نہیں)؛ بنیادی وائلڈ کارڈز، جیسے*، مسترد کر دیے جاتے ہیں۔localhostاور127.0.0.1کی ہمیشہ اجازت ہوتی ہے، اس لیے مقامی ڈیولپمنٹ انہیں درج کیے بغیر کام کرتی ہے۔ - نام دیں، فعال کریں، بنائیں
ویجٹ فعال کریں ٹوگل یہ کنٹرول کرتا ہے کہ کلید سیشنز قبول کرتی ہے یا نہیں — آپ ویجٹ کو غیر فعال حالت میں بنا سکتے ہیں اور لانچ کے وقت اسے فعال کر سکتے ہیں۔
ایمبیڈ کوڈ حاصل کریں
بنانے کے فوراً بعد (یا ہر قطار کے ایمبیڈ بٹن کے ذریعے)، ایک ایمبیڈ ڈائیلاگ آپ کی قابلِ اشاعت کلید کے ساتھ پیسٹ کرنے کے لیے تیار کوڈ بناتا ہے:
- React — بنڈلر ایپس کے لیے ایک
<ThunderPhoneWidget />اسنیپٹ۔ - اسکرپٹ ٹیگ — کسی بھی سائٹ کے لیے CDN
<script>اور اسٹائل شیٹ کا جوڑا۔
ڈائیلاگ بنیادی ظاہری آپشنز کا پیش نظارہ بھی دکھاتا ہے — عنوان، بنیادی رنگ، کونے کی پوزیشن، اور روشن/گہرا تھیم — اور آپ کے انتخاب کو اسنیپٹ میں شامل کر دیتا ہے۔ مکمل prop حوالہ، اسٹائلنگ ہکس، اور ہیڈ لیس آپشن کے لیے ویجٹ SDK دستاویزات دیکھیں۔
فہرست سے ویجٹس کا نظم کریں
ہر قطار اپنی جگہ پر ترمیم ہوتی ہے:
- موڈ / ایجنٹ — اِن لائن سلیکٹس کے ذریعے ایجنٹ اور ویب ہک موڈ کے درمیان تبدیل کریں، یا ایجنٹ کو دوبارہ مقرر کریں۔
- ڈومینز — چپس کے طور پر اجازت یافتہ ڈومینز شامل کریں یا ہٹائیں۔
- فعال/غیر فعال — ہر ویجٹ کے لیے ایک سوئچ؛ غیر فعال ویجٹس فوراً سیشنز قبول کرنا بند کر دیتے ہیں۔
- تنظیم میں منتقل کریں — ویجٹ کو کسی دوسری تنظیم میں کاپی یا منتقل کریں جس سے آپ وابستہ ہیں (منتقل کرنے سے یہ یہاں سے ہٹ جاتا ہے)۔
- حذف کریں — قابلِ اشاعت کلید منسوخ ہو جاتی ہے؛ ویجٹ تمام ڈومینز پر فوراً کام کرنا بند کر دیتا ہے۔ اسے واپس نہیں کیا جا سکتا۔
ویجٹ سیشنز کال ہسٹری میں فون کالز جیسے ہی ٹرانسکرپٹ، ریکارڈنگ، اور گریڈنگ کے ساتھ ظاہر ہوتے ہیں۔