Webhooks
يخبر Webhook أنظمتك لحظة نشر المنشور. ففي كل مرة يتم فيها نشر منشور، يرسل شارك تفاصيله إلى عنوان تختاره: سير عمل في n8n، أو سكربت على خادمك، أو أي شيء يستقبل طلب HTTP.
ليست ضمن كل الخطط. لا يظهر تبويب ويب هوكس في الإعدادات إلا حين تتضمن خطتك Webhooks. راجع الأسعار.
ما الذي يرسله Webhook
Section titled “ما الذي يرسله Webhook”حين يتم نشر منشور على قناة يغطيها Webhook، يرسل شارك طلب POST واحدًا إلى رابط Webhook،
مع Content-Type: application/json. وجسم الطلب مصفوفة JSON تضم المنشور الذي تم نشره للتو:
[ { "id": "post-id", "content": "<p>Our new release is out</p>", "publishDate": "2026-09-01T10:00:00.000Z", "releaseURL": "https://x.com/your-handle/status/1234567890", "state": "PUBLISHED", "integration": { "id": "channel-id", "name": "Sharek on X", "providerIdentifier": "x", "picture": "https://example.com/avatar.png", "type": "social" } }]| الحقل | الوصف |
|---|---|
id |
معرف المنشور في شارك، وهو الذي تستخدمه واجهة API العامة. |
content |
نص المنشور كما يحفظه شارك. والنص المكتوب في المحرر يصل بصيغة HTML، مثل <p>…</p>. |
publishDate |
الموعد المحدد لنشر المنشور، بتوقيت UTC. |
releaseURL |
رابط المنشور الحي على المنصة. |
state |
PUBLISHED. |
integration |
القناة التي تم النشر عليها: معرفها id، واسمها على المنصة name (لا يظهر هنا اسم ضبطته عبر إعادة تسمية القناة)، وproviderIdentifier للمنصة مثل x أو linkedin-page، وصورتها picture، وtype وقيمته social. |
بعض ما ينبغي أن تحسب حسابه:
- طلب لكل قناة. المنشور على ثلاث قنوات هو ثلاثة منشورات في شارك، فيرسل كل منها طلبه الخاص حين يتم نشره.
- سلسلة النقاش تصل مرة واحدة. في المنشور الذي له ردود، ينتظر شارك حتى يكتمل نشر السلسلة كلها، ثم يرسل المنشور الأول وحده.
- ما يتم نشره فقط. فالمنشور الذي يفشل نشره لا يرسل شيئًا.
- بأفضل جهد. يرسل شارك كل طلب مرة واحدة. ويتجاهل رد خادمك ولا يعيد المحاولة أبدًا، فالطلب الذي فاتك وخادمك متوقف يبقى فائتًا. ولا يؤثر فشل الإرسال في المنشور أبدًا.
- بلا توقيع. لا يحمل الطلب سرًا ولا توقيعًا، فمن يملك الرابط يستطيع أن يرسل إلى خادمك طلبًا يبدو مثله تمامًا. احتفظ بالرابط سرًا واجعله صعب التخمين.
أضف Webhook
Section titled “أضف Webhook”- في شارك، افتح الإعدادات، ثم تبويب ويب هوكس. وتشرح الإعدادات بقية التبويبات.
- اضغط إضافة رابط ويب. فتفتح نافذة إضافة ويب هوك.
- اكتب في الاسم اسمًا تعرفه به، والصق عنوان نقطة النهاية لديك في الرابط. ويجب أن
يكون عنوان HTTPS عامًا: فعناوين
http://وlocalhostوعناوين الشبكات الخاصة مرفوضة. - اترك جميع التكاملات ليصلك كل منشور على كل القنوات، أو اختر تكاملات محددة ثم حدد القنوات. والتكاملات هنا تعني قنواتك.
- اضغط إرسال اختبار لتفحص العنوان كما هو موضح أدناه، ثم اضغط حفظ.
يبقى حفظ وإرسال اختبار معطلين حتى تملأ الاسم، ويحمل الرابط عنوانًا صالحًا، وتختار قناة واحدة على الأقل إن اخترت تكاملات محددة.
بعد حفظ، تأكد أن Webhook يظهر في القائمة بالعنوان الذي أدخلته. فإن لم يظهر، فقد رفض شارك العنوان، لأنه ليس عنوان HTTPS عامًا يستطيع شارك الوصول إليه.
أرسل اختبارًا
Section titled “أرسل اختبارًا”يرسل إرسال اختبار عينة ثابتة إلى العنوان المكتوب في الرابط، فتستطيع تجربة العنوان قبل حفظه. والعينة مصفوفة من منشورين وهميين، أحدهما على Instagram والآخر على Facebook، بالشكل الموضح أعلاه. أما الإرسال الحقيقي فيحمل منشورًا واحدًا: منشورك.
يعرض شارك تم إرسال الويب هوك فور الضغط، سواء وصل الطلب إلى خادمك أم لا، فتحقق من جهتك
أنه وصل. وإن لم يصل شيء، فإما أن شارك رفض العنوان بالقاعدة نفسها التي يطبقها حفظ، وإما
أن خادمك لا يقبل طلب POST على هذا العنوان.
تعديل Webhook أو حذفه
Section titled “تعديل Webhook أو حذفه”يسرد التبويب ما لديك من Webhooks في عمودي الاسم والرابط (URL).
- يفتح تعديل النافذة من جديد باسم تحديث Webhook، وفيها كل حقل كما تركته. وبعد تعديل ما تحتاج إليه، اضغط حفظ.
- يطلب حذف تأكيدك أولًا. أكد بزر نعم، احذفه! فيتوقف Webhook عن استقبال المنشورات فورًا.
كم Webhook تستطيع إضافته
Section titled “كم Webhook تستطيع إضافته”يتوقف عدد ما تستطيع إضافته من Webhooks على خطتك. ويعرض رأس التبويب عدد ما لديك بجانب العدد الذي تسمح به خطتك. وعند بلوغ الحد، يفتح حفظ على Webhook جديد نافذة وصلت إلى حد الويب هوك بدلًا من ذلك. وحذف Webhook يحرر مكانه. راجع الأسعار.
مع n8n أو مع خادمك
Section titled “مع n8n أو مع خادمك”- n8n: ابدأ سير عمل بعقدة المشغل Webhook في n8n، واضبط HTTP Method فيها على POST. ولتجربتها، الصق Test URL الخاص بها في الرابط، واختر Listen for test event في n8n، ثم اضغط إرسال اختبار؛ فلا يستقبل n8n طلب الاختبار إلا وهو ينصت. وبعد أن تنشر سير العمل، اضغط تعديل على Webhook والصق Production URL بدلًا منه. ويجب أن تكون نسخة n8n متاحة عبر HTTPS عام. ولتتصرف في شارك من سير العمل نفسه، أضف عقدة شارك.
- خادمك: يكفي أي عنوان HTTPS يقبل طلب
POSTبصيغة JSON. اقرأ المصفوفة، واستخدمidالمنشور مع واجهة API العامة للتصرف فيه، مثل قراءة تحليلاته.