مرجع API

تحكّم بودجت صلة برمجيًا واستمع إلى أحداثه داخل تطبيقك.

الكائن العام

يعرض الودجت كائنًا عامًا باسم window.Sela يمكنك استخدامه للتحكم في حالة الودجت وهوية المستخدم.

الأوامر

Sela.open()

يفتح الودجت برمجيًا.

javascript
document.getElementById('help-btn').addEventListener('click', () => {
  window.Sela.open();
});

Sela.close()

يغلق الودجت.

javascript
window.Sela.close();

Sela.identify(user)

يحدّث هوية المستخدم الحالي، وهو مفيد لتطبيقات SPA عندما يسجل المستخدم الدخول دون إعادة تحميل الصفحة.

javascript
window.Sela.identify({
  email: 'alice@example.com',
  name: 'Alice Smith',
  user_hash: '...' // Optional in secure mode
});

الأحداث

يمكنك الاستماع إلى أحداث الودجت عبر مستمعات الأحداث القياسية في المتصفح.

sela:ready

يُطلق عندما يصبح الودجت جاهزًا تمامًا ويستقبل الأوامر.

javascript
window.addEventListener('sela:ready', () => {
  console.log('Sela widget is ready');
  window.Sela.open();
});
sela:message_received

يُطلق عندما تصل رسالة جديدة من المساعد أو الفريق.

javascript
window.addEventListener('sela:message_received', (event) => {
  console.log('New message:', event.detail.text);
});