Zurück zum Hilfecenter

Schnittstelle: Rezepte

Rezept: Freigaben und Fehlschläge nach Teams oder Slack

Ereignisse entgegennehmen, prüfen und als Nachricht in den Chat stellen.

Für wen

IT und Entwicklerinnen und Entwickler.

Voraussetzungen

Ereignisziel in elyph Eingehender Webhook in Teams oder Slack

Schritt für Schritt

  1. 1

    Ereignisse auswählen

    Sinnvoll sind `assessment.approved` für Freigaben und `barrier_check.failed` für Fehlschläge. Fristen melden Sie über `deadline.approaching`.

  2. 2

    Empfänger bauen

    Der Endpunkt prüft die Signatur, wandelt das Ereignis in eine kurze Nachricht und stellt sie in den Chat.

    Node.js
    import crypto from "node:crypto";

export async function handleElyphEvent(rawBody, headers) {
  const expected =
    "sha256=" +
    crypto.createHmac("sha256", process.env.ELYPH_WEBHOOK_SECRET).update(rawBody).digest("hex");
  if (headers["x-elyph-signature"] !== expected) return { status: 401 };

  const event = JSON.parse(rawBody.toString("utf8"));
  const text =
    event.event === "assessment.approved"
      ? `✅ Beurteilung freigegeben: ${event.data.assessment.reference} — ${event.data.assessment.title}`
      : event.event === "barrier_check.failed"
        ? `⚠️ Barriere nicht bestanden: ${event.data.barrier.reference} — ${event.data.findings ?? ""}`
        : `ℹ️ ${event.event}`;

  await fetch(process.env.CHAT_WEBHOOK_URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ text }),
  });
  return { status: 200 };
}
  3. 3

    Kanäle trennen

    Legen Sie je Ereignisart ein eigenes Ziel an, wenn unterschiedliche Kanäle informiert werden sollen.

  4. 4

    Zustellung kontrollieren

    Bleibt eine Nachricht aus, zeigt die Zustellliste in der Verwaltung den Versuch mit Status und Fehlertext.

Ergebnis

Das Team erfährt Freigaben und Fehlschläge sofort im gewohnten Kanal.

Häufige Stolpersteine

  • Personenbezogene Details in offene Kanäle stellen: Nennen Sie Nummer und Betreff, nicht Namen und Gesundheitsdaten.
  • Bei jedem Wiederholungsversuch erneut posten: Werten Sie die Zustellkennung aus.

Verwandte Artikel