کیا آپ ایسا ٹول بناتے ہیں جو ویب سائٹس بناتا یا ہوسٹ کرتا ہے؟ ایک Connect Notiamo بٹن شامل کریں۔ آپ کا صارف اس پر کلک کرتا ہے، Notiamo میں سائن اِن کرتا ہے (یا سائن اپ کرتا ہے)، اور اجازت دیں پر کلک کرتا ہے۔ Notiamo اس کی ویب سائٹ کے لیے ایک پروجیکٹ بناتا ہے اور آپ کے ٹول کو ویجٹ کوڈ دیتا ہے۔ آپ کا ٹول یہ کوڈ ویب سائٹ پر لگا دیتا ہے، یا کاپی کرنے کے لیے دکھاتا ہے۔

آپ کو کیا ملتا ہے

  • آپ کے صارفین آپ کا ٹول چھوڑے بغیر ویب سائٹ فیڈبیک حاصل کرتے ہیں۔
  • آپ کے بٹن سے آنے والے ہر کسٹمر پر آپ کو ان کے پہلے 12 مہینوں کی ادائیگی کا 20% ملتا ہے، ٹیکس کے بغیر۔ مہینے میں ایک بار، جب آپ کے پاس 50 EUR یا زیادہ ہوں، ہم ایک اسٹیٹمنٹ بناتے ہیں؛ آپ ہمیں انوائس بھیجتے ہیں اور ہم آپ کو آپ کی پسند کے مطابق بینک ٹرانسفر، PayPal یا Wise سے ادائیگی کرتے ہیں۔ ادائیگی کی فیس طریقے اور آپ کے بینک پر منحصر ہے، اور آپ ادا کرتے ہیں۔ ادائیگی کی تفصیلات آپ ترتیبات › ریفر کریں اور کمائیں میں شامل کرتے ہیں۔ پارٹنر پروگرام کے اصول لاگو ہوتے ہیں: آپ کو Notiamo کے کسی پیڈ پلان کی ضرورت نہیں، اور کوئی سالانہ حد نہیں ہے۔
  • آپ کا ٹول آپ کے صارفین کے تبصرے یا دوسرے پروجیکٹس کبھی نہیں دیکھتا۔ اسے صرف ایک چیز ملتی ہے: نئے پروجیکٹ کا ویجٹ کوڈ۔

1. پارٹنر بنیں

رابطہ صفحے سے ہمیں لکھیں اور یہ بتائیں:

  • آپ کے ٹول کا نام اور اس کی ویب سائٹ؛
  • آپ کے ٹول کے وہ صفحات جن پر بٹن دکھے گا (درست پتے، مثلاً https://app.builder.example)؛
  • آپ کا Notiamo ادارہ (آپ کی اسٹیٹمنٹس اور ادائیگی کی تفصیلات وہیں ہیں؛ مفت اکاؤنٹ کافی ہے)۔

ہم آپ کو ایک app id بھیجتے ہیں۔ آپ اسے بٹن میں ڈالتے ہیں۔

2. بٹن شامل کریں

اسکرپٹ ایک بار لوڈ کریں، پھر اپنے app id اور اس ویب سائٹ کے پتے کے ساتھ ایک بٹن شامل کریں جو آپ کا صارف بنا رہا ہے:

<script src="https://my.notiamo.com/connect/v1.js" defer></script>

<button data-notiamo-connect
        data-client="YOUR_APP_ID"
        data-site="https://shop.example"
        data-name="Shop">
  Connect Notiamo
</button>

کام ہو جانے پر، بٹن ویجٹ کوڈ کے ساتھ ایک notiamo:connected ایونٹ بھیجتا ہے:

const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
  const { snippet, projectId } = event.detail;
  saveToTheHead(snippet); // your tool puts it in the website's <head>
});
button.addEventListener("notiamo:cancelled", () => { /* the user closed the window or clicked Deny */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));

