هل تصنع أداة تبني المواقع أو تستضيفها؟ أضف زر Connect Notiamo. ينقر المستخدم عليه، ويسجّل الدخول إلى Notiamo (أو ينشئ حسابًا)، ثم ينقر على سماح. ينشئ Notiamo مشروعًا لموقعه ويعطي أداتك شيفرة الودجت. تضع أداتك الشيفرة في الموقع، أو تعرضها لنسخها.

ما الذي تحصل عليه

  • يحصل مستخدموك على ملاحظات حول مواقعهم دون مغادرة أداتك.
  • كل عميل يأتي عبر زرك يكسبك 20% مما يدفعه، دون الضريبة، خلال أول 12 شهرًا. مرة كل شهر، عندما يصبح لديك 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); // تضعها أداتك في <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",          // اختياري: اسم المشروع، وإلا فعنوان الموقع
  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، وapp id الخاص بك في client_id، وredirect_uri الخاص بك، وcode_challenge من PKCE (S256)، وstate، وconnect_site (الموقع). استبدل الرمز عبر https://my.notiamo.com/api/oauth/token، ثم اقرأ GET https://my.notiamo.com/api/connect/project باستخدام رمز الوصول. يحتوي الرد على snippet وprojectId وpublicKey وsite وdashboardUrl.

أسئلة

راسلنا من صفحة الاتصال. نساعدك على اختبار الزر قبل إطلاقه.