حِزم الجوال (React Native وFlutter)

ضع دردشة Orki داخل تطبيق جوالك. تستضيف كلتا الحزمتين نفس تجربة الدردشة التي يراها زوّار الويب، مع جسر أصلي للهوية المُوثَّقة وأحداث دورة الحياة ومنفذ لرمز الإشعارات.

المنصة	الحزمة
React Native	@orki/webchat-react-native
Flutter	orki_webchat

React Native

npm install @orki/webchat-react-native react-native-webview

import { useRef } from 'react';
import { OrkiWebchat, OrkiWebchatHandle } from '@orki/webchat-react-native';

function SupportScreen({ orkiUserJwt }) {
  const chat = useRef<OrkiWebchatHandle>(null);
  return (
    <OrkiWebchat
      ref={chat}
      baseUrl="https://app.orki.ai"
      tenantId="YOUR_TENANT_ID"
      integrationId="YOUR_INTEGRATION_ID"
      language="ar"
      userJwt={orkiUserJwt}
      onEvent={(e) => {
        if (e.type === 'auth-required') {
          // اجلب JWT جديدًا من خادمك ثم:
          // chat.current?.updateToken(freshJwt)
        }
      }}
    />
  );
}

Flutter

dependencies:
  orki_webchat: ^0.1.0

final controller = OrkiWebchatController();

OrkiWebchatWidget(
  baseUrl: 'https://app.orki.ai',
  tenantId: 'YOUR_TENANT_ID',
  integrationId: 'YOUR_INTEGRATION_ID',
  language: 'ar',
  userJwt: orkiUserJwt,
  controller: controller,
  onEvent: (event) {
    if (event.type == 'auth-required') {
      // اجلب JWT جديدًا من خادمك ثم: controller.updateToken(freshJwt)
    }
  },
)

السطح المشترك

توفّر الحزمتان نفس العمليات:

العملية	الغرض
setUser(jwt)	تعيين/استبدال هوية الزائر (JWT موقَّع من خادمك)
updateToken(jwt)	تحديث الرمز في مكانه — دون إعادة تحميل، وتستمر المحادثة
logout()	مسح هوية الودجت والجلسة المخزّنة عند تسجيل الخروج من تطبيقك
setPushToken(token)	منفذ التقاط فقط — تسليم الإشعارات يصدر لاحقًا؛ توصيله الآن يبقيك جاهزًا
الأحداث	ready، auth-required، user-set، auth-error، message (عدد غير المقروء)، navigate

الوضع المجهول

يعمل مباشرة: يجري الودجت فحص الروبوتات داخل الـ WebView. أبقِ جافاسكربت وتخزين DOM مفعّلَين (كلتا الحزمتين تفعلان ذلك افتراضيًا).

تبني واجهتك الخاصة؟

استخدم واجهة برمجة دردشة العملاء مع @orki/chat-core (‏JS/TS) أو صنف OrkiChatClient المُضمَّن في orki_webchat (‏Dart).