Вебхук повідомляє іншу систему про кожну зміну у ваших проєктах упродовж секунд. Додавати його можуть лише адміністратори.

Додайте вебхук

  1. На бічній панелі відкрийте Налаштування › ШІ-агенти. Знайдіть картку Вебхуки та Slack.
  2. Вставте Адреса, яка має отримувати події. Вона повинна починатися з https:// і бути доступною з інтернету.
  3. Оберіть Формат:
    • JSON, з підписом: для вашого власного коду, Zapier, Make, n8n та подібних інструментів;
    • Вхідний вебхук Slack: один читабельний рядок на подію в каналі Slack.
  4. Натисніть Додати вебхук.

Картка «Вебхуки та Slack» у «Налаштування › ШІ-агенти»: форма для додавання адреси та один вебхук з останньою доставкою.Картка «Вебхуки та 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

Ключі API Notiamo — це ключі агентів. Вони відкривають сервер MCP за адресою https://my.notiamo.com/api/mcp, яким може користуватися будь-який клієнт MCP, щоб переглядати, читати, відповідати, призначати та оновлювати коментарі. Створіть ключ у Налаштування › ШІ-агенти › Ключі агентів, лише для читання або повний, для всіх проєктів чи одного. Клієнтові MCP, який підтримує вхід (OAuth), ключ не потрібен. Див. Підключіть ШІ-агента.

Щоб отримати всі коментарі проєкту як файл, відкрийте сторінку проєкту й натисніть Експорт у CSV або Експорт у JSON.