التوثيق الفني والتقني

دليل المطورين والتوثيق التقني

استكشف البنية التحتية، بروتوكولات الربط السحابي، وواجهات برمجة التطبيقات لمنصة أوتوماشي.

1. نظرة عامة والبدء السريع (Quickstart)

تربط أوتوماشي القنوات المتاحة عبر خطوات التصريح الرسمية من المنصات، ثم تعالج التعليقات والرسائل وفق صلاحيات الحساب وقواعد كل قناة.

  • متطلبات التشغيل: حساب Meta Business موثق أو صفحة فيسبوك مرتبطة بحساب إنستغرام احترافي.
  • الاعتماد الرسمي: يتم الاتصال حصرياً عبر بروتوكولات OAuth الرسمية لشركة Meta دون الحاجة لمشاركة كلمات المرور.
  • التوافق: دعم تلقائي لكافة قنوات المبيعات: المنشورات العادية، الريلز، الرسائل المباشرة، ومحادثات واتساب.

2. إعدادات الـ Webhooks والتحقق المباشر (Webhooks Handshake)

تستقبل المنصة أحداث التفاعل عبر نقطة نهاية مشفرة (Relay Endpoint) تقوم بالتحقق من صحة الطلب عبر التوقيع الرقمي (X-Hub-Signature-256).

// نموذج مصافحة التحقق الرسمي لـ Webhook:
GET /api/webhooks/whatsapp?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=1158201444
Response: 1158201444 (Status 200 OK)

// نموذج استقبال حدث رسالة واردة من واتساب:
POST /api/webhooks/whatsapp
Headers: { "x-hub-signature-256": "sha256=..." }
Payload: { "entry": [{ "changes": [{ "value": { "messages": [...] } }] }] }

3. محرك المسارات والمتغيرات الديناميكية (Flow Engine)

يتيح محرك المسارات المرئي حقن المتغيرات المخصصة تلقائياً في النصوص والردود بناءً على سياق المحادثة والمنتج:

{{name}}

اسم العميل المسجل في حسابه على إنستغرام أو واتساب.

{{product_link}}

رابط صفحة المنتج المباشر مع كود التتبع التسويقي.

{{discount_code}}

كود الخصم المخصص للحملة (مثل VIP20).

هل تحتاج لمساعدة برمجية متقدمة؟

فريق المهندسين لدينا متاح لمساعدتك في بناء وتخصيص مسارات الأتمتة المعقدة لمتجرك.