AI CodeOps

Les webhooks

Mis à jour le

Envoyez les événements AI CodeOps vers Slack, Discord, Teams ou votre point de terminaison HTTPS, vérifiez les payloads signés et appelez votre pipeline de déploiement à la fusion d'un changement.

AI CodeOps envoie des webhooks ; il n'en reçoit pas. Vous pouvez :

  • envoyer les événements de l'espace de travail vers une messagerie ou vers votre propre point de terminaison, avec les points de notification ;
  • appeler votre pipeline de déploiement lorsqu'une pull request AI CodeOps est fusionnée, avec les webhooks de déploiement.

Pas de webhooks Git entrants

Les sessions n'enregistrent pas de webhooks sur vos dépôts. AI CodeOps fonctionne avec GitHub, GitLab, Bitbucket, Gitea et Forgejo par le compte que vous connectez, et vérifie l'état d'une pull request en interrogeant votre hébergeur Git. Le seul webhook qu'il ajoute concerne un dépôt que vous connectez sous Build & Test → Builds, afin qu'un push ou une pull request puisse lancer un build. Un serveur Git auto-géré n'a pas besoin non plus de webhook entrant pour les sessions, mais AI CodeOps doit pouvoir le joindre : utilisez son adresse https publique (un serveur situé sur un réseau privé ne fonctionne que si l'opérateur l'ajoute à la liste des hôtes autorisés). Consultez Connecter GitHub et les autres guides Git.

Points de notification

Ajouter un point de notification

  1. Ouvrez Configure → Settings et repérez Notification endpoints.
  2. Choisissez Add endpoint.
  3. Renseignez : - Name : par exemple « On-call Slack channel ». - Kind : Slack, Discord, MS Teams ou Generic webhook. - Target URL : l'URL de webhook entrant de votre outil de messagerie, ou votre propre point de terminaison. - Min severity : info (all), low+, medium+, high+ ou critical only. - Events to send : cochez les événements que vous voulez. Aucun coché signifie tous les événements. - Signing secret (Generic webhook uniquement) : au moins 8 caractères.
  4. Choisissez Create endpoint.

Les rôles Owner, Admin et DevOps Admin peuvent gérer les points de notification. Consultez Rôles et permissions.

L'URL cible doit être une adresse HTTPS publique. Les livraisons vers localhost, des réseaux privés ou des adresses de métadonnées cloud sont refusées, et les redirections ne sont pas suivies.

Événements

ÉvénementKindQuand
Deploy faileddeployment.failedUn déploiement a échoué
Deploy succeededdeployment.completedUn déploiement a réussi
Deploy recordeddeployment.recordedTout enregistrement de déploiement, quel que soit son statut
Incidents & policypolicy_decision.recordedUn incident s'ouvre ou change, ou une politique rend une décision
Approval requestedapproval.requestedUne demande attend une décision
Approval decidedapproval.decidedUne demande a été approuvée ou rejetée
Run completedworkflow_run.completedUne session s'est terminée
New findingagent_finding.createdUne revue a relevé un constat
Schedule failedschedule.failedUn workflow planifié n'a pas pu s'exécuter

Lorsqu'aucun événement n'est coché, le point de notification reçoit aussi les mises à jour de progression des sessions et des étapes d'agents.

Min severity ne filtre que les événements qui portent une gravité, comme les constats, les incidents et les planifications en échec. Les événements qui n'en ont pas sont toujours envoyés.

Payloads

Slack et Microsoft Teams reçoivent {"text": "<summary>"}. Discord reçoit {"content": "<summary>"}. Le résumé tient en une ligne, par exemple :

Deploy prj_01JA2B3C4D5E6F7G8H9J0K1M2R → production @ 3f9c2a1b: failed — The deploy webhook answered HTTP 502.

Un Generic webhook reçoit le résumé et l'événement en JSON, avec Content-Type: application/json :

{
  "summary": "Deploy prj_01JA2B3C4D5E6F7G8H9J0K1M2R → production @ 3f9c2a1b: failed — The deploy webhook answered HTTP 502.",
  "event": {
    "kind": "deployment.failed",
    "workspaceID": "wrk_01JA2B3C4D5E6F7G8H9J0K1M2N",
    "entityID": "dep_01JA2B3C4D5E6F7G8H9J0K1M2P",
    "workflowRunID": "wfr_01JA2B3C4D5E6F7G8H9J0K1M2Q",
    "status": "failed",
    "emittedAt": "2026-10-18T09:00:00.000Z",
    "metadata": {
      "projectID": "prj_01JA2B3C4D5E6F7G8H9J0K1M2R",
      "environment": "production",
      "sequence": 3,
      "commitSHA": "3f9c2a1b7d4e5f60718293a4b5c6d7e8f9012345",
      "strategy": "rolling",
      "errorSummary": "The deploy webhook answered HTTP 502."
    }
  }
}

