المطورون

خطافات الويب (Webhooks)

يمكن إرسال كل إشعار يصدره حسابكم مباشرةً إلى أنظمتكم كطلب JSON POST موقّع — وبذلك يمكن لما يحدث على استضافتكم أن يطلق سير عمل في أي مكان آخر.

جميع مستندات المطورين →

ما يمكنك ربطه به

إن الـ webhook هو مجرد طلب HTTPS عادي، لذا فإن أي شيء يمكنه استلامه يمكنه أيضاً التصرف بناءً عليه. لستم بحاجة إلينا لبناء تكامل لأداتكم.

منصات الأتمتة

وجّه خطاف ويب (webhook) نحو سير عمل في n8n, Make, Zapier, Pipedream, Activepieces وسيصبح كل حدث محفزًا — انشر في قناة، أو افتح تذكرة، أو حدّث جدول بيانات، أو استدعِ واجهة برمجة تطبيقات أخرى. تعمل المنصات المستضافة ذاتيًا بالطريقة نفسها تمامًا، طالما أنه يمكن الوصول إلى نقطة النهاية عبر HTTPS.

أنظمة إدارة علاقات العملاء ومكاتب المساعدة

أرسل أحداث الفوترة والحساب إلى HubSpot, Pipedrive, Salesforce، أو إلى أي مكتب مساعدة أو نظام إدارة علاقات العملاء (CRM) يدعم الـ webhook الوارد، ليعكس سجل العميل ما يحدث في استضافته دون الحاجة إلى نسخ البيانات يدويًا من قِبل أي شخص.

أي شيء آخر يستمع

Slack, Discord, Google Sheets, Airtable, Notion، أو المراقبة الخاصة بك، أو مستودع بيانات، أو نص برمجي صغير كتبته. إذا كان بإمكانه قبول HTTPS POST وقراءة JSON، فيمكنه تلقي هذه.

ما يتم إرساله

تختارون الفئات التي تذهب إلى كل وجهة — ويمكنكم ربط وجهات متعددة، بحيث تذهب الفواتير إلى مكان وتنبيهات الموقع إلى مكان آخر. كل شيء مفعّل بشكل افتراضي.

الفوترة والمدفوعات

الفواتير الصادرة والمدفوعة، والمدفوعات غير الناجحة، والبطاقات التي توشك صلاحيتها على الانتهاء، والتجديدات والإلغاءات.

المواقع والأمان

اكتمل التوفير، وتم تعليق موقع، وتم العثور على برامج ضارة، والنُّسخ الاحتياطية وتغييرات الشهادات.

الدعم ونطاقات المواقع

التذاكر المفتوحة والمصعَّدة، وعمليات نقل النطاق، والتجديدات وتغييرات DNS.

إثبات أن الطلب وارد منا

يتم توقيع كل طلب باستخدام سر لا نملكه إلا أنت ونحن. تحقق من التوقيع قبل اتخاذ أي إجراء بناءً على نص الرسالة — تصل هذه الترويسات مع كل عملية إرسال:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

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

يظهر سر التوقيع الخاص بك لمرة واحدة فقط، وذلك عند إضافة خطاف الويب. لا يمكننا عرضه مرة أخرى — إذا فقدته، فقم بإزالة الوجهة وإضافتها من جديد.

إعداد واحد

  1. في لوحة التحكم الخاصة بك، افتح الإشعارات وأضف وجهة من نوع Webhook.
  2. امنحه نقطة نهاية HTTPS الخاصة بك وانسخ سر التوقيع الذي نعرضه لك.
  3. اضغط على Test. نرسل طلبًا حقيقيًا بنفس بنية الطلب المباشر، لتتمكن من البناء والتطوير عليه قبل حدوث أي شيء فعلي.
  4. اختر الفئات التي يجب أن تتلقاها تلك الوجهة. يتم تفعيل الأنواع الجديدة من الإشعارات تلقائيًا.

يمكنكم إضافة أي عدد ترغبون به من الوجهات، والجمع بين خطافات الويب والبريد الإلكتروني وSlack وTelegram، وتعيين مجموعة مختلفة من الفئات لكل منها.

هل تفضل الاتصال بنا بدلاً من ذلك؟

تخبركم خطافات الويب (Webhooks) عند حدوث أمر ما. أما واجهة برمجة التطبيقات (API) فهي وسيلتكم لإجراء هذا الأمر — فكل عملية تنفذها لوحة التحكم متاحة لكم.

تصفح مرجع واجهة برمجة التطبيقات (API)