دوسرے پروگرام جوڑیں: API، webhooks اور Slack یا Teams الرٹس

انضمام (سیٹنگز کے تحت) میں آپ Kaam360 کو دوسرے پروگراموں سے جوڑ سکتے ہیں۔ یہ Business پیکج کا حصہ ہے۔ صرف منتظمین اسے کھول سکتے ہیں۔

API کی سے اپنا ڈیٹا پڑھیں

1. سیٹنگز کھولیں اور انضمام منتخب کریں۔
2. API کلیدیں کے تحت ایک نام لکھیں (مثلاً Zapier یا اکاؤنٹنگ شیٹ) اور API کلید بنائیں دبائیں۔
3. ظاہر ہونے والی کی نقل کریں۔ یہ صرف ایک بار دکھائی جاتی ہے۔ جس کے پاس کی ہو وہ آپ کے ادارے کا سارا ڈیٹا پڑھ سکتا ہے، اس لیے اسے خفیہ رکھیں۔
4. کی پروگرام کو دیں۔ وہ اسے Authorization: Bearer ... ہیڈر میں بھیجتا ہے۔ API کا استعمال حصہ پتے اور مثال دکھاتا ہے۔
5. کی صرف پڑھ سکتی ہے، جب تک کہ آپ اسے بناتے وقت اس کلید کو لیڈز شامل کرنے کی اجازت دیں نشان زد نہ کریں۔ تب یہ نئی لیڈز بھی شامل کر سکتی ہے۔ یہ کبھی کچھ اور بدل یا حذف نہیں کر سکتی۔ کی کو فوراً روکنے کے لیے منسوخ کریں دبائیں۔ جس شخص نے کی بنائی ہو، اسے صارفین میں بند کرنے پر کی بھی کام کرنا چھوڑ دیتی ہے؛ کسی دوسرے ایڈمنسٹریٹر کے اکاؤنٹ سے نئی کی بنائیں۔

Zapier یا Make استعمال کریں

Zapier اور Make بغیر کوڈنگ کے پروگرام جوڑتے ہیں۔ آپ کو Kaam360 کی کسی خاص ایپ کی ضرورت نہیں۔

1. اوپر کی طرح API کی بنائیں۔ اگر آپ چاہتے ہیں کہ فارم، اشتہارات یا شیٹس Kaam360 میں لیڈز بھیجیں تو اس کلید کو لیڈز شامل کرنے کی اجازت دیں نشان زد کریں۔
2. Zapier یا Make میں ویب پتہ کال کرنے والا قدم منتخب کریں (Zapier میں: Webhooks by Zapier؛ Make میں: HTTP)۔ اپنی کی کے ساتھ Authorization: Bearer ... ہیڈر استعمال کریں۔
3. ڈیٹا پڑھنے کے لیے API کا استعمال میں دیے پتے کال کریں (مثلاً /api/v1/leads یا /api/v1/deals)۔ لیڈ شامل کرنے کے لیے /api/v1/leads پر لیڈ کے آخری نام یا ای میل کے ساتھ POST بھیجیں۔
4. API کا استعمال /api/v1/openapi.json سے بھی جڑا ہے، یعنی پوری API کی تفصیل۔ نئی API (ورژن 2) سمیت مکمل ڈویلپر گائیڈ /developers پر ہے۔
5. کچھ ہونے کی خبر پانے کے لیے webhooks میں کوئی اور پروگرام (دستخط شدہ JSON) استعمال کریں۔

Slack یا Microsoft Teams میں الرٹس پائیں

1. Slack یا Teams میں مطلوبہ چینل کے لیے incoming webhook بنائیں اور اس کا ویب پتہ نقل کریں۔
2. انضمام میں ویب ہکس اور چیٹ الرٹس کے تحت نام لکھیں، Slack کا ایک چینل یا Microsoft Teams کا ایک چینل منتخب کریں، اور ویب پتہ چسپاں کریں۔
3. اسے بتائیں جب کے تحت جو جاننا چاہیں نشان زد کریں۔ سب کچھ جاننے کے لیے کچھ نشان زد نہ کریں۔
4. پتہ شامل کریں دبائیں، پھر ٹیسٹ بھیجیں۔ چینل میں ایک مختصر آزمائشی پیغام آنا چاہیے۔

