مستندات

JavaScript API

متدهای سراسری که پس از بارگذاری اسکریپت ویجت در دسترس‌اند.

Respondo.init(config)

ویجت را مقداردهی اولیه و سوار می‌کند. باید یک بار فراخوانی شود. نمونهٔ ویجت را برمی‌گرداند.

const widget = Respondo.init({
  agentId: 'YOUR_AGENT_ID'
});

Respondo.identify(identity)

هویت کاربر را به نشست جاری می‌چسباند. پس از ورود کاربر فراخوانی کنید. با ایمیل یا userId مخاطب را بی‌درنگ می‌سازد، حتی اگر کاربر هرگز گفت‌وگو را باز نکند. signedUpAt (یک Date، ثانیه‌های Unix یا رشتهٔ ISO 8601) زمان ثبت‌نام کاربر در محصول شماست؛ بدون آن تاریخ ثبت‌نام مخاطب خالی می‌ماند.

Respondo.identify({
  email: 'user@example.com',
  name: 'John Doe',
  userId: 'usr_123',
  signedUpAt: '2024-05-31T10:00:00Z',
  userHash: 'hmac_sha256_signature', // اختیاری، برای راستی‌آزمایی هویت
  metadata: { plan: 'pro' },
  properties: {                      // ویژگی‌های سفارشی مخاطب
    account_type: 'enterprise',      // کلیدها در تنظیمات عامل تعریف می‌شوند
    region: 'eu-west'
  }
});

Respondo.track(name, properties?)

رویدادی سمت کلاینت برای بازدیدکنندهٔ جاری ثبت می‌کند (مثلاً خرید، ارتقای پلن). رویدادها می‌توانند تورهای رویدادمحور را آغاز کنند و در هدف تورها شمرده شوند. تحویل best-effort با keepalive انجام می‌شود، پس رویدادهایی که درست پیش از ناوبری (ریدایرکت پرداخت) شلیک می‌شوند هم می‌رسند. پس از init() فراخوانی کنید.

رویدادها نظرسنجی‌های پاپ‌آپی را که منتظرشان هستند هم باز می‌کنند (When and where): بی‌درنگ در صفحه‌ای منطبق، یا هنگام رسیدن به چنین صفحه‌ای ظرف ۳۰ دقیقه، مثلاً پس از یک ریدایرکت.

Respondo.track('purchase_completed', {
  plan: 'pro',
  amount: 49
});

Respondo.startSurvey(surveyId)

یک نظرسنجی پاپ‌آپ فعال را همین حالا در هر صفحه‌ای باز می‌کند و Show on، قوانین صفحه، زمان ماندن در صفحه، رویداد محرک و مخاطبان را نادیده می‌گیرد. شناسه را از ویرایشگر نظرسنجی کپی کنید (Additional ways to share). نظرسنجی‌ای که بازدیدکننده قبلاً پاسخ داده دوباره نمایش داده نمی‌شود. پیش از پایان بارگذاری ویجت هم می‌توان آن را فراخواند.

Respondo.startSurvey('<survey-id>');

Respondo.open(message?) / Respondo.close()

پنجرهٔ گفت‌وگو را از دکمه‌های خودتان باز یا بسته می‌کند. رشته‌ای به open بدهید تا کادر پیام از پیش پر شده باز شود. پس از Respondo.init() فراخوانی کنید؛ فراخوانی‌ای که هنگام ظاهرشدن دکمهٔ شناور انجام شود، به‌محض ظاهرشدن آن اعمال می‌شود.

Respondo.open();
Respondo.open('I have a question about my invoice');
Respondo.close();

Respondo.destroy()

ویجت را از صفحه برمی‌دارد. برای SPAها هنگام رفتن به صفحه‌هایی که ویجت نباید در آن‌ها دیده شود کاربرد دارد. هویت بازدیدکننده یا گفت‌وگوی ذخیره‌شده را پاک نمی‌کند — برای خروج از حساب از Respondo.reset() استفاده کنید.

// ویجت را از صفحه بردار
Respondo.destroy();

// در صورت نیاز، بعداً دوباره مقداردهی کن (همان گفت‌وگو ادامه می‌یابد)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });

Respondo.reset()

خروج از حساب / تحویل دستگاه مشترک. شناسهٔ ناشناس بازدیدکننده، گفت‌وگوی ذخیره‌شده و توکن نشست را از مرورگر پاک می‌کند، توکن نشست را سمت سرور باطل می‌کند تا نسخه‌های آن از کار بیفتند، و ویجت ناشناس تازه‌ای دوباره سوار می‌کند. این متد را از هوک خروجِ اپ‌تان صدا بزنید.

// هنگام خروج — هویت، گفت‌وگو و نشست را پاک کن و از نو شروع کن
Respondo.reset();

جمع‌آوری خودکار داده

ویجت خودکار موارد زیر را با هر گفت‌وگو ثبت و ذخیره می‌کند:

دادهمنبع
IP کلاینتهدرهای HTTP
مرورگر / سیستم‌عاملهدر User-Agent
زبانهدر Accept-Language
منطقهٔ زمانیIntl API (JavaScript)
نشانی صفحهwindow.location
ارجاع‌دهندههدر Referer