يخبر الـwebhook نظامًا آخر بكل تغيير في مشاريعك، خلال ثوانٍ. المشرفون وحدهم يستطيعون إضافة واحد.

أضف webhook

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

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

مع JSON، انسخ سر التوقيع الآن. لا يظهر مرة أخرى.

انشر في Slack

  1. في Slack، أنشئ webhook واردًا للقناة التي تريدها. يعطيك Slack عنوانًا يبدأ بـhttps://hooks.slack.com/.
  2. أضفه في Notiamo بالصيغة Webhook وارد في Slack.

يذكر كل سطر من فعل ماذا، وفي أي مشروع، مع رابط التعليق. وأسطر 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.