الوثائق

Webhooks — نظرة عامة وإعداد Pro

تتيح ويب هوك Savebase ربط مكتبتك بأي أداة أتمتة مثل Zapier أو Make أو Slack أو Airtable أو Discord أو خادمك الخلفي. عند حفظ منشور أو وسمه أو حذفه أو استعادته، يرسل Savebase طلب HTTP POST إلى وجهتك المسجلة.

ميزة Pro

تتوفر Webhooks في خطتي Pro وLifetime. رقِّ خطتك عبر savebase.space/pricing.

نظرة عامة

عند وقوع حدث في مكتبتك، يرسل Savebase بيانات JSON موقّعة إلى كل نقاط Webhook المفعّلة والمسجّلة لذلك الحدث. يمكنك تسجيل عدة نقاط، كواحدة لكل تكامل.

إعداد ويب هوك

1

انتقل إلى الإعدادات → Webhooks

انتقل إلى Dashboard → Settings → Webhooks.
2

انقر إضافة Webhook

أدخل عنوان URL لنقطة النهاية (يجب أن يستخدم HTTPS)، وتسمية اختيارية، وحدّد الأحداث التي تريد الاشتراك فيها.
3

انسخ سر التوقيع

بعد إنشاء webhook، أظهر وانسخ سر التوقيع. استخدم هذا للتحقق من أن الطلبات تأتي من Savebase.
4

اختبار الوجهة

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

الأحداث المدعومة

الحدثوقت التفعيل
post.savedتُضاف مشاركة جديدة إلى مكتبتك
post.taggedيُضاف وسم إلى منشور
post.deletedتُنقل مشاركة إلى المهملات
post.restoredتُستعاد مشاركة من المهملات

تنسيق الحمولة

تشترك جميع الأحداث في بنية JSON الخارجية نفسها:

bash
{
  "event": "post.saved",
  "timestamp": "2026-03-11T12:00:00.000Z",
  "data": {
    "id": 123,
    "url": "https://x.com/user/status/...",
    "title": "Post title or null",
    "source": "x",
    "author_name": "username",
    "tags": ["design", "ai"],
    "saved_at": "2026-03-11T12:00:00.000Z"
  }
}

تكامل Zapier

1

إنشاء Zap جديد

في Zapier، انقر Create Zap وابحث عن Webhooks by Zapier كتطبيق التشغيل.
2

اختر Catch Hook

تحديد Catch Hook. سيُنشئ Zapier عنوان URL فريدًا لـ webhook.
3

سجّل الرابط في Savebase

انسخ رابط Zapier إلى Settings → Webhooks واختر الأحداث.
4

اختبار المُشغّل

احفظ منشورًا. يكتشف Zapier الحمولة؛ اربط data.url, data.title، وما إلى ذلك إلى خطوات الإجراء لديك.
5

إضافة الإجراء

اربط أي إجراء Zapier: صف Google Sheets أو رسالة Slack أو صفحة Notion أو منشور Discord.

لا يوجد تحقق أصلي من التوقيع في Zapier

أضف خطوة Filter أو Code في Zapier للتحقق من X-Savebase-Signature الترويسة إذا كنت تحتاج التحقق الأمني.

Make (Integromat)

1

إنشاء سيناريو جديد

في Make، أضف Webhooks → Webhook مخصص وحدة المشغّل.
2

سجّل في Savebase

انسخ رابط Make إلى Settings → Webhooks.
3

تحديد بنية البيانات

احفظ منشورًا في Savebase؛ يتعرف Make تلقائيًا على بنية الحمولة.
4

أنشئ السيناريو الخاص بك

خريطة data.url, data.source، وحقولًا أخرى إلى الوحدات اللاحقة مثل Airtable أو Notion أو البريد الإلكتروني.

السابق

استكشاف الأخطاء

التالي

الأمان وتوقيع HMAC