تركيب المحادثة على موقعكPut the chat on your website
آخر تحديث: Last updated:
بكلمات بسيطةIn plain words
- تضيف سطر سكربت واحدًا إلى موقعك فتظهر المحادثة. يعمل على أي موقع يسمح بإضافة سكربت.
- تطبيق سلة وتطبيق شوبيفاي قيد التجهيز، ولم ينزلا في متاجر التطبيقات بعد.
- على متجرك أن يذكر في سياسة خصوصيته ثلاثة أشياء: أن ذكاءً اصطناعيًا يجيب، ومن يعالج الرسائل، وأن الموقع التقريبي يُقدَّر. فيه نص جاهز تنسخه.
- You add one line of script to your website and the chat appears. It works on any site that lets you add a script.
- The Salla app and the Shopify app are in the works and aren't in the app stores yet.
- Your store should say three things in its privacy policy: that an AI answers, who processes the messages, and that approximate location is estimated. There's ready text to copy.
السطر الواحدThe one line
سجّل الدخول إلى لوحة التحكم وافتح «الإعدادات» ثم «تثبيت أداة المحادثة»، وانسخ السطر هناك. فيه مفتاح متجرك. شكله هكذا:
<script src="https://your-mudheef-address/widget.js" data-mudheef-key="YOUR_WIDGET_KEY" defer></script>الصق السطر قبل إغلاق وسم </body> في كل صفحات متجرك. مفتاح المتجر ليس سرًّا، فهو يظهر في كود موقعك، ويسمح فقط بإجراءات المحادثة.
Sign in to the dashboard, open "Settings" then "Install the chat", and copy the line there. It carries your store's key. It looks like this:
<script src="https://your-mudheef-address/widget.js" data-mudheef-key="YOUR_WIDGET_KEY" defer></script>Paste it before the closing </body> tag on every page of your store. The store key isn't a secret: it shows in your site's code, and it only allows chat actions.
أين تلصقهWhere to paste it
- شوبيفاي: Online Store → Themes → Edit code → theme.liquid، قبل </body>.
- سلة وزد ووردبريس/ووكومرس وويكس وغيرها: في المكان الذي تعطيك منصتك لإضافة كود مخصص في تذييل الصفحات، ويسمى عادةً «كود مخصص» أو «سكربتات التذييل» أو «كود التتبع».
- موقع بنيته بنفسك: في القالب المشترك بين الصفحات.
تطبيق سلة سيركّب السطر بنفسه حين ينزل في متجر التطبيقات. وتستطيع من «الإعدادات» تغيير جهة الزر، ورفعه فوق شريط السلة، وإخفاءه في صفحة الدفع.
- Shopify: Online Store → Themes → Edit code → theme.liquid, before </body>.
- Salla, Zid, WordPress/WooCommerce, Wix and others: in the place your platform gives you for custom code in the page footer, usually called "custom code", "footer scripts" or "tracking code".
- A site you built yourself: in the template all pages share.
The Salla app will install the line itself once it is in the app store. And from "Settings" you can change the side of the button, lift it above a sticky cart bar, and hide it on the checkout page.
ما تكتبه في سياسة خصوصية متجركWhat to say in your store's privacy policy
أنت المسؤول عن بيانات عملائك، و«مضيف» يعالجها نيابةً عنك. فأضف إلى سياسة خصوصية متجرك ثلاثة أشياء:
- أن مساعدًا ذكيًا يجيب العملاء. والمحادثة تعلّم عميلك بذلك بعلامة «مساعد ذكي» على كل رد.
- من يعالج الرسائل. يرسل «مضيف» رسالة العميل والصفحة التي هو فيها ومحتوى سلته إلى مزوّدين، أبرزهم Anthropic (الذكاء الاصطناعي) وVercel وNeon (الاستضافة وقاعدة البيانات في فرانكفورت)، وMeta إن ربطت واتساب أو إنستغرام أو ماسنجر. القائمة الكاملة في سياسة خصوصية «مضيف».
- أن الموقع التقريبي يُقدَّر. يقدّر مزوّد الاستضافة الدولة والمدينة من اتصال العميل. لا نحفظ عنوان IP، وتحفظ المحادثة في متصفح العميل معرّفًا عشوائيًا بالتخزين المحلي دون ملفات تعريف ارتباط.
نص جاهز تنسخه وتعدّله:
«نستخدم مساعدًا ذكيًا من "مضيف" للإجابة عن أسئلتكم في موقعنا. تُرسل رسالتكم والصفحة التي تتصفحونها ومحتوى سلتكم إلى "مضيف" ومزوّديها (ومنهم Anthropic وVercel وNeon) لكتابة الرد، ويُقدَّر موقعكم التقريبي (الدولة والمدينة) من اتصالكم. قد يقرأ فريقنا المحادثة ويتولاها. لطلب نسخة من بياناتكم أو حذفها، تواصلوا معنا.»
وإن أرسلت رسائل تسويقية، فاحصل على موافقة العميل أولًا. وإن كان متجرك يبيع لمن هم دون سن الرشد فاحصل على موافقة أولياء أمورهم.
You are responsible for your shoppers' data, and Mudheef handles it on your behalf. So add three things to your store's privacy policy:
- That an AI assistant answers shoppers. The chat already tells your shopper, with an "AI assistant" label on every reply.
- Who processes the messages. Mudheef sends the shopper's message, the page they are on and what is in their cart to providers, mainly Anthropic (the AI), and Vercel and Neon (hosting and database, in Frankfurt), and Meta if you connect WhatsApp, Instagram or Messenger. The full list is in Mudheef's privacy policy.
- That approximate location is estimated. The hosting provider estimates the country and city from the shopper's connection. We don't store the IP address, and the chat keeps a random id in the shopper's browser using local storage, without cookies.
Ready text to copy and adjust:
"We use an AI assistant from Mudheef to answer your questions on our website. Your message, the page you are browsing and what is in your cart are sent to Mudheef and its providers (including Anthropic, Vercel and Neon) to write the reply, and your approximate location (country and city) is estimated from your connection. Our team may read the chat and take it over. To ask for a copy of your data or for it to be deleted, contact us."
And if you send marketing messages, get the shopper's consent first. If your store sells to minors, get a parent's or guardian's consent.
تأكد أنه يعملCheck that it works
- افتح موقعك في نافذة خاصة بالمتصفح، فتظهر أيقونة المحادثة.
- اكتب سؤالًا عن منتج، وتأكد أن الرد يحمل علامة «مساعد ذكي».
- افتح «صندوق الوارد» في لوحة التحكم وتأكد أن المحادثة ظهرت فيه.
- جرّب أيضًا من الجوال.
إن لم تظهر الأيقونة، تأكد أن السطر كامل قبل </body>، وأن الصفحة ليست مخفية في «الإعدادات» تحت «إخفاء في هذه الصفحات»، ثم اكتب لنا من صفحة الدعم.
- Open your website in a private browser window and the chat icon appears.
- Type a question about a product, and check that the reply carries an "AI assistant" label.
- Open the "Inbox" in the dashboard and check that the chat shows up there.
- Try it on a phone too.
If the icon doesn't appear, check that the line is complete and sits before </body>, that the page isn't hidden under "Hide on these pages" in "Settings", and then write to us from the support page.
إزالة المحادثةRemoving the chat
احذف السطر من موقعك فتختفي المحادثة. ولحذف بياناتك من «مضيف» اتبع صفحة حذف البيانات.
Delete the line from your website and the chat disappears. To delete your data from Mudheef, follow the data deletion page.