کسی اور پروگرام کو بتائیں

1. کوئی اور پروگرام (دستخط شدہ JSON) منتخب کریں اور اس کا ویب پتہ لکھیں۔ یہ https:// سے شروع ہو اور عوامی انٹرنیٹ پر ہو۔
2. ظاہر ہونے والا دستخطی راز نقل کریں۔ یہ صرف ایک بار دکھایا جاتا ہے۔ دوسرا پروگرام اس سے جانچتا ہے کہ پیغام واقعی Kaam360 سے آیا ہے۔
3. ہر پیغام JSON ہے جس میں ایک آئی ڈی، واقعے کا نام، مختصر خلاصہ اور اہم تفصیلات ہوتی ہیں۔ مکمل ریکارڈ کے لیے API استعمال کریں۔
4. ہر پیغام دستخط شدہ ہوتا ہے: ہیڈر X-Kaam360-Signature میں بھیجنے کے وقت (X-Kaam360-Timestamp) اور پیغام کا HMAC-SHA256 ہوتا ہے۔ وصول کنندہ کو پانچ منٹ سے پرانا پیغام رد کرنا چاہیے، تاکہ نقل شدہ پیغام بعد میں دوبارہ نہ بھیجا جا سکے۔ ڈویلپر گائیڈ میں اس جانچ کے لیے تیار کوڈ ہے۔
5. پتہ، اس کے واقعات یا نوٹ بدلنے کے لیے ترمیم دبائیں۔ اگر راز ظاہر ہو گیا ہو تو نیا دستخطی راز دبائیں: پرانا فوراً کام کرنا بند کر دیتا ہے، اس لیے نیا راز فوراً دوسرے پروگرام کو دیں۔

آپ کن چیزوں کی خبر پا سکتے ہیں

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

ترسیل کا ریکارڈ

ترسیل کا ریکارڈ پچھلے دو ہفتوں کا ہر پیغام دکھاتا ہے: کب بھیجا گیا، کس پتے پر، وصول کنندہ کا جواب (اسٹیٹس کوڈ اور لگا وقت) اور نتیجہ۔

1. صرف وہی دیکھنے کے لیے کوئی پتہ، نتیجہ (پہنچ گئیں، دوبارہ کوشش کا انتظار، ترک کر دیا) یا واقعہ منتخب کریں۔
2. پیغام اور وصول کنندہ کے جواب کا آغاز دیکھنے کے لیے جو بھیجا گیا وہ دکھائیں دبائیں۔
3. پہنچا ہوا یا چھوڑا ہوا پیغام دوبارہ بھیجنے کے لیے دوبارہ بھیجیں دبائیں۔ اس کی آئی ڈی وہی رہتی ہے تاکہ وصول کنندہ پہچان سکے کہ یہ تکرار ہے۔

اگر کچھ غلط ہو

• اگر وصول کنندہ بند ہو تو Kaam360 ایک منٹ، 5 منٹ، 30 منٹ، 2 گھنٹے اور 12 گھنٹے بعد دوبارہ کوشش کرتا ہے، پھر چھوڑ دیتا ہے۔
• جو پتہ لگاتار 15 بار ناکام ہو وہ بند کر دیا جاتا ہے، اور انضمام کا انتظام کرنے والے سب لوگوں کو ای میل جاتی ہے۔ صفحے پر سرخ نوٹ بتاتا ہے کہ یہ کب ہوا۔ مسئلہ حل کریں، جاری کریں دبائیں، پھر رہ جانے والے پیغامات ترسیل کا ریکارڈ سے دوبارہ بھیجیں۔
• نجی نیٹ ورک کے اندر کے پتے (جیسے localhost، 10.0.0.1 یا 192.168.1.5) کی اجازت نہیں، اور ہر بار بھیجتے وقت دوبارہ جانچے جاتے ہیں۔
• اگر آپ کو انضمام نظر نہ آئے تو شاید آپ کے پیکج میں یہ شامل نہیں، یا آپ کے کردار کے پاس انٹیگریشنز کا انتظام کا اختیار نہیں۔