تخطّي إلى المحتوى
التكاملات · مكتبة الربط

اربط وثائق بأنظمتك الحالية.

اربط توقيعك الإلكتروني بالأدوات التي تستخدمها كل يوم: تخزين آلي للعقود الموقّعة، وإشعارات لفريقك، وربط بنظام إدارة العملاء (CRM)، وأتمتة عبر وحدات Webhook في Zapier و Make و n8n. وإن أردت تحكّمًا تامًّا، فكل شيء متاح عبر واجهة برمجة التطبيقات (REST API) وإشعارات الأحداث الآلية (Webhooks).

أتمتة عبر Zapier و Make تخزين آلي للعقود الموقّعة REST API و Webhooks لأي نظام
وثائق wthaiq.com/api Drive Slack CRM البريد Zapier Webhooks
مكتبة التكاملات

اختر أداتك، واربطها في دقائق.

تكاملات أصيلة جاهزة، وربط عبر أدوات الأتمتة، وواجهة برمجية مفتوحة. وتُبيّن كل بطاقة حالة التكامل بشفافية: متاح بموصّل أصيل، أو عبر Zapier أو Make أو الواجهة البرمجية بإعداد تضبطه بنفسك.

التخزين والمستندات

5
متاح

Google Drive

يحفظ نسخة PDF من كل طلب توقيع حيّ يكتمل في مجلد «وثائق» على حسابك في Drive، تلقائيًّا.

كيف تربطه: بنقرة واحدة من «التكاملات الخارجية» في بوابة المطوّرين، في باقتي «الأعمال» و«المؤسسات».

متاح

Dropbox

يحفظ نسخة PDF من كل طلب توقيع حيّ يكتمل في مجلد التطبيق على حسابك في Dropbox، مرتّبةً بالسنة.

كيف تربطه: بنقرة واحدة من «التكاملات الخارجية» في بوابة المطوّرين، في باقتي «الأعمال» و«المؤسسات».

متاح

OneDrive

يحفظ نسخة PDF من كل طلب توقيع حيّ يكتمل في مجلد التطبيق على حسابك في OneDrive، مرتّبةً بالسنة.

كيف تربطه: بنقرة واحدة من «التكاملات الخارجية» في بوابة المطوّرين، في باقتي «الأعمال» و«المؤسسات».

متاح

SharePoint

يحفظ نسخة PDF من كل طلب توقيع حيّ يكتمل في مكتبة تختارها على SharePoint، مرتّبةً بالسنة.

كيف تربطه: بنقرة واحدة من «التكاملات الخارجية» في بوابة المطوّرين، في باقتي «الأعمال» و«المؤسسات».

متاح

Box

يحفظ نسخة PDF من كل طلب توقيع حيّ يكتمل في مجلد «وثائق» على حسابك في Box، مرتّبةً بالسنة.

كيف تربطه: بنقرة واحدة من «التكاملات الخارجية» في بوابة المطوّرين، في باقتي «الأعمال» و«المؤسسات».

الإشعارات والفِرَق

3
عبر Zapier

Slack

يرسل إشعارًا إلى قناة فريقك لحظة اكتمال توقيع أي طلب.

كيف تربطه: في Zapier: محفّز «Webhooks by Zapier» يستقبل حدث اكتمال التوقيع من نقطة استقبال تضيفها في بوابة المطوّرين، ثم إجراء «إرسال رسالة» في Slack.

عبر Make

Microsoft Teams

بطاقة إشعار في قناة Teams عند كل حدث توقيع أو تأكيد هوية.

كيف تربطه: سيناريو في Make: تلتقط وحدة Webhook حدث التوقيع أو تأكيد الهوية، ثم ترسل وحدة Microsoft Teams رسالة إلى القناة.

متاح

البريد الإلكتروني

إشعارات ودعوات توقيع وتذكيرات تلقائية لكل طرف، مضمّنة في المنصّة.

كيف تربطه: مفعّل افتراضيًا لكل طلب. ويمكنك ضبط التذكيرات عبر الحقل reminders في متن الطلب، وتفعيل الرسائل أو تعطيلها لكل قالب من الإعدادات.

العملاء والمبيعات

3
عبر Zapier

HubSpot

يُرفق العقد الموقّع بالصفقة ويحدّث مرحلتها فور اكتمال التوقيع.

كيف تربطه: في Zapier: محفّز «Webhooks by Zapier» يستقبل حدث اكتمال التوقيع، ثم إجراء «إنشاء ملاحظة» على الصفقة، مع مطابقتها عبر الحقل metadata.order_id أو reference.

عبر API

Salesforce

