Tickets a partir de seus próprios sistemas

• ticket:createAbrir tickets
• ticket:readLer tickets, mensagens e painéis
• ticket:replyEscrever num ticket como time
• stats:readLer números agregados

Uma permissão ausente retorna 403, não 401. A chave está bem — só falta essa marca.

Envie apenas os campos documentados aqui. Um nome de campo desconhecido não é silenciosamente ignorado, mas rejeitado com 422 — um erro de digitação deve aparecer imediatamente, não como um ticket vazio.

{
  "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 a assinatura

Calcule HMAC-SHA256 sobre <timestamp>.<rawBody> com seu segredo e compare o resultado contra um dos valores v1. Duas coisas fáceis de perder: o header pode carregar vários valores v1 (durante uma rotação de segredo), e a comparação deve rodar em tempo 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)));
}

Assinamos o corpo raw — exatamente os bytes que chegam. Verificar depois de parsear e re-serializar o JSON produz uma assinatura diferente e nada além de falhas.

Os eventos

Você marca o que quer quando cria o endpoint. Sem seleção você recebe todos os eventos — com uma exceção, veja abaixo.

O que saber sobre entrega

• TentativasResponda com um status 2xx. Qualquer outra coisa conta como falha e tentamos novamente — após 1, 5, 15 e 60 minutos, depois não mais.
• Proteção contra loopCada mensagem traz uma origin (discord, web, inbox, relay). Se você responder em reação a um evento, filtre os seus próprios — senão sua resposta dispara o próximo evento.
• DuplicatasResponda muito devagar e a mesma entrega chega novamente. Isto é deliberado: duas vezes é melhor que nenhuma. O ID de entrega é o que te protege de processar duas vezes.
• Endpoints mortosApós 20 entregas seguidas que falham de verdade, desligamos o endpoint e escrevemos o motivo no dashboard. Uma breve interrupção não faz isso — a contagem começa apenas quando todas as tentativas se esgotam.
• Rotacionando o segredoQuando você rotaciona, o segredo antigo permanece válido por 7 dias e assinamos com ambos. Isso deixa você trocar com calma sem perder uma entrega.

Entregas são visíveis no dashboard — incluindo o payload enviado e a resposta do seu servidor. De lá você também pode repetir uma entrega manualmente, contanto que ainda esteja no log.