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

Добавьте вебхук

  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.