يحدّث السجلّات ويُرفق المستند الموقّع بالفرصة البيعية أو الحساب تلقائيًا.

كيف تربطه: باستدعاء واجهة برمجة التطبيقات من Apex أو Flow لجلب المستند وربطه بالفرصة البيعية، أو عبر وحدات Webhook في Zapier أو Make.

عبر Make

Pipedrive

يحرّك الصفقة عبر مراحل مسار المبيعات، ويُرفق بها العقد الموقّع.

كيف تربطه: سيناريو في Make: تلتقط وحدة Webhook الحدث، ثم يُنزَّل ملف PDF ويُنفَّذ إجراء «إرفاق ملف بالصفقة» في Pipedrive.

أدوات الأتمتة

3
عبر Webhooks

Zapier

يربط أحداث «وثائق» بآلاف التطبيقات بإعداد دون برمجة.

كيف تربطه: لا يوجد تطبيق خاص بوثائق في Zapier بعد؛ استخدم «Webhooks by Zapier» لاستقبال أحداثنا بوصفها محفّزًا، ثم اختر أي إجراء في تطبيقاتك المفضّلة، دون برمجة أو استضافة.

عبر Webhooks

Make (Integromat)

سيناريوهات مرئية تلتقط الأحداث وتنفّذ خطوات متسلسلة تلقائيًا.

كيف تربطه: تستقبل وحدة Webhook الحدث، وتستدعي وحدة HTTP GET /download لجلب رابط الوثيقة النهائية ومرجع التحقّق، ثم يُمرَّر الرابط إلى أي وحدة وجهة تختارها.

عبر API

n8n

أتمتة مفتوحة المصدر تستضيفها بنفسك، بتحكّم كامل في تدفّق البيانات.

كيف تربطه: تلتقط عقدة Webhook الحدث، وتستدعي عقدة HTTP Request واجهة برمجة التطبيقات. ويمكنك استضافة n8n ذاتيًا أو على السحابة مع بقاء مفاتيحك لديك.

مخصّص بتحكّم كامل

2
متاح

REST API

تحكّم برمجي كامل: إنشاء الطلبات، وتنزيل المستندات، ومتابعة الأحداث.

كيف تربطه: واجهة موحّدة على العنوان wthaiq.com/api/v1 تُستدعى بمفتاح سرّي sk_ (أو بمفتاح عام pk_ في المتصفّح). اطّلع على التوثيق الكامل.

متاح

Webhooks

أحداث لحظية موقّعة تصل إلى نظامك فور كل تغيير يطرأ على الطلب.

كيف تربطه: اشترِك في الأحداث التي تهمّك، وتحقّق من الترويسة Wthaiq-Signature باستخدام HMAC. واطّلع على دليل الـWebhooks.

ابنِ تكاملك الخاص

لم تجد أداتك؟ اربطها بنفسك.

لا تحتاج إلى موصّل جاهز؛ فكل ما تراه هنا مبنيّ على الأساسين نفسيهما المتاحين لك: Webhooks (إشعارات الأحداث الآلية) تُخطرك لحظيًا، و REST API (واجهة برمجة التطبيقات) تمنحك كل مستند وحدث. ويمكن ربط أي نظام لديه نقطة استقبال HTTP.

1
استقبِل الحدث

اشترِك في الحدث signature_request.completed على نقطة الاستقبال لديك، وتحقّق من التوقيع في الترويسة Wthaiq-Signature.

2
احصل على الوثيقة الموقّعة

استدعِ GET /signature_requests/{id}/download لجلب رابط الوثيقة النهائية القابلة للطباعة والحفظ بصيغة PDF.

3
انقله إلى نظامك

احفظه في مساحة التخزين، أو أرفِقه بسجلّ العميل، أو أطلِق أي إجراء داخلي، وكل ذلك في أقل من خمس ثوانٍ.

webhook.php
// نقطة استقبال Webhook — تدفع العقد الموقّع إلى نظامك
$payload = file_get_contents('php://input');
$sig     = $_SERVER['HTTP_WTHAIQ_SIGNATURE'] ?? '';

// 1) تحقّق من التوقيع HMAC-SHA256 قبل الوثوق بالحدث
if (!wthaiq_verify($payload, $sig, getenv('WTHAIQ_WHSEC'))) {
    http_response_code(400); exit;
}

$event = json_decode($payload, true);

// 2) عند اكتمال التوقيع: نزّل الـPDF وادفعه لوجهتك
if ($event['type'] === 'signature_request.completed') {
    $sr  = $event['data']['object'];
    $pdf = $wt->signatureRequests->download($sr['id']);
    save_to_drive($pdf, $sr['reference'] . '.pdf');
}

