Un webhook anunță alt sistem despre fiecare schimbare din proiecte, în câteva secunde. Doar administratorii pot adăuga unul.

Adăugați un webhook

  1. În bara laterală, deschideți Setări › Agenți AI. Găsiți cardul Webhooks și Slack.
  2. Lipiți Adresă la care trebuie să ajungă evenimentele. Trebuie să înceapă cu https:// și să fie accesibilă de pe internet.
  3. Alegeți Format:
    • JSON, semnat: pentru propriul cod, Zapier, Make, n8n și instrumente similare;
    • Webhook de intrare Slack: un rând ușor de citit pentru fiecare eveniment, într-un canal Slack.
  4. Apăsați Adăugați webhook.

Cardul Webhooks și Slack din Setări › Agenți AI: formularul pentru a adăuga o adresă și un webhook cu ultima sa livrare.Cardul Webhooks și Slack din Setări › Agenți AI: formularul pentru a adăuga o adresă și un webhook cu ultima sa livrare.

Pentru JSON, copiați acum secret de semnare. Nu va mai fi afișat.

Postați în Slack

  1. În Slack, creați un incoming webhook pentru canalul dorit. Slack vă dă o adresă care începe cu https://hooks.slack.com/.
  2. Adăugați-o în Notiamo cu formatul Webhook de intrare Slack.

Fiecare rând spune cine ce a făcut, în ce proiect, cu un link către comentariu. Rândurile din Slack sunt în engleză.

Ce se trimite

Fiecare comentariu nou, răspuns, schimbare de stare și atribuire, plus editările și răspunsurile șterse. Notele interne sunt incluse și marcate: webhookurile ajung la agenție, nu la clienți.

O livrare JSON este un POST cu acest conținut:

{
  "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": "Site principal" },
      "comment": { "id": "…", "number": 12, "type": "highlight", "title": null, "text": "…", "page": "/pricing", "url": "https://example.com/pricing", "status": "open", "link": "https://my.notiamo.com/comments/…" }
    }
  ]
}

Celelalte nume de evenimente sunt reply_created, status_changed, assigned, comment_edited, reply_edited și reply_deleted. În funcție de eveniment, conține și reply, status (from și to), assignee sau mentions. Textele sunt tăiate la 500 de caractere; urmați link pentru comentariul complet.

Un raport de lucrare care își schimbă starea trimite job.state_changed, cu job: from și to (draft, ready, article_waiting, changes_requested, approved sau posts_delivered), commentId și number. Și o întoarcere la draft este trimisă; Slack nu o afișează.

Verificați semnătura

Fiecare livrare JSON are două antete:

  • X-Notiamo-Delivery: același identificator ca delivery din conținut;
  • X-Notiamo-Signature: sha256= urmat de HMAC-SHA256 al conținutului brut, calculat cu secretul de semnare.

Calculați aceeași valoare la dumneavoastră și comparați. Respingeți cererea dacă diferă.

Când serverul nu răspunde

Cardul arată ultima livrare, codul de stare primit de la server și câte eșecuri au fost la rând. Notiamo încearcă din nou: imediat, apoi după 15, 30 și 45 de minute, apoi în fiecare oră. Nu se pierde nimic cât așteaptă. Pentru a opri livrările, apăsați Ștergeți.

Chei API

Cheile API ale Notiamo sunt cheile pentru agenți. Ele deschid serverul MCP de la https://my.notiamo.com/api/mcp, pe care orice client MCP îl poate folosi pentru a lista, citi, atribui și actualiza comentarii și pentru a le răspunde. Creați una în Setări › Agenți AI › Chei pentru agenți, doar pentru citire sau completă, pentru toate proiectele sau pentru unul. Un client MCP care acceptă conectarea (OAuth) nu are nevoie de cheie. Vedeți Conectați un agent AI.

Pentru a obține toate comentariile unui proiect într-un fișier, deschideți pagina proiectului și apăsați Export CSV sau Export JSON.