আপনি কি এমন একটি টুল বানান যা ওয়েবসাইট তৈরি বা হোস্ট করে? একটি Connect Notiamo বাটন যোগ করুন। আপনার ইউজার এতে ক্লিক করেন, Notiamo-তে সাইন ইন করেন (বা সাইন আপ করেন), আর অনুমতি দিন-এ ক্লিক করেন। Notiamo তাঁর ওয়েবসাইটের জন্য একটি প্রজেক্ট তৈরি করে আর আপনার টুলকে উইজেট কোড দেয়। আপনার টুল কোডটি ওয়েবসাইটে বসিয়ে দেয়, অথবা কপি করার জন্য দেখায়।

আপনি কী পান

  • আপনার ইউজাররা আপনার টুল না ছেড়েই ওয়েবসাইট ফিডব্যাক পান।
  • আপনার বাটন দিয়ে আসা প্রতিটি গ্রাহকের জন্য আপনি পান তাঁদের প্রথম ১২ মাসে দেওয়া অর্থের ২০%, ট্যাক্স ছাড়া। মাসে একবার, আপনার ৫০ 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।

প্রশ্ন

যোগাযোগ পেজ থেকে আমাদের লিখুন। বাটন চালু করার আগে আমরা আপনাকে তা পরীক্ষা করতে সাহায্য করি।