اگر آپ کا ٹول ویب سائٹ کا کوڈ نہیں بدل سکتا، تو data-mode="copy" شامل کریں۔ پھر Notiamo کوڈ کو ایک چھوٹی ونڈو میں کاپی کریں بٹن کے ساتھ دکھاتا ہے۔

3. یا اپنے کوڈ سے کال کریں

const result = await Notiamo.connect({
  clientId: "YOUR_APP_ID",
  site: "https://shop.example",
  name: "Shop",          // optional: the project name, else the website's address
  mode: "return",        // or "copy"
});
if (result.status === "connected") {
  // result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}

Notiamo.connect() کو کسی کلک سے کال کریں۔ براؤزر بعد میں کھلنے والی ونڈوز کو روک دیتے ہیں۔

آپ کا صارف کیا دیکھتا ہے

  1. Notiamo کی ایک چھوٹی ونڈو کھلتی ہے۔
  2. اگر وہ سائن اِن نہیں ہیں، تو اپنی ای میل لکھتے ہیں۔ سائن اِن لنک دوسرے ٹیب میں کھلتا ہے؛ ونڈو اسے پہچان لیتی ہے اور خود ہی آگے بڑھ جاتی ہے۔ نئے صارفین اسی ونڈو میں سائن اپ کرتے ہیں۔
  3. اجازت دیں صفحہ بتاتا ہے کہ آپ کا ٹول ان کی ویب سائٹ میں Notiamo شامل کرنا چاہتا ہے۔ وہ ادارہ اور ورک اسپیس چنتے ہیں، اور اجازت دیں (یا مسترد کریں) پر کلک کرتے ہیں۔
  4. ونڈو بند ہو جاتی ہے۔ آپ کے صفحے کو ویجٹ کوڈ مل جاتا ہے۔

پلان کی حدیں ڈیش بورڈ کی طرح ہی لاگو ہوتی ہیں۔ نئے مفت اکاؤنٹ میں پہلے سے ایک پروجیکٹ ہوتا ہے: Notiamo دوسرا بنانے کے بجائے وہی پروجیکٹ ویب سائٹ کے لیے استعمال کرتا ہے۔

سیکیورٹی

  • صرف پارٹنر ایپس ہی اس طرح پروجیکٹ بنا سکتی ہیں۔ کوڈ صرف ان صفحات کو ملتا ہے جو آپ نے ہمیں دیے: ونڈو اسے ان کے درست پتے پر بھیجتی ہے، کہیں اور نہیں۔
  • اسکرپٹ ہر کلک کے لیے PKCE اور ایک رینڈم state استعمال کرتا ہے۔ رسائی صرف پڑھنے کی ہے، اسی ایک نئے پروجیکٹ تک محدود ہے، اور اسکرپٹ کے ویجٹ کوڈ پڑھتے ہی ختم ہو جاتی ہے۔
  • Notiamo کے صفحات کبھی کسی فریم کے اندر لوڈ نہیں ہوتے۔ اسی لیے بٹن ایک ونڈو کھولتا ہے۔

سرور سائیڈ ٹولز

اگر آپ کا ٹول اپنے سرور پر کام مکمل کرتا ہے، تو ہمیں اس کا ری ڈائریکٹ پتا بھی دیں۔ اپنے صارفین کو https://my.notiamo.com/oauth/authorize پر بھیجیں، ساتھ میں response_type=code، client_id کے طور پر اپنا app id، اپنا redirect_uri، ایک PKCE code_challenge (S256)، ایک state، اور connect_site (ویب سائٹ)۔ https://my.notiamo.com/api/oauth/token پر کوڈ بدلیں، پھر ایکسیس ٹوکن کے ساتھ GET https://my.notiamo.com/api/connect/project پڑھیں۔ جواب میں snippet، projectId، publicKey، site اور dashboardUrl ہوتے ہیں۔

سوالات

رابطہ صفحے سے ہمیں لکھیں۔ بٹن لانچ کرنے سے پہلے ہم اسے ٹیسٹ کرنے میں آپ کی مدد کرتے ہیں۔