مساحة العمل
الموصلات والخطافات
تسليم الأحداث لأنظمتك. قائمة أحداث الخطافات الكاملة، توقيع HMAC، إعادات المحاولة، والتكاملات.
يتحدث Docshark مع حزمتك بطريقتين: موصلات تسحب للداخل، وخطافات تدفع أحداثاً للخارج.
الخطافات (Webhooks)
أنشئ نقاط نهاية تحت الإعدادات ← الخطافات. كل اشتراك يأخذ:
- العنوان. يجب أن يكون HTTPS.
- الأحداث. واحد على الأقل، من القائمة أدناه.
- التسمية. اسم لنقطة النهاية (حتى 120 حرفاً).
- السر، مولَّد عند الإنشاء، يُعرض مرة واحدة، مشفَّر في الراحة. خزّنه فوراً، يوقّع كل تسليم.
أنواع الأحداث
| الحدث | يشتعل عندما |
|---|---|
ENVELOPE_SENT | مغلف يخرج. |
ENVELOPE_DELIVERED | بريد مستلم يصل. |
ENVELOPE_VIEWED | مستلم يفتح المستند. |
ENVELOPE_SIGNED | مستلم يوقّع. |
ENVELOPE_DECLINED | مستلم يرفض. |
ENVELOPE_COMPLETED | الجميع انتهى؛ المستند يُختم. |
ENVELOPE_EXPIRED | انتهاء المغلف يمرّ غير موقَّعاً. |
ENVELOPE_VOIDED | تلغي المغلف. |
ENVELOPE_REMINDED | تذكير يخرج. |
ENVELOPE_CORRECTED | مغلف نشط يُصحَّح. |
FORM_SUBMITTED | نموذج ويب يحصل استجابة. |
POWERFORM_ACTIVATED | اكتمال Power Form يحدث. |
OBLIGATION_DUE_SOON | التزام متتبَّع يقترب تاريخه. |
OBLIGATION_OVERDUE | التزام يمرّ غير محلول. |
التسليم
- التوقيع. الحمولات موقَّعة بـHMAC بسر نقطة نهايتك؛ تحقق من التوقيع قبل الثقة بالجسم.
- المهلة. التسليمات تنتظر حتى 10 ثوانٍ؛ نقاط النهاية البطيئة تُحسب فشلاً.
- عتبة الفشل. عشرة فشل متتالية تُسقط حالة نقطة النهاية؛ أصلحها وأعد تفعيلها.
- الحمولات. نوع الحدث، معرّفات المغلف/النموذج/الالتزام، وسياق الفاعل/الوقت.
الموصلات
- Google Drive. استورد ملفات مباشرة إلى مكتبتك؛ وصّل مرة، تصفح Drive من منتقي الرفع.
البناء على الأحداث
الخطافات تقود التكاملات التي لا يشحنها Docshark: ادفع ENVELOPE_COMPLETED لنظام CRM لقلب مرحلة صفقة، OBLIGATION_OVERDUE لتنبيهاتك، FORM_SUBMITTED لخط استقبالك. قائمة الأحداث أعلاه هي العقد. اشترك في ما يحتاجه تدفقك، وتجاهل الباقي.