Événements et alertes de moniteur : webhooks et notifications par e-mail

• Les événements de changement sont envoyés à votre webhookUrl quand les réponses à un prompt changent : votre marque apparaît ou disparaît, un concurrent prend l’avantage, ou un site est cité pour la première fois.
• Les alertes envoient un e-mail aux administrateurs de votre compte quand le taux de mention de la marque sur les sept derniers jours passe sous alertBelowPct.

​

Événements de changement

curl -X PATCH https://api.querying.ai/v1/monitors/$MONITOR_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "webhookUrl": "https://hooks.example.com/querying/monitors" }'

​

Types d’événements

• Un événement est envoyé une fois, quand l’état change. Une marque qui reste absente des réponses envoie un seul monitor.mention.stopped, puis plus rien jusqu’à son retour.
• Un prompt a un état dès qu’il compte cinq réponses. Ce premier état sert de référence et n’envoie rien.
• Un moniteur de catégorie n’a pas de marque propre et n’envoie que monitor.source.first_cited.

• Activer webhookUrl sur un moniteur qui a déjà des réponses : l’état de chaque prompt est reconstruit à partir de ses cinq dernières réponses des 30 derniers jours, et chaque domaine déjà cité compte comme connu. Les événements commencent avec la réponse suivante.
• Créer un moniteur avec webhookUrl, ou l’activer avant qu’il n’existe des réponses : la première exécution fixe les domaines connus, et monitor.source.first_cited compte les réponses des tâches créées après la soumission complète de cette exécution. Les événements de marque commencent dès qu’un prompt compte cinq réponses.

​

Charge utile

{
  "event": "monitor.mention.stopped",
  "id": "fd61d8f6-ebdf-4162-8b55-fd052c8502a9",
  "createdAt": "2026-10-10T03:12:44.120Z",
  "monitor": { "id": "d39b8de0-b159-4229-bf58-7064e5369db1", "name": "Earbud brand tracking" },
  "data": {
    "engine": "CHATGPT",
    "prompt": "best wireless earbuds for commuting",
    "location": null,
    "taskId": "863edb44-fc62-40dd-a5be-2af9409d59b6",
    "answers": 5,
    "mentions": 2
  }
}

​

Signature et nouvelles tentatives

• querying-webhook-id est l’id de l’événement. Dédupliquez sur cette valeur.
• La clé HMAC est l’empreinte SHA-256 de la clé d’API qui a défini webhookUrl, et non de la clé d’une tâche.

​

Lister et renvoyer les événements

​

Alertes

curl -X PATCH https://api.querying.ai/v1/monitors/$MONITOR_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "alertBelowPct": 40 }'

• Fenêtre : les réponses notées des 7 derniers jours, sur tous les prompts et moteurs du moniteur. Le rapport couvre 30 jours par défaut, ce qui évolue trop lentement pour prévenir qui que ce soit.
• Moment : à chaque démarrage d’une exécution planifiée. La vérification lit les réponses déjà notées : elle reflète donc les exécutions précédentes.
• Échantillon minimal : moins de 5 réponses notées dans la fenêtre ne déclenche jamais l’alerte. Un nouveau moniteur, ou un moniteur dont les moteurs échouent, reste silencieux.
• Franchissement, pas état : l’alerte se déclenche quand le taux est sous le seuil et que l’alerte est armée, puis se désarme. Elle se réarme une fois le taux revenu au niveau du seuil ou au-dessus : un moniteur qui reste bas n’envoie donc qu’un e-mail, pas un à chaque exécution. Modifier alertBelowPct la réarme.

​

Historique des alertes

​

Envoyer une alerte de test

​

Étapes suivantes