Un webhook informe un autre système de chaque changement sur vos sites, en quelques secondes. Seuls les administrateurs peuvent en ajouter.

Ajouter un webhook

  1. Dans la barre latérale, ouvrez Paramètres. Trouvez la carte Webhooks et Slack.
  2. Collez l’Adresse qui doit recevoir les événements. Elle doit commencer par https:// et être joignable depuis internet.
  3. Choisissez le Format :
    • JSON, signé : pour votre propre code, Zapier, Make, n8n et les outils similaires ;
    • Webhook entrant Slack : une ligne lisible par événement dans un canal Slack.
  4. Cliquez sur Ajouter le webhook.

Pour le JSON, copiez tout de suite le secret de signature. Il ne sera plus affiché.

Publier dans Slack

  1. Dans Slack, créez un webhook entrant pour le canal voulu. Slack vous donne une adresse qui commence par https://hooks.slack.com/.
  2. Ajoutez-la dans Notiamo avec le format Webhook entrant Slack.

Chaque ligne dit qui a fait quoi, sur quel site, avec un lien vers le commentaire. Les lignes Slack sont en anglais.

Ce qui est envoyé

Chaque nouveau commentaire, réponse, changement de statut et assignation, ainsi que les modifications et les réponses supprimées. Les notes internes sont incluses et signalées : les webhooks vont à l’agence, pas aux clients.

Une livraison JSON est un POST avec ce corps :

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

Les autres noms d’événement sont reply_created, status_changed, assigned, comment_edited, reply_edited et reply_deleted. Selon l’événement, il contient aussi reply, status (from et to), assignee ou mentions. Les textes sont coupés à 500 caractères ; suivez link pour le commentaire complet.

Vérifier la signature

Chaque livraison JSON a deux en-têtes :

  • X-Notiamo-Delivery : le même identifiant que delivery dans le corps ;
  • X-Notiamo-Signature : sha256= suivi du HMAC-SHA256 du corps brut, calculé avec votre secret de signature.

Calculez la même valeur de votre côté et comparez. Refusez la requête si elle diffère.

Quand votre serveur ne répond pas

La carte affiche la dernière livraison, le code de statut renvoyé par votre serveur et le nombre d’échecs d’affilée. Notiamo réessaie : tout de suite, puis 15, 30 et 45 minutes plus tard, puis toutes les heures. Rien n’est perdu pendant l’attente. Pour arrêter les livraisons, cliquez sur Supprimer.

Clés d’API

Les clés d’API de Notiamo sont les jetons d’agent. Ils ouvrent le serveur MCP à l’adresse https://my.notiamo.com/api/mcp, que tout client MCP peut utiliser pour lister, lire, assigner et mettre à jour les commentaires, et y répondre. Créez-en un dans Paramètres › Jetons d’agent, en lecture seule ou complet, pour tous les sites ou un seul. Voir Connecter un agent IA.

Pour obtenir tous les commentaires d’un site dans un fichier, ouvrez la page du site et cliquez sur Exporter en CSV ou Exporter en JSON.