الويب هوك وZapier

اربط Zapier في 5 دقائق

1. في Zapier، أنشئ Zap. اختر كمشغّل Webhooks by Zapier ثم Catch Hook، وانسخ الرابط الذي يعطيك إياه Zapier.
2. في TutorPing، اذهب إلى الإعدادات ← التكاملات، والصق الرابط تحت الويب هوك واختر الأحداث التي تريدها.
3. انقر على إرسال حدث اختبار. يستقبل Zapier مثالاً ويعرض حقوله.
4. أضف الإجراء في Zapier، مثل «Create Spreadsheet Row» في جداول Google، واربط الحقول وفعّل الـ Zap.

الأحداث التي يمكنك إرسالها

• student.created، student.updated
• session.created، session.updated، session.cancelled
• invoice.created، invoice.paid
• lead.created، من صفحة الحجز أو نموذج التواصل أو نماذج التسجيل
• booking.requested، booking.confirmed

كيف يتم التسليم

كل حدث طلب POST بصيغة JSON يحمل اسم الحدث ووقته وبيانات السجل. إذا لم يرد رابطك خلال 10 ثوانٍ أو أعاد خطأ، يعيد TutorPing المحاولة بعد 1 و5 و30 و120 و720 دقيقة. تعرض عمليات التسليم الأخيرة ما أُرسل والرد المستلم. ويمكنك إيقاف مؤقت لأي رابط متى شئت.

الأمان للمطورين

يجب أن تكون روابط الويب هوك عناوين HTTPS عامة. يحمل كل طلب ترويسة X-TutorPing-Signature بالصيغة t=timestamp,v1=signature، حيث التوقيع هو HMAC-SHA256 لـ timestamp.body بمفتاح التوقيع الخاص بالرابط. تحقق منه قبل الوثوق بالبيانات، وارفض الطوابع الزمنية القديمة. انقر على مفتاح جديد إذا تسرّب المفتاح.

تعطي الترويستان X-TutorPing-Event وX-TutorPing-Delivery اسم الحدث ومعرّف تسليم فريداً، مفيداً لتجاهل محاولة أعيدت وسبق أن عالجتها.