أتمتة توقيعاتك باستخدام n8n
n8n هي منصة أتمتة مفتوحة المصدر يمكنك استضافتها بنفسك. يتصل Certyneo بها من خلال عقد Webhook و HTTP Request الأصلية: لا حاجة لتثبيت أي شيء، لا حاجة للتحقق من خلال متجر تطبيقات. استورد سير العمل الجاهز لدينا، والصق مفتاح API الخاص بك، وستتحكم أحداث التوقيع بباقي مكدس التكنولوجيا الخاص بك.
لا توجد عقد مجتمعية يجب تثبيتها: يعتمد التكامل فقط على العقد المرفقة مع n8n، لذا فهو يعمل أيضاً على n8n Cloud، حيث تكون العقد الخارجية مقيدة.
لماذا تربط 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 | يصادق مستقبل دوره "موافق" على المظروف دون إضافة توقيع عليه. |
ما يمكنك التحكم فيه
كل سطر هو استدعاء من عقدة 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
Connecter Google Drive
Le modèle dépose le PDF signé et sa preuve d'audit dans votre Drive : sélectionnez votre compte Google sur les deux nœuds d'archivage. Vous pouvez les remplacer par S3, SharePoint ou tout autre stockage, ils consomment le même champ binaire.
الأمن والامتثال
يعتمد تكامل n8n على واجهة برمجة التطبيقات العامة Certyneo، بنفس مستوى المتطلبات مثل بقية المنصة.
- تبادل مشفّر من البداية إلى النهاية عبر HTTPS.
- مفاتيح API ذات نطاق محدود: منح فقط الصلاحيات اللازمة.
- كل حدث موقّع بـ HMAC-SHA256 — تحقق منه قبل التصرف بناءً عليه.
- إلغاء مفتاح ما شاءت منذ لوحة التحكم.
الأسئلة الشائعة
هل يجب تثبيت عقدة Certyneo في n8n؟
لا، وهذا متعمّد. عُقد Webhook و HTTP Request المزودة مع 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 الخاص بك، واترك توقيعاتك تشغل الباقي.