الخطوات الأولى

تتيح لك واجهة برمجة تطبيقات sem.chat إمكانية إدارة المحادثات وإرسال الرسائل والوصول برمجيًا تحليلات. تتطلب جميع طلبات API المصادقة باستخدام مفتاح API.

عنوان URL الأساسي

https://api.sem.chat/v1

المصادقة

قم بتضمين مفتاح API الخاص بك في رأس التفويض لجميع الطلبات:

Authorization: Bearer your_api_key_here

المحادثات

قائمة المحادثات

GET / المحادثات

استرجع قائمة بجميع المحادثات الخاصة بحسابك.

المعلمة النوع الوصف
الحد عدد صحيح عدد النتائج المطلوب عرضها (100 كحد أقصى) إزاحة
عدد صحيح عدد النتائج المطلوب تخطيها حالة
سلسلة التصفية حسب الحالة: نشط، مغلق، معلق

احصل على المحادثة

GET /conversations/{id}

استرجاع تفاصيل محادثة معينة بما في ذلك جميع الرسائل.

إنشاء محادثة

POST / المحادثات

ابدأ محادثة جديدة برمجيًا.

الرسائل

أرسل رسالة

POST /conversations/{id}/messages

أرسل رسالة إلى محادثة موجودة.

// Example request body { "content": "Hello, how can I help you today?", "sender": "agent" }

خطافات الويب

قم بإعداد خطافات الويب لتلقي إشعارات في الوقت الفعلي حول أحداث المحادثة.

الأحداث المتاحة

حدث الوصف
بدأت المحادثة تم بدء محادثة جديدة
تم استلام الرسالة تم استلام رسالة جديدة من أحد الزوار
المحادثة مغلقة تم إغلاق المحادثة
تم التقاط الرصاص تم جمع معلومات الاتصال

حدود المعدل

طلبات واجهة برمجة التطبيقات محدودة لضمان الاستخدام العادل:

الخطة حد السعر
المحاكمة 100 طلب/ساعة
احترافي 1000 طلب/ساعة
الأعمال 10000 طلب/ساعة