الـ webhook بيبلّغ نظام تاني بكل تغيير على مشاريعك، في ثواني. الأدمن بس يقدروا يضيفوا واحد.

ضيف webhook

  1. من الشريط الجانبي، افتح الإعدادات › وكلاء الذكاء الاصطناعي. دوّر على كارت Webhooks وSlack.
  2. الصق العنوان اللي المفروض يستقبل الأحداث. لازم يبدأ بـ https:// ويتوصّل له من الإنترنت.
  3. اختار الصيغة:
    • JSON، موقّع: لكودك إنت، وZapier وMake وn8n وأدوات شبههم؛
    • Slack incoming webhook: سطر مقروء لكل حدث في قناة Slack.
  4. اضغط ضيف webhook.

كارت Webhooks وSlack في الإعدادات › وكلاء الذكاء الاصطناعي: فورم إضافة عنوان، وwebhook واحد مع آخر تسليم ليه.كارت Webhooks وSlack في الإعدادات › وكلاء الذكاء الاصطناعي: فورم إضافة عنوان، وwebhook واحد مع آخر تسليم ليه.

لـ JSON، انسخ مفتاح التوقيع دلوقتي. مابيظهرش تاني.

انشر في Slack

  1. في Slack، اعمل incoming webhook للقناة اللي عايزها. Slack بيديك عنوان بيبدأ بـ https://hooks.slack.com/.
  2. ضيفه في Notiamo بالصيغة Slack incoming webhook.

كل سطر بيقول مين عمل إيه، على أنهي مشروع، مع لينك للتعليق. سطور Slack بالإنجليزي.

اللي بيتبعت

كل تعليق ورد وتغيير حالة وإسناد جديد، وكمان التعديلات والردود الممسوحة. الملاحظات الداخلية متضمنة وعليها علامة: الـ webhooks بتروح للوكالة، مش للعملاء.

التسليم بـ JSON هو POST بالجسم ده:

{
  "delivery": "a-unique-id",
  "events": [
    {
      "id": 1234,
      "event": "comment_created",
      "at": "2026-10-14T09:30:00.000Z",
      "internal": false,
      "viaAgent": false,
      "actor": { "name": "Claire Martin" },
      "project": { "id": "…", "name": "Main website" },
      "comment": { "id": "…", "number": 12, "type": "highlight", "title": null, "text": "…", "page": "/pricing", "url": "https://example.com/pricing", "status": "open", "link": "https://my.notiamo.com/comments/…" }
    }
  ]
}

أسماء الأحداث التانية هي reply_created وstatus_changed وassigned وcomment_edited وreply_edited وreply_deleted. حسب الحدث، فيه كمان reply وstatus (from وto) وassignee أو mentions. النصوص بتتقص عند 500 حرف؛ اتبع link للتعليق كامل.

تقرير المهمة اللي بينتقل بيبعت job.state_changed، مع job: from وto (draft أو ready أو article_waiting أو changes_requested أو approved أو posts_delivered)، وcommentId وnumber. الرجوع لـ draft بيتبعت كمان؛ Slack بيسيبه.

اتحقق من التوقيع

كل تسليم JSON فيه هيدرين:

  • X-Notiamo-Delivery: نفس الرقم اللي في delivery في الجسم؛
  • X-Notiamo-Signature: sha256= وبعده HMAC-SHA256 للجسم الخام، معمول بمفتاح التوقيع بتاعك.

احسب نفس القيمة عندك وقارن. ارفض الطلب لو مختلف.

لما السيرفر بتاعك مايردش

الكارت بيعرض آخر تسليم، وكود الحالة اللي سيرفرك رد بيه، وكام فشل ورا بعض. Notiamo بيحاول تاني: على طول، وبعدين بعد 15 و30 و45 دقيقة، وبعدين كل ساعة. مفيش حاجة بتضيع وهو مستني. علشان توقف التسليم، اضغط امسح.

مفاتيح API

مفاتيح API في Notiamo هي مفاتيح الوكلاء. بتفتح سيرفر MCP على https://my.notiamo.com/api/mcp، اللي أي عميل MCP يقدر يستخدمه علشان يعرض ويقرا ويرد ويسند ويحدّث التعليقات. اعمل واحد من الإعدادات › وكلاء الذكاء الاصطناعي › مفاتيح الوكلاء، للقراءة بس أو كامل، لكل المشاريع أو لمشروع واحد. عميل MCP اللي بيدعم تسجيل الدخول (OAuth) مش محتاج مفتاح. شوف اربط وكيل ذكاء اصطناعي.

علشان تاخد كل تعليقات مشروع كملف، افتح صفحة المشروع واضغط تصدير CSV أو تصدير JSON.