http_response_code(200); // ردّ سريع < 5 ثوانٍ
download.sh
# روابط العقد الموقّع عبر REST (JSON فيه final_document_url)
curl https://wthaiq.com/api/v1/signature_requests/sr_3n8Kd2Qa1V/download \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Wthaiq-Version: 2026-07-01"

نصيحة: اجعل نقطة الاستقبال آمنة عند التكرار (idempotent) بتجاهل أحداث evt_ المكرّرة، ونفّذ المهام الثقيلة على نحو غير متزامن بعد الردّ بالرمز 200.

نمط شائع

مسار جاهز: وقّع، احفظ، وأبلِغ فريقك.

هذا أكثر مسارات الأتمتة طلبًا، ويمكن بناؤه في Zapier أو Make ببضع نقرات دون برمجة.

محفّز واحد · إجراءان
المحفّز اكتمل التوقيع حين يوقّع جميع الأطراف على الطلب في «وثائق». signature_request.completed
الإجراء الأول احفظ في Google Drive يُرفَع ملف PDF الموقّع إلى مجلد منظّم حسب المرجع. GET /download
الإجراء الثاني أبلِغ Slack رسالة إلى قناة الفريق تتضمّن رابط العقد ومرجعه. chat.postMessage

النتيجة: فور اكتمال التوقيع يُؤرشَف العقد آليًا ويُبلَّغ فريقك في الحال، دون أي متابعة يدوية. ويربط المرجع WTQ-XXXXXXXXXXXX بين هذه الخطوات جميعًا.

أسئلة شائعة

أسئلة حول التكاملات.

هل تحتاج التكاملات إلى كتابة كود؟

ليس بالضرورة: أدوات الأتمتة Zapier و Make و n8n تستقبل أحداثنا عبر وحدات Webhook العامّة وتنفّذ الإجراءات بإعداد دون برمجة، ولا يوجد فيها تطبيق خاص بوثائق بعد. أمّا إن أردت تحكّمًا كاملًا وربطًا خاصًا بنظامك، فالـREST API و Webhooks متاحان لك بالكامل — والخيار الأنسب يعتمد على حجم التخصيص الذي تحتاجه.

أيّ التكاملات أصيلة (native) الآن، وأيّها قريبًا؟

إشعارات البريد مدمجة أصيلًا وتعمل الآن، وكذلك الحفظ في Google Drive و OneDrive و Dropbox من «التكاملات الخارجية» في باقتي «الأعمال» و«المؤسسات». أمّا Zapier و Make فتعمل اليوم عبر وحدات Webhook العامّة، و n8n عبر الـAPI، وبقية الأدوات — مثل Slack و Microsoft Teams و HubSpot و Salesforce — تُربط عبرها أو عبر الـAPI مباشرةً. لا نَعِد بموصّل لم يُبنَ بعد.

كيف يصل الملف الموقّع إلى نظامي؟

بطريقتين: استقبِل حدث signature_request.completed ثم نادِ GET /signature_requests/{id}/download لجلب الـPDF المختوم؛ أو اقرأ الحقل download_url من كائن الطلب حين تكتمل حالته. في الحالتين تحصل على المستند بصيغة PDF بمرجع تحقّق عام، ولا يُدمَج فيه توقيع PAdES إلا لمن وقّع بالتوكن.

هل التكاملات آمنة؟

نعم. كل حدث Webhook موقّع بترويسة Wthaiq-Signature بخوارزمية HMAC-SHA256، ويجب التحقّق منه بمقارنة ثابتة الزمن قبل معالجته، مع رفض الأحداث الأقدم من 300 ثانية. والمفتاح sk_ حيّ ما لم يكن مفتاح تجربة (sk_test_)، والمفتاح العام pk_ محدود الصلاحيات ومقفول على نطاقاتك عند الاستخدام في المتصفّح.

ماذا لو لم أجد الأداة التي أستخدمها في القائمة؟

لا مشكلة على الإطلاق. كل قدرة في المنصّة متاحة عبر REST API و Webhooks، فأي نظام لديه واجهة HTTP يمكن ربطه — سواء عبر أداة أتمتة مثل Zapier و Make، أو بتكامل مخصّص تبنيه بنفسك. ابدأ من التوثيق ثم اربط ما تشاء.

اربط «وثائق» بمنظومتك اليوم.

ابدأ بأداة أتمتة مثل Zapier أو Make، أو ابنِ تكاملك الخاص عبر واجهة برمجة التطبيقات وإشعارات الأحداث الآلية. كل ما تحتاجه جاهز.