Een webhook vertelt binnen enkele seconden aan een ander systeem over elke wijziging op je projecten. Alleen beheerders kunnen er een toevoegen.

Een webhook toevoegen

  1. Open in de zijbalk Instellingen › AI-agents. Zoek de kaart Webhooks en Slack.
  2. Plak het Adres dat de gebeurtenissen moet ontvangen. Het moet met https:// beginnen en bereikbaar zijn vanaf internet.
  3. Kies het Formaat:
    • JSON, ondertekend: voor je eigen code, Zapier, Make, n8n en vergelijkbare tools;
    • Slack-inkomende webhook: één leesbare regel per gebeurtenis in een Slack-kanaal.
  4. Klik op Webhook toevoegen.

De kaart Webhooks en Slack in Instellingen › AI-agents: het formulier om een adres toe te voegen, en één webhook met zijn laatste aflevering.De kaart Webhooks en Slack in Instellingen › AI-agents: het formulier om een adres toe te voegen, en één webhook met zijn laatste aflevering.

Kopieer bij JSON nu het ondertekeningsgeheim. Het wordt niet opnieuw getoond.

Naar Slack posten

  1. Maak in Slack een inkomende webhook voor het kanaal dat je wilt. Slack geeft je een adres dat met https://hooks.slack.com/ begint.
  2. Voeg het in Notiamo toe met het formaat Slack-inkomende webhook.

Elke regel zegt wie wat deed, op welk project, met een link naar de reactie. Slack-regels zijn in het Engels.

Wat wordt verstuurd

Elke nieuwe reactie, elk antwoord, elke statuswijziging en toewijzing, plus bewerkingen en verwijderde antwoorden. Interne notities zijn inbegrepen en gemarkeerd: webhooks gaan naar het bureau, niet naar klanten.

Een JSON-aflevering is een POST met deze body:

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

Andere gebeurtenisnamen zijn reply_created, status_changed, assigned, comment_edited, reply_edited en reply_deleted. Afhankelijk van de gebeurtenis bevat hij ook reply, status (from en to), assignee of mentions. Teksten worden afgekapt op 500 tekens; volg link voor de volledige reactie.

Een jobrapport dat verder gaat, stuurt job.state_changed, met job: from en to (draft, ready, article_waiting, changes_requested, approved of posts_delivered), commentId en number. Een terugkeer naar draft wordt ook verstuurd; Slack laat die weg.

De handtekening controleren

Elke JSON-aflevering heeft twee headers:

  • X-Notiamo-Delivery: dezelfde id als delivery in de body;
  • X-Notiamo-Signature: sha256= gevolgd door de HMAC-SHA256 van de ruwe body, gemaakt met je ondertekeningsgeheim.

Bereken dezelfde waarde aan jouw kant en vergelijk. Weiger het verzoek als ze verschillen.

Als je server niet antwoordt

De kaart toont de laatste aflevering, de statuscode waarmee je server antwoordde en hoeveel mislukkingen op rij. Notiamo probeert het opnieuw: meteen, dan 15, 30 en 45 minuten later, daarna elk uur. Er gaat niets verloren terwijl het wacht. Om afleveringen te stoppen klik je op Verwijderen.

API-sleutels

De API-sleutels van Notiamo zijn agentsleutels. Ze openen de MCP-server op https://my.notiamo.com/api/mcp, die elke MCP-client kan gebruiken om reacties op te sommen, te lezen, te beantwoorden, toe te wijzen en bij te werken. Maak er een aan bij Instellingen › AI-agents › Agentsleutels, alleen-lezen of volledig, voor alle projecten of één. Een MCP-client die inloggen (OAuth) ondersteunt, heeft geen sleutel nodig. Zie Een AI-agent koppelen.

Om alle reacties van een project als bestand te krijgen open je de projectpagina en klik je op CSV exporteren of JSON exporteren.