Des tickets depuis tes propres systèmes

• ticket:createOuvre des tickets
• ticket:readLis les tickets, messages et panneaux
• ticket:replyÉcris dans un ticket en tant qu'équipe
• stats:readLis les chiffres agrégés

Une permission manquante retourne 403, pas 401. La clé va bien — elle n'a simplement pas cette case cochée.

Envoie uniquement les champs documentés ici. Un nom de champ inconnu n'est pas ignoré silencieusement mais rejeté avec 422 — une typo devrait apparaître tout de suite, pas comme un ticket vide.

{
  "event": "message.created",
  "sent_at": "2026-08-01T12:34:56Z",
  "guild_id": "1470847667327471738",
  "ticket": {
    "id": 42, "number": 17,
    "panel_id": 3, "panel_name": "Support",
    "status": "open", "priority": 2,
    "opener_id": "234...", "metadata": null
  },
  "message": {
    "id": 8891,
    "discord_message_id": "13...",
    "origin": "discord",
    "is_staff": true,
    "is_ai": false,
    "author_id": "234...",
    "author_bot": false,
    "author_name": "Lisa",
    "content": "Ich schaue mir das an.",
    "created_at": "2026-08-01T12:34:56Z"
  }
}

X-Ticketanizer-Event: message.created
X-Ticketanizer-Delivery: 90183
X-Ticketanizer-Timestamp: 1785600896
X-Ticketanizer-Signature: t=1785600896,v1=9f2c…

Vérifier la signature

Calcule HMAC-SHA256 sur <timestamp>.<rawBody> avec ton secret et compare le résultat à l'une des valeurs v1. Deux choses faciles à oublier : l'en-tête peut porter plusieurs valeurs v1 (pendant une rotation de secret), et la comparaison doit s'effectuer en temps constant.

const crypto = require("crypto");

function verify(rawBody, header, secret) {
  const parts = header.split(",").map(p => p.split("="));
  const ts = parts.find(([k]) => k === "t")?.[1];
  // v1 kann MEHRFACH vorkommen — waehrend einer Secret-Rotation
  const sigs = parts.filter(([k]) => k === "v1").map(([, v]) => v);
  if (!ts || Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;

  const expected = crypto.createHmac("sha256", secret)
    .update(ts + "." + rawBody)
    .digest("hex");

  return sigs.some(s => s.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(s), Buffer.from(expected)));
}

Nous signons le corps brut — exactement les octets qui arrivent. Vérifier après avoir analysé et ré-sérialisé le JSON produit une signature différente et rien que des échecs.

Les événements

Tu coches ce que tu veux quand tu crées le point de terminaison. Sans sélection tu obtiens chaque événement — sauf une exception, voir ci-dessous.

Ce qu'il faut savoir sur la livraison

• TentativesRéponds avec un statut 2xx. Tout le reste compte comme un échec et nous réessayons — après 1, 5, 15 et 60 minutes, puis c'est fini.
• Protection contre les bouclesChaque message porte une origin (discord, web, inbox, relay). Si tu réponds à un événement, filtre les tiens — sinon ta réponse déclenche l'événement suivant.
• DoublonsTu réponds trop lentement et la même livraison arrive à nouveau. C'est intentionnel : deux fois vaut mieux que pas du tout. L'ID de livraison est ce qui te protège de le traiter deux fois.
• Points de terminaison mortsAprès 20 livraisons d'affilée qui échouent définitivement, nous désactivons le point de terminaison et écrivons la raison dans le tableau de bord. Une brève interruption ne suffira pas — le comptage commence seulement une fois que tous les essais sont épuisés.
• Rotation du secretQuand tu effectues une rotation, l'ancien secret reste valide pendant 7 jours et nous signons avec les deux. Cela te permet de basculer tranquillement sans perdre une livraison.

Les livraisons sont visibles dans le tableau de bord — y compris la charge utile envoyée et la réponse de ton serveur. De là tu peux aussi rejouer une livraison à la main, tant qu'elle est encore dans le journal.