Actualités

Webhooks Moon AI : notifications temps réel pour vos apps

Configurez les webhooks Moon AI pour recevoir des notifications en temps réel : fin de génération, alertes Moon Blur, quotas et événements système.

Mise à jour du 5 novembre 2026 : les événements et les signatures décrits dans cet article ne correspondent pas au service actuel. Moon AI propose des webhooks entrants pour lancer une routine et une notification à la fin d’une réponse.

Dans cette page6 parties

Quand votre application interagit avec l’IA, vous avez parfois besoin d’être notifié en temps réel : une génération longue qui se termine, un quota qui approche de sa limite, une donnée sensible détectée par Moon Blur. C’est exactement ce que permettent les webhooks Moon AI.

Qu’est-ce qu’un webhook ?

Un webhook est un appel HTTP que Moon AI envoie vers votre serveur quand un événement se produit. Au lieu d’interroger l’API toutes les secondes pour vérifier si quelque chose a changé, vous recevez une notification push instantanée.

Configuration

Dans votre dashboard Moon AI, rendez-vous dans Paramètres → Webhooks et ajoutez une URL de destination :

https://votre-app.com/api/webhooks/moon-ai

Sélectionnez les événements qui vous intéressent et Moon AI génère une clé de signature (whsec_...) pour vérifier l’authenticité des appels.

Événements disponibles

  • chat.completion.created : Une réponse IA a été générée (utile pour les traitements asynchrones)
  • guard.detection : Moon Blur a détecté et masqué des données sensibles
  • document.generated : Un document (PDF, DOCX) a été généré avec succès
  • workflow.completed : Un workflow automatisé a terminé son exécution
  • workflow.failed : Un workflow a échoué (avec détails de l’erreur)
  • quota.warning : Vous approchez de votre limite de quota (80 %)
  • quota.exceeded : Quota dépassé

Format du payload

Chaque webhook envoie un JSON structuré :

{
 "id": "evt_1a2b3c4d",
 "type": "chat.completion.created",
 "created_at": "2026-04-09T14:30:00Z",
 "data": {
 "completion_id": "cmpl_x7y8z9",
 "model": "claude-sonnet",
 "tokens_used": 1247,
 "duration_ms": 3200,
 "guard_applied": true,
 "guard_detections": ["email", "phone"]
 }
}

Vérification de la signature

Chaque requête webhook inclut un header X-Moon-Signature. Vérifiez-le pour vous assurer que l’appel vient bien de Moon AI :

Node.js

import crypto from "crypto";

function verifyWebhook(payload, signature, secret) {
 const expected = crypto
 .createHmac("sha256", secret)
 .update(payload)
 .digest("hex");
 return crypto.timingSafeEqual(
 Buffer.from(signature),
 Buffer.from(expected)
 );
}

// Dans votre route Express
app.post("/api/webhooks/moon-ai", (req, res) => {
 const sig = req.headers["x-moon-signature"];
 if (!verifyWebhook(JSON.stringify(req.body), sig, WEBHOOK_SECRET)) {
 return res.status(401).send("Invalid signature");
 }

 const { type, data } = req.body;

 switch (type) {
 case "guard.detection":
 console.log("Moon Blur a détecté :", data.guard_detections);
 break;
 case "quota.warning":
 notifyTeam("Quota Moon AI à 80%");
 break;
 }

 res.status(200).send("OK");
});

Python

import hmac, hashlib

def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
 expected = hmac.new(
 secret.encode(), payload, hashlib.sha256
 ).hexdigest()
 return hmac.compare_digest(signature, expected)

# Dans votre route Flask
@app.route("/api/webhooks/moon-ai", methods=["POST"])
def handle_webhook():
 sig = request.headers.get("X-Moon-Signature")
 if not verify_webhook(request.data, sig, WEBHOOK_SECRET):
 return "Invalid signature", 401

 event = request.json
 if event["type"] == "workflow.failed":
 alert_ops_team(event["data"])

 return "OK", 200

Bonnes pratiques

  • Répondez vite , Renvoyez un 200 immédiatement, puis traitez l’événement en arrière-plan. Moon AI attend 5 secondes au plus avant de considérer l’appel comme échoué.
  • Gérez les doublons , Utilisez le champ id pour dédupliquer. Moon AI peut renvoyer un événement en cas de timeout.
  • Nouvelles tentatives automatiques , En cas d’échec (5xx ou timeout), Moon AI retente 3 fois avec un backoff exponentiel (1 min, 5 min, 30 min).
  • Filtrez les événements , Ne vous abonnez qu’aux événements utiles pour éviter le bruit.
  • Journalisez tout , Conservez les payloads reçus pour le debug et l’audit.

Les webhooks transforment Moon AI d’un simple outil de chat en une brique d’infrastructure intégrée dans votre stack technique. Configurez-les une fois, et votre application réagit en temps réel à tout ce qui se passe côté IA.

Lire au format Markdown.

Essayez Moon AI sur vos propres questions.

Claude, GPT, Gemini et plus de 100 modèles dans un seul espace. Moon Blur masque les données sensibles détectées avant l’envoi. La formule gratuite ne demande pas de carte bancaire.

Moon AI

Moon AI en action

0:00

À découvrir

Captures de chat.realmoon.ai du 29 octobre 2026, avec des données fictives.

Moon AI

Vos préférences

Visites comptées sans cookie.

Notre serveur compte les visites sans cookie ni traceur. Votre thème et votre réponse sur la mesure des publicités sont mémorisés sur cet appareil.

Mesure des publicités

Avec votre accord, les traceurs de nos régies publicitaires (Google) mesurent nos annonces, de la visite à l’inscription puis au premier abonnement et son montant, et peuvent vous montrer nos publicités. Votre réponse vaut 13 mois ; vous pouvez la changer ici à tout moment.

Aucune réponse enregistrée sur cet appareil.

Après un refus, plus aucune balise n’est chargée et le site efface les cookies qu’elles avaient déposés sur realmoon.ai. Ceux des domaines des régies se gèrent chez elles ou dans votre navigateur.

L’application Moon AI possède ses propres réglages de confidentialité.