المطورون
خطافات الويب
أرسل أحداثًا مثل العملاء المحتملين الجدد والتحويل إلى شخص والحجوزات إلى عنوان الويب الخاص بك، موقّعة لتتحقق من أن كل حدث جاء من MagizAI.
من يمكنه استخدامه: الأدوار «المالك» و«مدير»، أو دور مخصّص يملك صلاحية «تغيير إعدادات مساحة العمل واتصالاتها».
تعرض الصور الشاشات بالإنجليزية، أما الخطوات فتذكر الأزرار والتبويبات بأسمائها التي تظهر في لوحة التحكم بالعربية.
الخطوة 1: افتح تبويب «خطافات الويب»
في «الأتمتة»، اضغط تبويب «خطافات الويب». تجد نقاط النهاية و«عمليات الإرسال الأخيرة» في جهة، ونموذج «نقطة نهاية جديدة» في الجهة الأخرى.
الخطوة 2: املأ «نقطة نهاية جديدة»
املأ «الاسم»، والصق «رابط نقطة النهاية»، وحدد «الأحداث» التي تريدها، أو «*» لكل الأحداث. ثم اضغط «إنشاء نقطة النهاية».
الخطوة 3: انسخ مفتاح التوقيع الآن
بعد إنشاء نقطة النهاية، يُعرض مفتاح التوقيع السري الخاص بها، الذي يبدأ بـ whsec_، مرة واحدة مع زر «نسخ». احفظه في إعدادات خادمك.
لا يُعرض المفتاح السري مرة أخرى أبدًا. إذا فقدته، احذف نقطة النهاية وأنشئها من جديد لتحصل على مفتاح جديد.
الخطوة 4: تحقق من التوقيع على خادمك
كل عملية إرسال طلب POST بصيغة JSON يحمل الحدث وطابعًا زمنيًا والبيانات، مع ترويسة X-Signature قيمتها sha256= متبوعة بقيمة HMAC-SHA256 للمحتوى الخام، محسوبة بمفتاحك السري. احسبها على البايتات الخام قبل تحليل JSON، وقارن بزمن ثابت.
// signingSecret: the whsec_ secret you copied, kept in your server's settings const expected = 'sha256=' + crypto .createHmac('sha256', signingSecret) .update(rawBody) .digest('hex'); // compare expected with the X-Signature header using crypto.timingSafeEqualالخطوة 5: اضغط «إرسال اختبار»
يصل حدث اختبار موقّع اسمه ping إلى نقطة النهاية فورًا ويظهر في «عمليات الإرسال الأخيرة». أجب بحالة 2xx خلال 10 ثوانٍ، وإلا تُحتسب عملية الإرسال فاشلة.
الخطوة 6: اقرأ «عمليات الإرسال الأخيرة»
تعرض آخر 25 عملية إرسال نقطة النهاية، والحدث، والحالة، ورمز الاستجابة، والمحاولات، والوقت. وتُعاد محاولة عملية الإرسال التي تفشل أو تتلقى ردًا خارج 2xx، حتى ثلاث محاولات إجمالًا.
الخطوة 7: أوقف نقطة نهاية مؤقتًا أو عدّلها أو احذفها
اضغط «إيقاف مؤقت» لإيقاف عمليات الإرسال، و«تفعيل» لاستئنافها. يغيّر «تعديل» الاسم والعنوان والأحداث و«نشط»؛ ويزيل «حذف» نقطة النهاية وعمليات الإرسال الخاصة بها.
نصائح
- قد تصل عمليات الإرسال بغير ترتيبها، وقد تصل إعادة المحاولة مرتين، لذا عامل كل واحدة على أنها حقيقة تطبّقها، بالاعتماد على public_id الخاص بالمحادثة.
- يجب أن يكون العنوان متاحًا على الإنترنت العام: تُرفض العناوين الموجودة داخل شبكتك الخاصة.
- تشمل الأحداث المحادثات الجديدة، ورسائل الزوار، وردود الذكاء الاصطناعي، والكلمات المفتاحية، والتحويل إلى شخص، وطلبات المتابعة، والمحادثات المحلولة، والوسوم، والعملاء المحتملين، والطلبات المؤكدة، وعمليات التحويل إلى مبيعات، وإجراءات الوكلاء، وكل تغيير في حجز.
هل توقفت عند خطوة؟ اسأل فريقنا