أتمتة توقيعاتك باستخدام n8n
n8n هي منصة أتمتة مفتوحة المصدر يمكنك استضافتها بنفسك. هناك طريقان للوصول إلى Certyneo: استورد سير العمل الجاهز لدينا، الذي يستخدم فقط عقد Webhook و HTTP Request المرفقة مع n8n وبالتالي لا يتطلب أي تثبيت، أو ثبّت عقدة المجتمع n8n-nodes-certyneo إذا كنت تفضل عقدة Certyneo في لوحتك. في كلا الحالتين، الصق مفتاح API الخاص بك وأحداث التوقيع الخاصة بك ستشغل بقية مكدس التكنولوجيا الخاص بك.
سير العمل لا يتطلب أي تثبيت: فهو يستخدم فقط العقد المرفقة مع n8n، لذلك يعمل في كل مكان، بما في ذلك n8n Cloud. يتم نشر عقدة المجتمع n8n-nodes-certyneo على npm ويتم تثبيتها من Settings → Community nodes على مثيل ذاتي الاستضافة؛ أما n8n Cloud فإنها تقدم فقط العقد التي تحققت منها n8n.
لماذا تربط Certyneo بـ n8n
n8n يعطيك الاختيار: الخدمة المُدارة، أو خادمك الخاص. في كلا الحالتين، يستخدم التكامل Certyneo واجهة برمجة التطبيقات العامة و webhooks، بدون وسيط ملكي بين عقودك وأدواتك.
الأحداث الـ 11، وليس أربعة فقط
تستقبل عقدة Webhook دورة حياة الأظرف كاملة — الإنشاء، الإرسال، الفتح، التوقيع، الرفض، الإلغاء، انتهاء الصلاحية، الإرجاع إلى المرسل. لا يتم تجاهل أي مشغّل، على عكس الموصلات ذات القائمة الثابتة.
كل واجهة برمجة التطبيقات، بدون انتظار
تستدعي عقدة HTTP Request أي نقطة دخول في واجهة برمجة تطبيقات Certyneo بمجرد توفرها: إنشاء ظرف، وإرساله، وتحميل مستند، واسترجاع ملف PDF الموقّع أو ملف الإثبات.
الاستضافة الذاتية ممكنة
على نموذج n8n تستضيفه بنفسك، لا تمر بيانات وصفية العقود الخاصة بك عبر أي طرف ثالث: يذهب حركة المرور من خادمك إلى Certyneo، وليس إلى أي مكان آخر. حجة قوية لفريق القانون وقسم تكنولوجيا المعلومات.
مفتاح API وتوقيع HMAC
يتم المصادقة على الاتصال بواسطة مفتاح API ذو نطاق محدود، قابل للإلغاء في أي وقت. يتم توقيع كل حدث وارد بـ HMAC-SHA256: يمكن لسير العمل الخاص بك التحقق من أنه يأتي من Certyneo.
الأحداث المتاحة
اشترك في عقدة Webhook للأحداث التي تختارها. تصل في الوقت الفعلي، مع رأس التوقيع X-Certyneo-Signature للتحقق منه على جانب n8n.
| حدث | تُشْعِلْ عندما… |
|---|---|
تم إنشاء الظرفenvelope.created | تم إنشاء ظرف للتو، لا يزال في حالة المسودة. |
غلاف مرسلenvelope.sent | يغادر الظرف حالة المسودة ويتجه نحو المستقبلين. |
غلاف وقَّعenvelope.completed | وقّع جميع المستقبِلين على المستند: تم إنهاء الغلاف، مع رابط تنزيل ملف PDF الموقّع. |
غلاف رفضenvelope.declined | يرفض المستقبل التوقيع، مع السبب الذي أشار إليه. |
تم إلغاء الظرفenvelope.voided | المُرسِل يلغي مظروفًا قد غادر بالفعل: تصبح روابط التوقيع غير قابلة للاستخدام. |
مظروف منتهي الصلاحيةenvelope.expired | انقضت المهلة الزمنية دون أن يوقّع جميع المستقبلين. |
مظروف معاد إلى المُرسِلenvelope.returned_to_sender | يعيد المستقبل المظروف لتصحيحه بدلاً من توقيعه. |
إعادة تقديم المظروفenvelope.resubmitted | يصحح المُرسِل ثم يعيد إرسال مظروف كان قد عاد إليه. |
مستلم وقَّعrecipient.signed | يُكْمِل مستلم التوقيع. تُشْعِل مرة واحدة لكل مستلم، وليس فقط في النهاية. |
المستقبل فتح المظروفrecipient.viewed | يفتح المستقبل المظروف للمرة الأولى — مفيد لإرسال تذكير في الوقت المناسب. |
المستقبل وافقrecipient.approved | يصادق مستقبل دوره "موافق" على المظروف دون إضافة توقيع عليه. |
عنوان غير متاحrecipient.bounced | عنوان المستقبل يرجع فشلاً دائماً (صندوق غير موجود، نطاق معطل). تتوقف محاولات إعادة الإرسال: صحح العنوان وأعد إرسال المغلف. |
ما يمكنك التحكم فيه
كل سطر هو استدعاء من عقدة HTTP Request، مع المصادقة Header Auth ومفتاح Certyneo الخاص بك.
إنشاء غلاف
POST /envelopes — ينشئ مظروفًا من نموذج Certyneo أو مستندات مودعة بالفعل، مع مستقبليه.
إرسال الغلاف
POST /envelopes/:id/send — يرسل المظروف من المسودة ويُرسل دعوات التوقيع.
إدراج المغلفات
GET /envelopes — قائمة مرقمة، الأحدث أولاً، مع مرشح حالة اختياري.
إيداع مستند
POST /documents — يرسل ملف PDF من أي عقدة n8n، بما في ذلك مرفق بريد إلكتروني أو ملف Drive.
الحصول على قائمة النماذج
GET /templates — يسترجع معرّفات نماذجك لتجنب ترميزها مباشرة في سير العمل.
تحميل ملف PDF الموقّع
GET /envelopes/:id/signed-document — استرجاع المستند الموقّع، و /audit-trail لملف الإثبات.
إعداد التكامل
سير العمل الذي نوفره يحتوي بالفعل على الخطّاف (webhook)، والتوجيه حسب الحدث، واستدعاء الاشتراك، ومثال على الإرسال. احسب خمس دقائق.
- 1
استيراد سير العمل
في n8n، افتح قائمة سير العمل ثم « استيراد من URL… » والصق عنوان نموذجنا. يمكنك أيضاً تحميل الملف وإسقاطه على لوحة الرسم.
- 2
إنشاء مفتاح API
افتح Certyneo → الإعدادات → REST API وأنشئ مفتاحًا بنطاقات الأغلفة والـ webhooks. انسخه: يتم عرضه مرة واحدة فقط.
- 3
إنشاء معرّف Header Auth
في n8n، أضف معرّف « Header Auth »: الاسم « Authorization »، والقيمة « Bearer » متبوعة بمفتاحك. حدّده على عُقد HTTP Request في سير العمل.
- 4
الاشتراك ثم التفعيل
انسخ عنوان URL الإنتاج لعقدة Webhook، والصقه في استدعاء الاشتراك، وشغّله مرة واحدة، ثم فعّل سير العمل. احتفظ بـ « السرّ » المُعاد: يُستخدم للتحقق من توقيع الأحداث.
- 5
توصيل Google Drive
يضع النموذج ملف PDF الموقع وإثبات المراجعة الخاص به في Drive الخاص بك : اختر حسابك على Google على عقدتي الأرشفة. يمكنك استبدالهما بـ S3 أو SharePoint أو أي تخزين آخر، فهي تستهلك نفس الحقل الثنائي.
الأمن والامتثال
يعتمد تكامل n8n على واجهة برمجة التطبيقات العامة Certyneo، بنفس مستوى المتطلبات مثل بقية المنصة.
- تبادل مشفّر من البداية إلى النهاية عبر HTTPS.
- مفاتيح API ذات نطاق محدود: منح فقط الصلاحيات اللازمة.
- كل حدث موقّع بـ HMAC-SHA256 — تحقق منه قبل التصرف بناءً عليه.
- إلغاء مفتاح ما شاءت منذ لوحة التحكم.
الأسئلة الشائعة
هل يجب تثبيت عقدة Certyneo في n8n؟
هذا ليس إلزاميًا. سير العمل الذي ننشره يستخدم فقط عقد Webhook و HTTP Request المرفقة مع n8n: لا شيء لتثبيته، ويعمل بنفس الفعالية على n8n Cloud. توجد عقدة مجتمع إذا كنت تفضلها — n8n-nodes-certyneo على npm، مع عقدة إجراء وعقدة مشغل ومعرّفها — ويتم تثبيتها من Settings → Community nodes على مثيل ذاتي الاستضافة. تحتفظ وثائق n8n بـ n8n Cloud للعقد التي تحققت منها.
أي اشتراك Certyneo مطلوب لاستخدام n8n؟
المفتاح الحقيقي (sk_live_…) يتطلب عرض يتضمن الوصول إلى واجهة برمجة التطبيقات (Standard وما فوقه). العروض المجاني والشخصي لديهما مفتاح اختبار (sk_test_…) لتتبع المسار الكامل على مظاريف الاختبار، بدون إرسال بريد إلكتروني إلى الموقّعين.
كيف يمكنني الحصول على مفتاحي API؟
من Certyneo، انتقل إلى Réglages → API REST وأنشئ مفتاحاً بالنطاقات envelopes:read وَ envelopes:write وَ webhooks:write. يبدأ بـ sk_live_ (أو sk_test_ للوهمي) ولا يُعرض سوى مرة واحدة: انسخه فوراً.
هل يعمل هذا على مثيل n8n موزّع ذاتياً؟
نعم، وهذه هي حالة الاستخدام الأكثر إثارة للاهتمام. يجب فقط أن يكون مثيلك قابلاً للوصول من الإنترنت لاستقبال webhooks الخاصة بنا: عنوان URL عام بـ HTTPS يكفي. لا تمر أي بيانات بعد ذلك عبر خدمة طرف ثالث.
ما هي الأحداث المتعلقة بالتوقيع التي تغطيها؟
أحداث دورة الحياة الأحد عشر: المظروف تم إنشاؤه، تم إرساله، تم توقيعه، تم رفضه، تم إلغاؤه، انتهت صلاحيته، تم إرجاعه للمرسل، تم إعادة تقديمه، والمستقبل فتح أو وقّع أو وافق. تختار تلك التي تشترك فيها.
كيفية التحقق من أن حدثًا يأتي فعلاً من Certyneo؟
كل تسليم يحمل رأس X-Certyneo-Signature الذي يحتوي على HMAC-SHA256 لجسم الطلب، محسوبًا باستخدام السر المرسل عند إنشاء الاشتراك. قارنه في عقدة Code قبل معالجة الحدث.
هل التكامل مع n8n مدفوع؟
Certyneo لا تفرض رسومًا إضافية. من جهة n8n، المثيل ذاتي الاستضافة مجاني؛ على n8n Cloud، كل تنفيذ يستهلك حصة خطتك.
الذهاب إلى أبعد من ذلك
أتمتة عقودك اليوم
استورد سير العمل، والصق مفتاح API الخاص بك، واترك توقيعاتك تشغل الباقي.