التكاملات · مكتبة الربط

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

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

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

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

تكاملات أصيلة جاهزة، وموصّلات بدون كود، وواجهة برمجية مفتوحة. الحالة موضّحة بصدق على كل بطاقة: متاح الآن، أو عبر Zapier/Make/API، أو قريبًا كموصّل أصيل.

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

3
متاح

Google Drive

يحفظ كل عقد موقّع تلقائيًا في مجلد على Drive فور اكتمال التوقيع.

كيف تربطه: فعّله من لوحة التحكم، اربط حساب Google، واختر مجلد الوجهة — يُرفَع الـPDF الموقّع بمرجعه فور حدث signature_request.completed.

قريبًا

Dropbox

يرفع العقود الموقّعة إلى مجلد Dropbox منظّم حسب المرجع والتاريخ.

كيف تربطه: موصّل أصيل قيد الإطلاق. حتى ذلك الحين اربطه اليوم عبر Zapier أو Make، أو مباشرةً بالـWebhook ثم GET /download.

قريبًا

OneDrive

أرشفة تلقائية للعقود الموقّعة داخل OneDrive أو SharePoint.

كيف تربطه: موصّل أصيل قريبًا، ومتاح الآن عبر Zapier أو Make أو استدعاء الـAPI مباشرةً بعد كل توقيع مكتمل.

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

3
عبر Zapier

Slack

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

كيف تربطه: أنشئ Zap بمحفّز «اكتمل التوقيع» وإجراء «رسالة Slack». أو استقبِل الـWebhook وأعِد إرساله إلى Incoming Webhook الخاص بقناتك.

قريبًا

Microsoft Teams

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

كيف تربطه: موصّل أصيل قريبًا؛ متاح الآن عبر Make، أو Webhook يوجَّه إلى Incoming Webhook الخاص بقناة Teams.

متاح

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

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

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

الـCRM والمبيعات

3
عبر Zapier

HubSpot

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

كيف تربطه: Zap بمحفّز «اكتمل التوقيع» وإجراء «إرفاق ملف/إنشاء ملاحظة» على الصفقة، مربوطًا عبر metadata.order_id أو reference.

قريبًا

Salesforce

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

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

عبر Make

Pipedrive

يحرّك الصفقة في خطّ الأنابيب ويرفق العقد الموقّع بها.

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

الأتمتة بدون كود

3
متاح

Zapier

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

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

متاح

Make (Integromat)

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

كيف تربطه: وحدة Webhook تستقبل الحدث، ووحدة HTTP تستدعي GET /download لجلب الـPDF، ثم أي وحدة وجهة تختارها.

عبر API

n8n

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

كيف تربطه: عقدة Webhook تلتقط الحدث، وعقدة HTTP Request تستدعي الـAPI؛ استضِفه ذاتيًا أو سحابيًا مع الحفاظ على مفاتيحك لديك.

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

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
نزّل الـPDF الموقّع

نادِ 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
# تنزيل مباشر للـPDF الموقّع عبر REST
curl https://wthaiq.com/api/v1/signature_requests/sr_3n8Kd2Qa1V/download \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Wthaiq-Version: 2026-07-01" \
  -o "signed.pdf"

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

نمط شائع

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

أكثر التدفّقات طلبًا — يُبنى في Zapier أو Make بنقرات، دون كتابة كود.

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

النتيجة: لحظة اكتمال التوقيع، يُؤرشَف العقد آليًا ويعرف فريقك فورًا — بلا متابعة يدوية. المرجع WTQ-XXXXXX يربط كل شيء معًا.

أسئلة شائعة

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

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

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

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

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

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

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

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

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

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

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

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

ابدأ بأداة بدون كود في دقائق، أو ابنِ تكاملك الخاص عبر REST API وWebhooks. كل ما تحتاجه جاهز.