مستندات

شروع سریع

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

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',       // 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 شما می‌شوند.