انت بتعمل أداة بتبني مواقع أو بتستضيفها؟ ضيف زرار 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); // 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 عمرها ما بتتحمّل جوه فريم. عشان كده الزرار بيفتح شباك.
أدوات على السيرفر
لو أداتك بتكمّل على السيرفر بتاعها، ادّينا عنوان الـ redirect بتاعها كمان. ابعت المستخدمين بتوعك لـ 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 بالـ access token. الرد فيه snippet وprojectId وpublicKey وsite وdashboardUrl.
أسئلة
ابعتلنا من صفحة التواصل. هنساعدك تجرّب الزرار قبل ما تطلقه.