امضاهای خود را با n8n خودکار کنید
n8n یک پلتفرم اتوماسیون متن‌باز است که می‌توانید آن را خود میزبانی کنید. دو راه برای رسیدن به Certyneo: گردش‌کار آماده ما را وارد کنید، که فقط از گره‌های Webhook و HTTP Request ارائه‌شده با n8n استفاده می‌کند و بنابراین نیازی به نصب ندارد، یا گره جامعه n8n-nodes-certyneo را نصب کنید اگر ترجیح می‌دهید گره Certyneo در پنل خود داشته باشید. در هر دو مورد، کلید API و رویدادهای امضای خود را جایگذاری کنید و بقیه stack خود را هدایت کنید.
گردش‌کار نیازی به نصب ندارد: فقط از گره‌های ارائه‌شده با n8n استفاده می‌کند، بنابراین در همه جا کار می‌کند، از جمله n8n Cloud. گره جامعه n8n-nodes-certyneo در npm منتشر می‌شود و از Settings → Community nodes بر روی یک نمونه خود میزبانی‌شده نصب می‌شود؛ n8n Cloud فقط گره‌هایی را پیشنهاد می‌دهد که n8n تایید کرده است.
چرا Certyneo را به n8n متصل کنید
n8n انتخاب را به شما می‌دهد: سرویس مدیریت‌شده، یا سرور شخصی‌تان. در هر دو صورت، ادغام Certyneo از API عمومی و webhook استفاده می‌کند، بدون واسطه‌ای اختصاصی بین قراردادهای شما و ابزار‌های شما.
۱۱ رویداد، نه چهار
گره Webhook کل چرخه حیات پاکت‌ها را دریافت می‌کند — ایجاد، ارسال، باز کردن، امضا، رد، لغو، انقضا، بازگشت به فرستنده. هیچ عاملی کنار گذاشته نمی‌شود، برخلاف اتصال‌دهنده‌های فهرست ثابت.
کل API، بدون انتظار
گره HTTP Request هر نقطه ورودی API 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، منوی گردش کار را باز کنید، سپس «Import from URL…» را انتخاب کنید و آدرس الگوی ما را بچسبانید. می‌توانید فایل را دانلود کنید و آن را بر روی بوم رها کنید.
- 2
تولید کلید API خود
Certyneo را باز کنید → تنظیمات → API REST و یک کلید با محدوده‌های envelopes و webhooks ایجاد کنید. آن را کپی کنید: تنها یک بار نمایش داده می‌شود.
- 3
ایجاد شناسه Header Auth
در n8n، یک شناسه «Header Auth» اضافه کنید: نام «Authorization»، مقدار «Bearer» به دنبال کلید شما. آن را در گره‌های HTTP Request گردش کار انتخاب کنید.
- 4
اشتراک سپس فعال‌سازی
URL تولید گره Webhook را کپی کنید، آن را در فراخوانی اشتراک بچسبانید، آن را یک بار اجرا کنید، سپس گردش کار را فعال کنید. «secret» بازگردانده شده را حفظ کنید: برای تأیید امضای رویدادها استفاده می‌شود.
- 5
اتصال Google Drive
الگو فایل PDF امضا شده و مدرک حسابرسی آن را در درایو شما قرار می‌دهد: حساب Google خود را در هر دو گره بایگانی انتخاب کنید. می‌توانید آنها را با S3، SharePoint یا هر ذخیره‌سازی دیگری جایگزین کنید، آنها از یک فیلد باینری مشابه استفاده می‌کنند.
امنیت و انطباق
یکپارچگی n8n بر اساس API عمومی Certyneo است، با همان سطح الزام‌آوری باقی پلتفرم.
- تبادل‌های رمزگذاری‌شده HTTPS از سر تا سر.
- کلیدهای API با دامنه محدود: فقط حقوق مورد نیاز را اعطا کنید.
- هر رویداد در HMAC-SHA256 امضا شده است — قبل از اقدام آن را تأیید کنید.
- لغو کلید در هر زمان از داشبورد شما.
سؤالات متداول
آیا باید یک گره Certyneo را در n8n نصب کنم؟
این اجباری نیست. گردش‌کاری که ما منتشر می‌کنیم فقط از گره‌های Webhook و HTTP Request ارائه‌شده با n8n استفاده می‌کند: نیازی به نصب نیست، و بر روی n8n Cloud نیز به خوبی کار می‌کند. یک گره جامعه وجود دارد اگر ترجیح می‌دهید — n8n-nodes-certyneo بر روی npm، با یک گره عمل، یک گره ماشه و شناسایی آن — و از Settings → Community nodes بر روی یک نمونه خود میزبانی‌شده نصب می‌شود. مستندات n8n n8n Cloud را برای گره‌هایی که تایید کرده است رزرو می‌کند.
برای استفاده از n8n، چه اشتراک Certyneo لازم است؟
یک کلید واقعی (sk_live_…) نیاز به پیشنهادی دارد که شامل دسترسی API باشد (Standard و بالاتر). پیشنهادهای Gratuit و Personal دارای یک کلید sandbox (sk_test_…) برای اجرای کل فرآیند روی پاکت‌های آزمایش هستند، بدون ارسال ایمیل به امضاکنندگان.
چگونه می‌توانم کلید API خود را دریافت کنم؟
از Certyneo به تنظیمات → API REST بروید و یک کلید با محدوده‌های envelopes:read، envelopes:write و webhooks:write ایجاد کنید. با sk_live_ (یا sk_test_ برای sandbox) شروع می‌شود و تنها یک بار نمایش داده می‌شود: بلافاصله آن را کپی کنید.
آیا این روی یک نمونه n8n خود‌میزبانی شده کار می‌کند؟
بله، و این جالب‌ترین مورد استفاده است. نمونه شما باید به‌سادگی از اینترنت قابل دسترسی باشد تا webhookهای ما را دریافت کند: یک URL عمومی HTTPS کافی است. هیچ داده‌ای از طریق یک سرویس شخص ثالث منتقل نمی‌شود.
کدام رویدادهای امضا پوشش داده می‌شوند؟
یازده رویداد چرخه عمر: پاکت ایجاد شد، ارسال شد، امضا شد، رد شد، لغو شد، منقضی شد، به فرستنده برگردانده شد، مجدداً ارسال شد، و گیرنده باز کرد، امضا کرد یا تایید کرد. شما انتخاب می‌کنید کدام‌یک از آنها را عضو شوید.
چگونه بررسی کنم که یک رویداد واقعاً از Certyneo می‌آید؟
هر تحویل دارای یک سرصحت X-Certyneo-Signature است که حاوی HMAC-SHA256 متن درخواست است، محاسبه‌شده با راز بازگردانده‌شده در ایجاد اشتراک. آن را در یک گره Code مقایسه کنید قبل از پردازش رویداد.
آیا ادغام n8n هزینه‌ای دارد؟
Certyneo هزینه اضافی نمی‌گیرد. در سمت n8n، یک نمونه خود‌میزبانی رایگان است؛ روی n8n Cloud، هر اجرا کوتای پیشنهاد شما را مصرف می‌کند.
ادامه مطالعه
قراردادهای خود را از امروز خودکار کنید
workflow را وارد کنید، کلید API خود را وصل کنید، و اجازه دهید امضاهای شما بقیه را راه‌اندازی کنند.