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

Aggiunga un webhook

  1. Nella barra laterale, apra Impostazioni. 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.

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 sito, 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" },
      "site": { "id": "…", "name": "Sito principale" },
      "comment": { "id": "…", "number": 12, "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.

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 i token 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 uno in Impostazioni › Token degli agenti, in sola lettura o completo, per tutti i siti o per uno. Veda Colleghi un agente IA.

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