نظرة عامة على API

تستخدم واجهة API العامة تنسيق JSON موجَّهًا نحو الموارد عبر HTTPS ضمن المسار /api/v1. وهي متاحة في الباقات المدفوعة، وتعتمد على نفس صلاحيات الموقع والرصيد والميزات المعتمدة في لوحة التحكم.

ما الذي يمكنك أتمتته#

• المواقع وحالة النشر
• إعدادات الـ agent والأسئلة الشائعة والمنتجات والمعرفة
• المحادثات (بما في ذلك ردود المالك والإيقاف المؤقت والاستئناف) والـ leads والتحليلات والإشعارات والرسائل الجماعية
• إنشاء الـ leads وتسجيل موافقتهم، ومسارات الفرص، ونتائج CRM، واستعادة المزامنة
• الـ connectors والتسييل والتذاكر والفريق والاستخدام ومعلومات الحساب
• اشتراكات Webhooks الموقَّعة للأحداث المدعومة

تستخدم الإجراءات الحساسة نقاط نهاية صريحة مخصصة للإجراءات بدلًا من التعديل غير المقيّد على قاعدة البيانات. تُقبل أسرار الـ connector عند الكتابة، لكنها لا تُعاد أبدًا.

هذه واجهة API للإدارة والمزامنة. يمكنها إنشاء الـ leads وتحديثها، وقبولها في مسار الفرص، واستيراد نتائج CRM (الفوز/الخسارة) مع نسبتها إلى مصدرها، وإعادة محاولة عمليات استيراد النتائج الفاشلة، والرد على الزائر بصفة النشاط التجاري، مع إيقاف الـ agent مؤقتًا في تلك المحادثة واستئنافه. أما إرسال الرسائل بصفة الزائر فيظل عملية خاصة بالأداة (widget)، وتبقى التحليلات والاستخدام للقراءة فقط. تمت إزالة النطاقات المخصصة، وتعيد مسارات /domains الرمز 409.

ابدأ بأمان#

أنشئ مفتاحًا محدود النطاق من لوحة التحكم، ثم استدعِ نقطة نهاية الحساب الحالي، وابنِ تطبيقك أولًا على موقع تجريبي قبل أن تتعامل مع محتوى الإنتاج.

curl https://makeagent.fast/api/v1/me \
  -H "Authorization: Bearer maf_live_YOUR_KEY"

راجع المصادقة والبدء السريع مع API ومرجع API.