Chaque événement a kind, workspaceID, entityID et emittedAt. workflowRunID, status et metadata apparaissent lorsqu'ils s'appliquent. L'événement est léger : récupérez les détails dans la console si vous en avez besoin.

Vérifier la signature

Un Generic webhook doté d'un secret de signature envoie deux en-têtes :

X-CodeOps-Signature: sha256=<hex HMAC-SHA256 of the raw body, keyed with your secret>
X-CodeOps-Event: deployment.failed

Pour vérifier, calculez le HMAC-SHA256 du corps brut de la requête avec votre secret et comparez-le à l'en-tête en temps constant. Par exemple, en Node.js :

import { createHmac, timingSafeEqual } from "node:crypto"

function verify(rawBody, header, secret) {
  const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex")
  return header.length === expected.length && timingSafeEqual(Buffer.from(header), Buffer.from(expected))
}

Utilisez les octets du corps exactement tels qu'ils ont été reçus, avant d'analyser le JSON. La signature n'a pas d'horodatage : pour écarter les doublons, utilisez donc kind, entityID et emittedAt ensemble ; emittedAt reste identique lorsqu'une livraison est retentée.

Test, nouvelles tentatives et journal des livraisons

Chaque point de notification comporte Test, Deliveries, Disable et Delete.

  • Test envoie immédiatement un événement d'exemple, quels que soient les filtres du point de notification.
  • Deliveries affiche chaque tentative avec son statut, le type d'événement, le statut HTTP, le numéro de tentative, la latence et le détail. L'historique des livraisons est conservé 30 jours.
  • Une livraison expire au bout de 8 secondes. Les erreurs réseau, les dépassements de délai et les statuts HTTP 408, 425, 429, 500, 502, 503 et 504 sont retentés au bout de 30 secondes, 2 minutes et 8 minutes. Les autres erreurs ne sont pas retentées.
  • Après 10 livraisons échouées consécutives, le point de notification est désactivé. Corrigez-le et choisissez Enable.

Il n'y a pas encore de formulaire de modification : pour changer un point de notification, supprimez-le et ajoutez-le de nouveau.

Webhooks de déploiement

Un webhook de déploiement appelle votre pipeline lorsqu'une pull request AI CodeOps est fusionnée depuis la console.

  1. Ouvrez Release → Deployments et choisissez Deploy targets.
  2. Pour chaque projet, saisissez une Deploy webhook URL, un Environment et un Signing secret facultatif.
  3. Enregistrez.

À la fusion, AI CodeOps envoie :

{
  "event": "pr_merged",
  "workspaceID": "wrk_01JA2B3C4D5E6F7G8H9J0K1M2N",
  "projectID": "prj_01JA2B3C4D5E6F7G8H9J0K1M2R",
  "repo": "acme/api",
  "prNumber": 42,
  "prUrl": "https://github.com/acme/api/pull/42"
}

Avec un secret de signature, il ajoute X-CodeOps-Signature: sha256=…, calculé de la même façon que ci-dessus. L'URL doit être en HTTPS public. Une règle release.deploy de la politique de l'espace de travail peut bloquer les déploiements automatiques vers un environnement.

Étapes suivantes

Questions fréquentes

Dois-je ajouter un webhook à mon dépôt Git ?

Pas pour les sessions, qui communiquent avec votre hébergeur Git au moyen du token de votre connexion. Seul un dépôt que vous connectez sous Build & Test → Builds reçoit un webhook, et AI CodeOps l'ajoute pour vous, afin qu'un push ou une pull request puisse lancer un build.

Les payloads de notification sont-ils signés ?

Les webhooks génériques dotés d'un secret de signature sont signés avec HMAC-SHA256 dans l'en-tête X-CodeOps-Signature. Les messages Slack, Discord et Teams ne sont pas signés.

Que se passe-t-il si mon point de terminaison est indisponible ?

Les livraisons échouées sont retentées au bout de 30 secondes, 2 minutes et 8 minutes. Après 10 échecs consécutifs, le point de terminaison est désactivé.

Cette page vous a-t-elle été utile ?