مستندات

شروع سریع

ویجت چت Respondo را در کمتر از 2 دقیقه به سایتتان اضافه کنید.

اسکریپت را اضافه کنید

این قطعه‌کد را پیش از </body> در هر صفحه‌ای که ویجت را می‌خواهید بگذارید:

HTML
<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 را با مقدارهای تنظیمات کانالتان جایگزین کنید — یا قطعه‌کد آمادهٔ صفحهٔ کانال را کپی کنید که این مقدارها در آن پر شده‌اند.

کاربران را شناسایی کنید (توصیه‌شده)

پس از ورود کاربر، identify() را صدا بزنید تا نشست‌های چت به پروفایل او وصل شود:

JavaScript
Respondo.identify({
  email: 'user@example.com',
  name: 'John Doe',
  userId: 'usr_12345',       // your internal user ID
  metadata: {                // any custom fields
    plan: 'premium',
    company: 'Acme Inc'
  },
  properties: {              // custom contact properties (defined in Agent Settings)
    account_type: 'enterprise',
    region: 'eu-west'
  }
});

تمام!

ویجت در گوشهٔ پایین-راست ظاهر می‌شود. همهٔ گفت‌وگوها به‌طور خودکار وارد داشبورد Conversations شما می‌شوند.