Un webhook avvisa un altro sistema di ogni modifica sui Suoi progetti, in pochi secondi. Solo gli amministratori possono aggiungerlo.

Aggiunga un webhook

  1. Nella barra laterale, apra Impostazioni › Agenti IA. Trovi la scheda Webhook e Slack.
  2. Incolli l’Indirizzo che deve ricevere gli eventi. Deve iniziare con https:// ed essere raggiungibile da internet.
  3. Scelga il Formato:
    • JSON, firmato: per il Suo codice, Zapier, Make, n8n e strumenti simili;
    • Webhook in ingresso Slack: una riga leggibile per evento in un canale Slack.
  4. Prema Aggiungi webhook.

La scheda Webhook e Slack in Impostazioni › Agenti IA: il modulo per aggiungere un indirizzo e un webhook con la sua ultima consegna.La scheda Webhook e Slack in Impostazioni › Agenti IA: il modulo per aggiungere un indirizzo e un webhook con la sua ultima consegna.

Per il JSON, copi subito il segreto di firma. Non verrà mostrato di nuovo.

Pubblichi su Slack

  1. In Slack, crei un incoming webhook per il canale desiderato. Slack Le dà un indirizzo che inizia con https://hooks.slack.com/.
  2. Lo aggiunga in Notiamo con il formato Webhook in ingresso Slack.

Ogni riga dice chi ha fatto cosa, su quale progetto, con un link al commento. Le righe di Slack sono in inglese.

Cosa viene inviato

Ogni nuovo commento, risposta, cambio di stato e assegnazione, più le modifiche e le risposte eliminate. Le note interne sono incluse e segnalate: i webhook vanno all’agenzia, non ai clienti.

Un invio JSON è un POST con questo corpo:

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

Gli altri nomi di evento sono reply_created, status_changed, assigned, comment_edited, reply_edited e reply_deleted. A seconda dell’evento, contiene anche reply, status (from e to), assignee o mentions. I testi sono tagliati a 500 caratteri; segua link per il commento completo.

Un rapporto di lavoro che cambia stato invia job.state_changed, con job: from e to (draft, ready, article_waiting, changes_requested, approved o posts_delivered), commentId e number. Anche il ritorno a draft viene inviato; Slack non lo mostra.

Verifichi la firma

Ogni invio JSON ha due intestazioni:

  • X-Notiamo-Delivery: lo stesso identificativo di delivery nel corpo;
  • X-Notiamo-Signature: sha256= seguito dall’HMAC-SHA256 del corpo grezzo, calcolato con il Suo segreto di firma.

Calcoli lo stesso valore dalla Sua parte e confronti. Rifiuti la richiesta se è diverso.

Quando il Suo server non risponde

La scheda mostra l’ultimo invio, il codice di stato restituito dal Suo server e quanti errori di fila ci sono stati. Notiamo riprova: subito, poi 15, 30 e 45 minuti dopo, poi ogni ora. Nulla va perso durante l’attesa. Per fermare gli invii, prema Elimina.

Chiavi API

Le chiavi API di Notiamo sono le chiavi degli agenti. Aprono il server MCP all’indirizzo https://my.notiamo.com/api/mcp, che ogni client MCP può usare per elencare, leggere, rispondere, assegnare e aggiornare i commenti. Ne crei una in Impostazioni › Agenti IA › Chiavi degli agenti, in sola lettura o completa, per tutti i progetti o per uno. Un client MCP che supporta l’accesso (OAuth) non ha bisogno di chiavi. Veda Colleghi un agente IA.

Per avere tutti i commenti di un progetto in un file, apra la pagina del progetto e prema Esporta CSV o Esporta JSON.