التوثيق

البدء السريع

أضف أداة الدردشة Respondo إلى موقعك في أقل من دقيقتين.

1

أضف السكربت

الصق هذا المقتطف قبل </body> في كل صفحة تريد ظهور الأداة فيها:

HTMLhtml
<script>
  window.Respondo = window.Respondo || {};
  Respondo.init = Respondo.init || function(c) { window.RespondoAIConfig = c; };
  Respondo.q = Respondo.q || [];
  Respondo.identify = Respondo.identify || function(d) { Respondo.q.push(['identify', d]); };
  Respondo.init({
    agentId: 'YOUR_AGENT_ID',
    channelId: 'YOUR_CHANNEL_ID'
  });
</script>
<script src="https://api.respondo.ai/widget/widget.js" async></script>
استبدل YOUR_AGENT_ID و YOUR_CHANNEL_ID بمعرّف الوكيل (Agent ID) ومعرّف القناة (Channel ID) من إعدادات قناتك (أو انسخ المقتطف الجاهز المعبّأ مسبقاً من صفحة القناة). تُحمَّل الأداة بشكل غير متزامن ولن تؤثر على أداء الصفحة.

تستخدم إطار عمل؟#

نفس الأداة، مدمجة في حزمتك التقنية — اختر تبويباً:

اعرض هذا المكوّن مرة واحدة، قريباً من جذر تطبيقك:

Reacttsx
// respondo-widget.tsx — render once, near the root of your app
import { useEffect } from 'react';

export function RespondoWidget() {
  useEffect(() => {
    const w = window as any;
    w.Respondo = w.Respondo || {};
    w.Respondo.init = w.Respondo.init || function (c) { w.RespondoAIConfig = c; };
    w.Respondo.q = w.Respondo.q || [];
    w.Respondo.identify = w.Respondo.identify || function (d) { w.Respondo.q.push(['identify', d]); };
    if (!document.querySelector('script[data-respondo]')) {
      w.Respondo.init({
        agentId: 'YOUR_AGENT_ID',
        channelId: 'YOUR_CHANNEL_ID'
      });
      const s = document.createElement('script');
      s.src = 'https://api.respondo.ai/widget/widget.js';
      s.async = true;
      s.dataset.respondo = '1';
      document.body.appendChild(s);
    }
  }, []);

  return null;
}
استبدل YOUR_AGENT_ID / YOUR_CHANNEL_ID بالقيم من إعدادات قناتك — أو انسخ المقتطف الجاهز من صفحة القناة، حيث تكون معبّأة بالفعل.
2

تعريف المستخدمين (موصى به)

بعد تسجيل دخول المستخدم، استدعِ identify() لربط جلسات الدردشة بملفه الشخصي:

JavaScriptjavascript
Respondo.identify({
  email: 'user@example.com',
  name: 'John Doe',
  userId: 'usr_12345',       // معرّف المستخدم الداخلي لديك
  metadata: {                // أي حقول مخصصة
    plan: 'premium',
    company: 'Acme Inc'
  },
  properties: {              // خصائص جهة اتصال مخصصة (معرّفة في إعدادات الوكيل)
    account_type: 'enterprise',
    region: 'eu-west'
  }
});

تمّ!

ستظهر الأداة في الزاوية السفلية اليمنى. تتدفق كل المحادثات تلقائياً إلى لوحة تحكّم المحادثات لديك.