Tickets desde tus propios sistemas

• ticket:createAbre tickets
• ticket:readLee tickets, mensajes y paneles
• ticket:replyEscribe en un ticket como el equipo
• stats:readLee números agregados

Un permiso que falta devuelve 403, no 401. La clave está bien — simplemente le falta esa casilla.

Solo envía campos documentados aquí. Un nombre de campo desconocido no se ignora silenciosamente sino que se rechaza con 422 — un error tipográfico debería aparecer inmediatamente, no como un ticket vacío.

{
  "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…

Verificando la firma

Calcula HMAC-SHA256 sobre <timestamp>.<rawBody> con tu secreto y compara el resultado contra uno de los valores v1. Dos cosas fáciles de pasar por alto: el header puede llevar varios valores v1 (durante una rotación de secreto), y la comparación debe ejecutarse en tiempo constante.

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)));
}

Firmamos el cuerpo raw — exactamente los bytes que llegan. Verificar después de parsear y re-serializar el JSON produce una firma diferente y nada más que fallos.

Los eventos

Marcas lo que quieres cuando creas el endpoint. Sin selección recibes cada evento — con una excepción, mira abajo.

Lo que debes saber sobre entregas

• ReintentosResponde con un estado 2xx. Cualquier otra cosa cuenta como un fallo e intentamos de nuevo — después de 1, 5, 15 y 60 minutos, y luego no más.
• Guardia de bucleCada mensaje lleva un origin (discord, web, inbox, relay). Si respondes a un evento, filtra los tuyos — de lo contrario tu respuesta dispara el siguiente evento.
• DuplicadosRespondes demasiado lentamente y la misma entrega llega de nuevo. Es deliberado: dos veces es mejor que nada. El ID de entrega es lo que te protege de procesarlo dos veces.
• Endpoints muertosDespués de 20 entregas seguidas que fallan definitivamente, apagamos el endpoint y escribimos la razón en el dashboard. Una breve interrupción no lo hará — el conteo comienza solo cuando todos los reintentos se agotan.
• Rotando el secretoCuando rotes, el secreto antiguo sigue siendo válido durante 7 días y firmamos con ambos. Eso te permite cambiar tranquilamente sin perder una entrega.

Las entregas son visibles en el dashboard — incluyendo la carga útil enviada y la respuesta de tu servidor. Desde allí también puedes reproducir una entrega manualmente, siempre que siga estando en el registro.