Which events can trigger a webhook?

VeloCMS currently fires webhooks on four events: post.published (fires when a post is published or a scheduled post goes live — payload includes the post title, slug, URL, excerpt, author, and publish timestamp), subscriber.created (fires when a reader creates a free or paid account — payload includes the email, plan, and timestamp), subscriber.cancelled (fires when a paid subscriber cancels — payload includes email, plan, and cancellation reason), and order.completed (fires when a commerce o...

How do I set up a Zapier zap for new posts?

In Zapier, create a new zap and choose Webhooks by Zapier as the trigger. Select Catch Hook as the event. Zapier gives you a unique webhook URL — copy that URL. In VeloCMS, go to Admin → Settings → Integrations → Webhooks, paste the URL, check the post.published event, and save. Back in Zapier, click Test Trigger — you'll need to publish a test post in VeloCMS (or use the Send Test Event button in VeloCMS's webhook settings) so Zapier can see the payload structure. Once Zapier captures the te...

How do I set up an n8n workflow for VeloCMS?

In n8n, add a Webhook trigger node and copy the production webhook URL. Paste that URL into VeloCMS's webhook settings exactly as you would for Zapier. The n8n workflow receives the same JSON payload as Zapier. n8n is a particularly good match for VeloCMS power users because it's self-hostable (no per-task pricing), supports JavaScript functions inside workflows, and has native HTTP nodes that can call the VeloCMS REST API to pull additional post data beyond what the webhook payload includes.

Are webhook deliveries reliable and do they retry on failure?

VeloCMS delivers webhooks with at-least-once semantics — if the receiving server returns a non-2xx HTTP status or doesn't respond within 10 seconds, VeloCMS retries the delivery three more times with exponential backoff (5 seconds, 25 seconds, 125 seconds). After four failed attempts the delivery is marked as failed and logged in Admin → Settings → Integrations → Webhook delivery log. The log shows each delivery attempt's timestamp, HTTP status, and response body so you can diagnose failures....

كيف أربط Zapier أو n8n بـ VeloCMS؟

يتكامل VeloCMS مع Zapier وn8n وMake (المعروف سابقًا بـ Integromat)، وأي منصة أتمتة أخرى تقبل webhooks الصادرة. انتقل إلى Admin → Settings → Integrations → Webhooks، أضف عنوان URL لنقطة النهاية الجديدة (رابط webhook الخاص بـ Zapier أو رابط محفّز webhook في n8n)، اختر الأحداث التي تريد تشغيلها، ثم انقر على حفظ. سيُرسل VeloCMS طلب HTTP POST يحتوي على بيانات JSON إلى ذلك الرابط في كل مرة يقع فيها الحدث المحدد.

ما الأحداث التي يمكنها تشغيل webhook؟

يُطلق VeloCMS حاليًا webhooks على أربعة أحداث: post.published (يُطلَق عند نشر منشور أو انتهاء جدولة منشور مقرر — تتضمن البيانات عنوان المنشور والـ slug والرابط والمقتطف والمؤلف وتوقيت النشر)، وsubscriber.created (يُطلَق عند إنشاء قارئ حسابًا مجانيًا أو مدفوعًا — تتضمن البيانات البريد الإلكتروني والخطة والتوقيت)، وsubscriber.cancelled (يُطلَق عند إلغاء مشترك مدفوع لاشتراكه — تتضمن البيانات البريد الإلكتروني والخطة وسبب الإلغاء)، وorder.completed (يُطلَق عند إتمام طلب تجاري — تتضمن البيانات معرّف الطلب والإجمالي والمنتجات المطلوبة). الحدث post.published هو الأكثر استخدامًا لأتمتة وسائل التواصل الاجتماعي.

كيف أُعدّ Zap في Zapier للمنشورات الجديدة؟

في Zapier، أنشئ Zap جديدًا واختر Webhooks by Zapier كمحفّز. حدّد Catch Hook كحدث. سيمنحك Zapier رابط webhook فريدًا — انسخ ذلك الرابط. في VeloCMS، انتقل إلى Admin → Settings → Integrations → Webhooks، الصق الرابط، ضع علامة على حدث post.published، ثم احفظ. عُد إلى Zapier وانقر على Test Trigger — ستحتاج إلى نشر منشور اختباري في VeloCMS (أو استخدام زر Send Test Event في إعدادات webhook بـ VeloCMS) حتى يتمكن Zapier من رؤية بنية البيانات. بمجرد التقاط Zapier للحدث التجريبي، يمكنك بناء إجراءات من قبيل النشر في قناة Slack، أو إضافة صف إلى جدول Google Sheets، أو المشاركة على X/Twitter.

كيف أُعدّ سير عمل n8n لـ VeloCMS؟

في n8n، أضف عقدة محفّز Webhook وانسخ رابط webhook الإنتاجي. الصق ذلك الرابط في إعدادات webhook الخاصة بـ VeloCMS تمامًا كما تفعل مع Zapier. يستقبل سير عمل n8n نفس بيانات JSON التي يستقبلها Zapier. يُعدّ n8n ملاءمةً ممتازة لمستخدمي VeloCMS المتقدمين لأنه قابل للاستضافة الذاتية (بلا تسعير لكل مهمة)، ويدعم دوال JavaScript داخل سير العمل، ولديه عقد HTTP أصلية يمكنها استدعاء VeloCMS REST API لجلب بيانات إضافية عن المنشور تتجاوز ما تحتويه بيانات webhook.

هل تسليم webhooks موثوق؟ وهل تُعاد المحاولة عند الفشل؟

يُسلّم VeloCMS الـ webhooks بضمان التسليم مرة واحدة على الأقل — فإذا أعاد الخادم المستقبِل حالة HTTP غير 2xx، أو لم يستجب خلال 10 ثوانٍ، يُعيد VeloCMS المحاولة ثلاث مرات إضافية مع تراجع أسي (5 ثوانٍ، ثم 25 ثانية، ثم 125 ثانية). بعد أربع محاولات فاشلة، يُصنَّف التسليم كفاشل ويُسجَّل في Admin → Settings → Integrations → Webhook delivery log. يعرض السجل توقيت كل محاولة تسليم وحالة HTTP وجسم الاستجابة حتى تتمكن من تشخيص الأعطال. وإذا توقفت منصة الأتمتة الخاصة بك للصيانة، يمكنك إعادة إرسال عمليات التسليم الفاشلة يدويًا من السجل.

تستقبل روابط Webhook بيانات النشاط على مدونتك — تعامل معها كمفاتيح API. لا تنشرها في مستودعات GitHub العامة ولا تشاركها في لقطات الشاشة. إذا تعرّض رابط webhook للاختراق، احذف نقطة النهاية من لوحة التكاملات في VeloCMS وأنشئ رابطًا جديدًا في منصة الأتمتة.