الـ Webhook رسالة يرسلها تطبيق إلى آخر لحظة وقوع حدث. تعرّف على طريقة عمل Webhooks، وكيفية التحقق منها، وما يرسله sona.to.
الـ webhook رسالة يرسلها تطبيق إلى تطبيق آخر لحظة وقوع حدث ما، فلا يحتاج التطبيق الثاني إلى السؤال باستمرار. تعطي التطبيق الأول عنوانًا، فيرسل إليه تفاصيل كل حدث فور حدوثه. يشرح هذا الدليل ما هو webhook وكيف يعمل، وكيف تتحقق من أنه أصلي، وما الذي يرسله sona.to، وهو ما تلخّصه أيضًا صفحة Webhooks.
ما هو webhook؟
تتبادل معظم التطبيقات البيانات بطريقتين. مع API، يسأل نظامك: "هل نُشر المنشور بعد؟"، ثم يسأل مجددًا لاحقًا إذا كانت الإجابة لا. ومع webhook، يخبرك التطبيق بنفسه: حين يُنشر المنشور، يرسل طلبًا إلى عنوان اخترته، مع تفاصيل المنشور.
الـ webhook إذن طلب HTTP، عادةً من نوع POST بمحتوى JSON، يُرسل إلى URL تتحكم فيه. وقد يكون هذا URL خادمك الخاص، أو عنوان webhook تعطيك إياه n8n أو Zapier أو Make أو Slack أو خدمة أخرى تبدأ سير عمل حين يصل الطلب.
الفرق بين webhook وAPI
الـ API للسؤال والتغيير: عرض المنشورات، وإنشاء منشور، وقراءة الأرقام. والـ webhook لتلقي الإخطار. وتستخدم معظم عمليات الربط الاثنين معًا: API لإنشاء منشور، وwebhook لمعرفة متى نُشر أو فشل. فسؤال API مرة بعد مرة يهدر الطلبات ويكتشف الأمر متأخرًا مع ذلك، بينما يصل webhook فور وقوع الحدث.
كيف تتحقق من webhook
يمكن لأي شخص يعرف عنوان webhook الخاص بك أن يرسل إليه طلبًا مزيفًا، لذلك يكون الـ webhook المصمم جيدًا موقّعًا. يحسب المرسل توقيعًا من المحتوى ومن سر مشترك، عادةً باستخدام HMAC SHA-256، ويضعه في ترويسة. ويحسب جانبك التوقيع نفسه بالسر نفسه ويقارن بين القيمتين بمقارنة ثابتة الزمن. وإذا اختلفتا، يُتجاهل الطلب.
كما أن تضمين طابع زمني في البيانات الموقعة يمنع إعادة الإرسال: فالطلب الذي التُقط مرة لا يمكن إرساله لاحقًا، لأن طابعه الزمني يكون قديمًا جدًا.
Webhooks في sona.to
يرسل sona.to إشعارات webhook لأربعة أحداث: نُشر منشور، وفشل منشور، واكتمل فحص موقع، وفشل فحص موقع. وتختار الأحداث التي يتلقاها كل webhook، فيمكن لأداة تنبيه في المحادثة أن تستمع إلى حالات الفشل فقط بينما يتلقى جدول التقارير كل شيء. وتستخدم البيانات المرسلة أسماء الحقول نفسها التي تستخدمها API من sona.to.
الإعداد. في صفحة API في لوحة التحكم، الصق العنوان، وحدد الأحداث، واحفظ. يظهر سر التوقيع مرة واحدة في تلك اللحظة، فانسخه حينها.
التوقيع. يحمل كل إرسال ترويسة فيها طابع زمني وقيمة HMAC SHA-256 للطابع الزمني والمحتوى، محسوبة بسرّك. ارفض الطلبات التي يزيد عمر طابعها الزمني على بضع دقائق.
إعادة المحاولة. إذا كان عنوانك متوقفًا أو أعاد خطأ، يُعاد الإرسال بعد 60 ثانية ثم 5 دقائق ثم 30 دقيقة. وتُسجَّل كل محاولة مع رمز الحالة والمدة. والعنوان الذي يستمر في الفشل يُعطَّل، ويمكنك إعادة تفعيله بعد إصلاحه.
الأمان. يجب أن يستخدم العنوان https وأن يشير إلى خادم عام. وتُرفض العناوين على الشبكات الخاصة عند الحفظ ومرة أخرى عند الإرسال، ولا تُتبع عمليات إعادة التوجيه.
Webhooks مع n8n وZapier وMake
تملك تطبيقات sona.to في n8n وZapier وMake مشغّلات جاهزة للأحداث الأربعة نفسها، فلا تحتاج إلى لصق عنوان بنفسك: أضف المشغّل ويضبط التطبيق الـ webhook. راجع أتمتة السوشيال ميديا مع n8n وZapier وMake.
التفاصيل الكاملة، مع مثال على التحقق من التوقيع، موجودة في توثيق API.
الأسئلة الشائعة
هل الـ webhook هو نفسه API؟
لا. الـ API تجيب حين تسأل. والـ webhook يرسل إليك رسالة حين يحدث شيء.
هل Webhooks في sona.to مجانية؟
الـ Webhooks متاحة في كل الخطط، إلى جانب API.
ماذا يحدث إذا كان خادمي متوقفًا؟
يعيد sona.to المحاولة ثلاث مرات على مدى نصف ساعة تقريبًا. وإذا استمر فشل الإرسال، يُعطَّل الـ webhook حتى تعيد تفعيله.
هل أنت مستعد لتجربته؟
ابدأ مجانًا، دون الحاجة إلى بطاقة ائتمان.
