دليل البدء السريع
اربط Evnao بتطبيقك في دقائق. تعرّف على كيفية المصادقة، بدء المحادثات، وتمرير البيانات المخصصة للذكاء الاصطناعي.
1. الحصول على مفاتيح الـ API
قبل إجراء أي طلبات، تحتاج إلى أخذ مفاتيح الـ API الخاصة بك من إعدادات لوحة التحكم. حافظ على سرية مفتاحك السري ولا تعرضه أبداً في أكواد الواجهة الأمامية.
يُستخدم في تطبيقات الواجهة الأمامية (React, iOS, Android) لتهيئة نافذة المحادثة بشكل آمن.
يُستخدم فقط على خوادمك الخلفية لقراءة، كتابة، وتعديل بيانات الحساب الأساسية.
2. تهيئة نافذة المحادثة (React)
أسهل طريقة للبدء هي استخدام حزمة React SDK الرسمية الخاصة بنا. ما عليك سوى تغليف تطبيقك بـ `EvnaoProvider` وإدراج مكوّن `ChatWidget` في أي مكان تريده.
import { EvnaoProvider, ChatWidget } from "@evnao/react"; export default function App() { return ( <EvnaoProvider publishableKey="pk_live_xxxxxxxxx"> <YourApplication /> <ChatWidget theme="dark" metadata={{ userId: "user_123", plan: "enterprise" }} /> </EvnaoProvider> ); }
3. تمرير البيانات المخصصة
عندما يسجل المستخدم دخوله في تطبيقك، يجب عليك تمرير بياناته إلى Evnao عبر كائن `metadata`. هذا السياق يمكّن الذكاء الاصطناعي من حل التذاكر دون سؤال المستخدم عن بريده الإلكتروني أو معرف حسابه أو باقة اشتراكه.
نصيحة احترافية: الواجهات التفاعلية الآلية
إذا قمت بتمرير `stripeCustomerId` في البيانات، سيتعرف ذكاء Evnao تلقائياً على نوايا الدفع وسيقوم بتوليد بطاقة دفع آمنة لتحديث طريقة الدفع مباشرة داخل المحادثة دون كتابة أي كود إضافي من جانبك.