ویب ہُک چند سیکنڈ میں کسی دوسرے سسٹم کو آپ کے پروجیکٹس کی ہر تبدیلی کے بارے میں بتاتا ہے۔ صرف ایڈمنز اسے شامل کر سکتے ہیں۔

ویب ہُک شامل کریں

  1. سائیڈ بار میں ترتیبات › AI ایجنٹس کھولیں۔ ویب ہُکس اور Slack کارڈ تلاش کریں۔
  2. وہ ایڈریس چسپاں کریں جو ایونٹس وصول کرے۔ اسے https:// سے شروع ہونا چاہیے اور انٹرنیٹ سے پہنچنے کے قابل ہونا چاہیے۔
  3. فارمیٹ چنیں:
    • JSON، دستخط شدہ: آپ کے اپنے کوڈ، Zapier، Make، n8n اور اسی طرح کے ٹولز کے لیے؛
    • Slack ان کمنگ ویب ہُک: Slack چینل میں ہر ایونٹ کی ایک پڑھنے کے قابل سطر۔
  4. ویب ہُک شامل کریں دبائیں۔

ترتیبات › AI ایجنٹس میں ویب ہُکس اور Slack کارڈ: ایڈریس شامل کرنے کا فارم، اور ایک ویب ہُک اپنی آخری ڈیلیوری کے ساتھ۔ترتیبات › AI ایجنٹس میں ویب ہُکس اور Slack کارڈ: ایڈریس شامل کرنے کا فارم، اور ایک ویب ہُک اپنی آخری ڈیلیوری کے ساتھ۔

JSON کے لیے دستخطی خفیہ کلید ابھی کاپی کریں۔ یہ دوبارہ نہیں دکھائی جاتی۔

Slack میں پوسٹ کریں

  1. Slack میں، جس چینل کے لیے چاہیں اس کا ان کمنگ ویب ہُک بنائیں۔ Slack آپ کو ایسا ایڈریس دیتا ہے جو https://hooks.slack.com/ سے شروع ہوتا ہے۔
  2. اسے Notiamo میں فارمیٹ Slack ان کمنگ ویب ہُک کے ساتھ شامل کریں۔

ہر سطر بتاتی ہے کہ کس نے کس پروجیکٹ پر کیا کیا، تبصرے کے لنک کے ساتھ۔ Slack کی سطریں انگریزی میں ہیں۔

کیا بھیجا جاتا ہے

ہر نیا تبصرہ، جواب، حالت کی تبدیلی اور سونپنا، نیز ترمیمات اور حذف شدہ جوابات۔ اندرونی نوٹس شامل ہیں اور نشان زد ہیں: ویب ہُکس ایجنسی کو جاتے ہیں، کلائنٹس کو نہیں۔

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 کلیدیں

Notiamo کی API کلیدیں ایجنٹ کلیدیں ہیں۔ وہ https://my.notiamo.com/api/mcp پر MCP سرور کھولتے ہیں، جسے کوئی بھی MCP کلائنٹ تبصروں کی فہرست بنانے، انہیں پڑھنے، جواب دینے، سونپنے اور اپ ڈیٹ کرنے کے لیے استعمال کر سکتا ہے۔ ایک ترتیبات › AI ایجنٹس › ایجنٹ کلیدیں میں بنائیں، صرف پڑھنے والا یا مکمل، تمام پروجیکٹس کے لیے یا ایک کے لیے۔ جو MCP کلائنٹ سائن اِن (OAuth) سپورٹ کرتا ہے اسے کلید کی ضرورت نہیں۔ دیکھیں AI ایجنٹ جوڑیں۔

پروجیکٹ کے تمام تبصرے فائل کی صورت میں پانے کے لیے، پروجیکٹ کا صفحہ کھولیں اور CSV ایکسپورٹ کریں یا JSON ایکسپورٹ کریں دبائیں۔