تخطَّ إلى المحتوى

Webhooks

يخبر Webhook أنظمتك لحظة نشر المنشور. ففي كل مرة يتم فيها نشر منشور، يرسل شارك تفاصيله إلى عنوان تختاره: سير عمل في n8n، أو سكربت على خادمك، أو أي شيء يستقبل طلب HTTP.

ليست ضمن كل الخطط. لا يظهر تبويب ويب هوكس في الإعدادات إلا حين تتضمن خطتك Webhooks. راجع الأسعار.

حين يتم نشر منشور على قناة يغطيها 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.

بعض ما ينبغي أن تحسب حسابه:

  • طلب لكل قناة. المنشور على ثلاث قنوات هو ثلاثة منشورات في شارك، فيرسل كل منها طلبه الخاص حين يتم نشره.
  • سلسلة النقاش تصل مرة واحدة. في المنشور الذي له ردود، ينتظر شارك حتى يكتمل نشر السلسلة كلها، ثم يرسل المنشور الأول وحده.
  • ما يتم نشره فقط. فالمنشور الذي يفشل نشره لا يرسل شيئًا.
  • بأفضل جهد. يرسل شارك كل طلب مرة واحدة. ويتجاهل رد خادمك ولا يعيد المحاولة أبدًا، فالطلب الذي فاتك وخادمك متوقف يبقى فائتًا. ولا يؤثر فشل الإرسال في المنشور أبدًا.
  • بلا توقيع. لا يحمل الطلب سرًا ولا توقيعًا، فمن يملك الرابط يستطيع أن يرسل إلى خادمك طلبًا يبدو مثله تمامًا. احتفظ بالرابط سرًا واجعله صعب التخمين.
  1. في شارك، افتح الإعدادات، ثم تبويب ويب هوكس. وتشرح الإعدادات بقية التبويبات.
  2. اضغط إضافة رابط ويب. فتفتح نافذة إضافة ويب هوك.
  3. اكتب في الاسم اسمًا تعرفه به، والصق عنوان نقطة النهاية لديك في الرابط. ويجب أن يكون عنوان HTTPS عامًا: فعناوين http:// وlocalhost وعناوين الشبكات الخاصة مرفوضة.
  4. اترك جميع التكاملات ليصلك كل منشور على كل القنوات، أو اختر تكاملات محددة ثم حدد القنوات. والتكاملات هنا تعني قنواتك.
  5. اضغط إرسال اختبار لتفحص العنوان كما هو موضح أدناه، ثم اضغط حفظ.

يبقى حفظ وإرسال اختبار معطلين حتى تملأ الاسم، ويحمل الرابط عنوانًا صالحًا، وتختار قناة واحدة على الأقل إن اخترت تكاملات محددة.

بعد حفظ، تأكد أن Webhook يظهر في القائمة بالعنوان الذي أدخلته. فإن لم يظهر، فقد رفض شارك العنوان، لأنه ليس عنوان HTTPS عامًا يستطيع شارك الوصول إليه.

يرسل إرسال اختبار عينة ثابتة إلى العنوان المكتوب في الرابط، فتستطيع تجربة العنوان قبل حفظه. والعينة مصفوفة من منشورين وهميين، أحدهما على Instagram والآخر على Facebook، بالشكل الموضح أعلاه. أما الإرسال الحقيقي فيحمل منشورًا واحدًا: منشورك.

يعرض شارك تم إرسال الويب هوك فور الضغط، سواء وصل الطلب إلى خادمك أم لا، فتحقق من جهتك أنه وصل. وإن لم يصل شيء، فإما أن شارك رفض العنوان بالقاعدة نفسها التي يطبقها حفظ، وإما أن خادمك لا يقبل طلب POST على هذا العنوان.

يسرد التبويب ما لديك من Webhooks في عمودي الاسم والرابط (URL).

  • يفتح تعديل النافذة من جديد باسم تحديث Webhook، وفيها كل حقل كما تركته. وبعد تعديل ما تحتاج إليه، اضغط حفظ.
  • يطلب حذف تأكيدك أولًا. أكد بزر نعم، احذفه! فيتوقف Webhook عن استقبال المنشورات فورًا.

يتوقف عدد ما تستطيع إضافته من Webhooks على خطتك. ويعرض رأس التبويب عدد ما لديك بجانب العدد الذي تسمح به خطتك. وعند بلوغ الحد، يفتح حفظ على Webhook جديد نافذة وصلت إلى حد الويب هوك بدلًا من ذلك. وحذف Webhook يحرر مكانه. راجع الأسعار.

  • n8n: ابدأ سير عمل بعقدة المشغل Webhook في n8n، واضبط HTTP Method فيها على POST. ولتجربتها، الصق Test URL الخاص بها في الرابط، واختر Listen for test event في n8n، ثم اضغط إرسال اختبار؛ فلا يستقبل n8n طلب الاختبار إلا وهو ينصت. وبعد أن تنشر سير العمل، اضغط تعديل على Webhook والصق Production URL بدلًا منه. ويجب أن تكون نسخة n8n متاحة عبر HTTPS عام. ولتتصرف في شارك من سير العمل نفسه، أضف عقدة شارك.
  • خادمك: يكفي أي عنوان HTTPS يقبل طلب POST بصيغة JSON. اقرأ المصفوفة، واستخدم id المنشور مع واجهة API العامة للتصرف فيه، مثل قراءة تحليلاته.