Webhook informuje inny system o każdej zmianie w Twoich projektach, w kilka sekund. Dodać go mogą tylko administratorzy.

Dodaj webhook

  1. Na pasku bocznym otwórz Ustawienia › Agenci AI. Znajdź kartę Webhooki i Slack.
  2. Wklej Adres, który ma odbierać zdarzenia. Musi zaczynać się od https:// i być osiągalny z internetu.
  3. Wybierz Format:
    • JSON, podpisany: dla Twojego kodu, Zapier, Make, n8n i podobnych narzędzi;
    • Przychodzący webhook Slacka: jeden czytelny wiersz na zdarzenie w kanale Slacka.
  4. Kliknij Dodaj webhook.

Karta Webhooki i Slack w Ustawieniach › Agenci AI: formularz dodawania adresu i jeden webhook z ostatnią dostawą.Karta Webhooki i Slack w Ustawieniach › Agenci AI: formularz dodawania adresu i jeden webhook z ostatnią dostawą.

Dla JSON skopiuj teraz sekret podpisu. Nie zostanie pokazany ponownie.

Wysyłaj do Slacka

  1. W Slacku utwórz przychodzący webhook dla wybranego kanału. Slack poda adres zaczynający się od https://hooks.slack.com/.
  2. Dodaj go w Notiamo z formatem Przychodzący webhook Slacka.

Każdy wiersz mówi, kto co zrobił, w którym projekcie, z linkiem do komentarza. Wiersze w Slacku są po angielsku.

Co jest wysyłane

Każdy nowy komentarz, odpowiedź, zmiana statusu i przypisanie, a także edycje i usunięte odpowiedzi. Notatki wewnętrzne są dołączone i oznaczone: webhooki trafiają do agencji, nie do klientów.

Dostawa JSON to POST z takim ciałem:

{
  "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/…" }
    }
  ]
}

Inne nazwy zdarzeń to reply_created, status_changed, assigned, comment_edited, reply_edited i reply_deleted. W zależności od zdarzenia zawiera też reply, status (from i to), assignee lub mentions. Teksty są ucinane po 500 znakach; pełny komentarz otworzysz przez link.

Raport z zadania, który przechodzi dalej, wysyła job.state_changed, z job: from i to (draft, ready, article_waiting, changes_requested, approved lub posts_delivered), commentId i number. Powrót do draft też jest wysyłany; Slack go pomija.

Sprawdź podpis

Każda dostawa JSON ma dwa nagłówki:

  • X-Notiamo-Delivery: ten sam identyfikator co delivery w ciele;
  • X-Notiamo-Signature: sha256= i HMAC-SHA256 surowego ciała, utworzony Twoim sekretem podpisu.

Oblicz tę samą wartość po swojej stronie i porównaj. Odrzuć żądanie, jeśli się różni.

Gdy Twój serwer nie odpowiada

Karta pokazuje ostatnią dostawę, kod statusu, którym odpowiedział Twój serwer, i liczbę kolejnych niepowodzeń. Notiamo próbuje ponownie: od razu, potem po 15, 30 i 45 minutach, a następnie co godzinę. Nic się nie gubi w czasie oczekiwania. Aby zatrzymać dostawy, kliknij Usuń.

Klucze API

Kluczami API w Notiamo są klucze agentów. Otwierają serwer MCP pod https://my.notiamo.com/api/mcp, z którego może korzystać każdy klient MCP, by wyświetlać, czytać, odpowiadać na komentarze, przypisywać je i aktualizować. Utwórz klucz w Ustawienia › Agenci AI › Klucze agentów, tylko do odczytu lub pełny, dla wszystkich projektów lub jednego. Klient MCP, który obsługuje logowanie (OAuth), nie potrzebuje klucza. Zobacz Połącz agenta AI.

Aby pobrać wszystkie komentarze projektu jako plik, otwórz stronę projektu i kliknij Eksportuj CSV lub Eksportuj JSON.