كيف أربط Zapier أو Make بـ VeloCMS؟
أنشئ مفتاح API محدود الصلاحيات، ثم اشترك webhook في أي حدث من الفهرس — منشور جديد، طلب جديد، بطاقة هدية جديدة، وغيرها — وسيلتقطه Zapier أو Make خلال ثوانٍ، دون كتابة أي كود.
ربط VeloCMS بـ Zapier أو Make يتم عبر خطوتين: احصل على مفتاح API من Admin → Settings → API Keys، ثم سجّل اشتراك webhook يُشير إلى منصة الأتمتة التي تستخدمها. من تلك اللحظة، يُرسل VeloCMS حمولة JSON موقّعة إلى نقطة النهاية الخاصة بك فور وقوع الحدث — دون تأخير استقصاء (polling)، ودون أي خدمة وسيطة. يعمل كل من Zapier وMake اليوم عبر موصلاتهما العامة المدمجة، وقبل وجود أي تطبيق يحمل علامة VeloCMS في أي من الدليلين.
ما الأحداث التي يمكنها تشغيل webhook؟
يضم الفهرس عشرين حدثًا، مُجمّعة بحسب ما تتعلق به: المحتوى (post.published، post.updated، page.published)، الأعضاء (member.subscribed، member.tier_changed، member.unsubscribed)، التجارة (order.paid، order.refunded، order.shipped، product.created، gift_card.issued)، التعليقات، ورفع الوسائط. اختر عدد ما تحتاجه في اشتراك واحد — post.published هو الأكثر شيوعًا كبداية لأنه يُشغّل أتمتة المشاركة على وسائل التواصل، لكن order.paid وgift_card.issued لا يقلّان شعبية لدى أصحاب المتاجر. القائمة الكاملة مع أشكال الحمولات موجودة على /developers/zapier، وإن أردت النسخة القابلة للقراءة الآلية فهي على /api/v1/asyncapi.json.
كيف أُنشئ مفتاح API الذي سأحتاجه؟
افتح Admin → Settings → API Keys، انقر على New Key، اختر اسمًا، وفعّل صلاحيتي webhooks:read وwebhooks:write (وأضف posts:write أو members:write إن كنت تنوي جعل Zapier ينشئ محتوى داخل VeloCMS). يُعرض المفتاح النصي مرة واحدة فقط — انسخه إلى مكان آمن قبل إغلاق النافذة، لأن VeloCMS لن يعرضه مرة أخرى. اشتراكات الـ webhook ميزة مقتصرة على خطة Pro، لذا تتطلب هذه الخطوة اشتراك Pro (أو أعلى) نشطًا.
كيف أُعدّ Zap في Zapier للمنشورات الجديدة؟
في Zapier، أنشئ Zap جديدًا واختر Webhooks by Zapier كمحفّز، ثم Catch Hook كحدث. سيمنحك Zapier رابطًا فريدًا — وهذا ما تُسجّله لدى VeloCMS. استدعِ نقطة نهاية الاشتراك في VeloCMS باستخدام مفتاح الـ API الخاص بك كرمز Bearer، ورابط Zapier، والحدث الذي تريده (post.published في هذا المثال)؛ المثال الكامل بأمر curl موجود على صفحة /developers/zapier المرجعية. عُد إلى Zapier وانقر على Test Trigger وانشر منشورًا تجريبيًا — أو ببساطة استدعِ نقطة نهاية الاختبار التي يمنحك إياها VeloCMS، والتي تُرسل نبضة اختبار اصطناعية بنفس آلية التوقيع المستخدمة في التسليم الحقيقي. بمجرد التقاط Zapier لتلك الحمولة، اربط ما يليها: منشور في Slack، صف في Google Sheets، تغريدة.
كيف أُعدّ سيناريو في Make بدلًا من ذلك؟
Make هو في الواقع المسار الأسرع هنا، لأن وحدتيه العامتين HTTP وWebhooks لا تتطلبان أي تسجيل تطبيق. أضف وحدة Webhooks إلى سيناريوك، انسخ الرابط الذي تولّده، وسجّله لدى VeloCMS بنفس الطريقة التي تسجّل بها رابط Zapier. تحتوي صفحة Admin → Settings → API Keys على زر نسخ بضغطة واحدة يملأ مسبقًا أمر اشتراك برابط مدونتك الأساسي، فتكون مهمتك الأساسية لصق رابط webhook من Make والحدث المطلوب. أما مستخدمو n8n فلديهم الآن مسار أقصر — انظر القسم التالي، إذ توفّر VeloCMS عقدة أصلية موثّقة هناك.
هل توجد عقدة VeloCMS أصلية في n8n؟
نعم — ومنذ يوليو 2026 أصبحت عقدة موثّقة على n8n Cloud، ما يعني أنك تستطيع تجاوز إعداد الـ webhook بالكامل. افتح لوحة عمل n8n، ابحث عن VeloCMS، واسحب العقدة مباشرة إلى مسار العمل: فهي تجمع المحفّزات (منشورات جديدة، طلبات، أعضاء، وبقية كتالوج الأحداث) والإجراءات (إنشاء منشورات، إدارة الأعضاء) خلف إعداد اعتماد بسيط لا يطلب سوى مفتاح API الخاص بك. إن كنت تستضيف n8n ذاتيًا، فثبّت n8n-nodes-velocms من لوحة عقد المجتمع — وهي الحزمة الموثّقة نفسها — وتأكد من تفعيل خيار Verified Community Nodes في إعدادات المسؤول لديك. لا يزال مسار الـ webhook العام المذكور في القسم السابق يعمل جيدًا؛ العقدة الأصلية ببساطة أقل عناءً.
ماذا لو أردت الاختبار قبل ربط أي شيء حقيقي؟
هناك خياران، ولا تحتاج إلى نشر محتوى حقيقي لأيّهما. الأول، لكل اشتراك استدعاء اختبار مدمج يُرسل حدث test.ping إلى رابطك فورًا، موقّعًا بـ HMAC تمامًا كما في حركة الإنتاج الحقيقية. الثاني، هناك نقطة نهاية للاستقصاء (/api/v1/webhooks/events) تُعيد قراءة آخر مئة تسليم لحدث معيّن — مفيدة لخطوة "Test" الخاصة بـ Zapier، أو لسيناريو في Make يستقصي بدلًا من التقاط hook مباشر. لا يتطلب أيٌّ منهما لمس محتوى مدونتك الفعلي.
هل تسليم webhooks موثوق؟ وهل تُعاد المحاولة عند الفشل؟
نعم — تُسجَّل كل محاولة تسليم قبل أن يحاول VeloCMS استدعاء HTTP أصلًا، لذا لا يُفقد شيء بصمت. إذا لم تُعِد نقطة نهايتك حالة 2xx، يُعيد VeloCMS المحاولة وفق جدول متصاعد: خمس دقائق، ثم ثلاثون دقيقة، ثم ساعتان، ثم ست ساعات، ثم أربع وعشرون ساعة — ست محاولات إجمالًا. بعد فشل جميع المحاولات الست، يُعطَّل الاشتراك تلقائيًا وتصلك رسالة بريد إلكتروني حتى لا تبقى حائرًا حول سبب توقف وصول الأحداث. يمكنك مراجعة كل محاولة، بما في ذلك حالة HTTP والاستجابة، من صفحة إعدادات API Keys نفسها.
مفتاح الـ API الخاص بك وسر الـ webhook كلاهما بيانات اعتماد حاملة — تعامل معهما كما تتعامل مع كلمات المرور. لا تُضمّنهما أبدًا في مستودع عام ولا تُدرجهما في لقطة شاشة. إذا تسرّب أيٌّ منهما، ألغِ المفتاح من Admin → Settings → API Keys وأنشئ مفتاحًا جديدًا؛ ستحتاج أي Zaps أو سيناريوهات قائمة إلى المفتاح الجديد.