क्या आप ऐसा टूल बनाते हैं जो वेबसाइट बनाता या होस्ट करता है? एक 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() को किसी क्लिक से कॉल करें। ब्राउज़र बाद में खुलने वाली विंडो को रोक देते हैं।
आपके यूज़र को क्या दिखता है
- Notiamo की एक छोटी विंडो खुलती है।
- अगर वे साइन इन नहीं हैं, तो अपना ईमेल लिखते हैं। साइन-इन लिंक दूसरे टैब में खुलता है; विंडो इसे पहचान लेती है और अपने आप आगे बढ़ जाती है। नए यूज़र उसी विंडो में साइन अप करते हैं।
- अनुमति दें पेज बताता है कि आपका टूल उनकी वेबसाइट में Notiamo जोड़ना चाहता है। वे संगठन और वर्कस्पेस चुनते हैं, और अनुमति दें (या अस्वीकार करें) पर क्लिक करते हैं।
- विंडो बंद हो जाती है। आपके पेज को विजेट कोड मिल जाता है।
प्लान की सीमाएँ डैशबोर्ड की तरह ही लागू होती हैं। नए फ़्री अकाउंट में पहले से एक प्रोजेक्ट होता है: 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 होते हैं।
सवाल
संपर्क पेज से हमें लिखें। बटन लॉन्च करने से पहले हम उसे टेस्ट करने में आपकी मदद करते हैं।