Zum Hauptinhalt springen
Füge unter Einstellungen → Benachrichtigungen ein Ziel hinzu, um die Alarme deines Workspace per E-Mail, an Slack, Discord, Microsoft Teams oder an deinen eigenen HTTPS-Webhook zu senden. Ziele gehören zum Workspace, und du kannst einen Test senden, bevor du dich auf eines verlässt. Zugangsdaten und Webhook-URLs werden vor dem Speichern verschlüsselt. Beschränke Kanalzugangsdaten auf den Benachrichtigungsversand und rotiere sie, falls sie offengelegt wurden.

Ein Ziel hinzufügen

1

Ziel anlegen

Öffne Einstellungen → Benachrichtigungen, wähle Ziel hinzufügen, gib einen Namen ein und wähle einen oder mehrere Kanäle. Füge die Zieldetails und bei Bedarf Erwähnungen hinzu.
2

Jeden Kanal testen

Wähle für jeden Kanal Test senden und lege die Ziele an, sobald alle Tests erfolgreich waren.
3

Das Signaturgeheimnis speichern

Ein eigener Webhook bekommt beim Anlegen ein Signaturgeheimnis. Kopiere es aus dem Dialog, der sich öffnet; es wird nur einmal angezeigt.
In Skripten erstellst du ein Ziel mit POST /v1/notifications/destinations, prüfst es mit POST /v1/notifications/destinations/{id}/test und legst mit PUT /v1/notifications/routes/{eventKind} fest, welche Alarme es erhält, jeweils mit einem Management-Schlüssel. Verwende Erwähnungen sparsam: Schick häufige Alarme an einen überwachten Kanal, statt eine große Gruppe direkt zu alarmieren.

Produktalarme aktivieren

Die Benachrichtigungsseite listet die Alarmtypen, die für deinen Workspace verfügbar sind. Ziele erhalten einen Alarm zusätzlich zu den integrierten Empfängern, die im Dashboard angezeigt werden. Warnungen zur Modellablösung kündigen an, bevor ein Modell, das der Workspace nutzt, eingestellt wird. Hinweise zu Ersatzmodellen werden gesendet, wenn das Routing für eingestellte Modelle aktiviert ist und ein Ersatzmodell die Anfragen des Workspace für ein Modell beantwortet, das kein Anbieter mehr bereitstellt. Pro Modell und Ersatzmodell wird ein Hinweis gesendet, wenn ein Ersatzmodell zum ersten Mal erfolgreich antwortet. Der Workspace-Inhaber erhält immer eine E-Mail; wähle Ziele aus, um den Hinweis auch an dein Team zu senden.

Ausgabenberichte

Workspace-Inhaber erhalten jeden Montag um 09:00 Uhr in der Abrechnungszeitzone des Workspace eine E-Mail mit dem Ausgabenbericht für die Vorwoche von Montag bis Sonntag. Du änderst das auf der Benachrichtigungsseite unter Ausgabenwarnungen → Ausgabeneinstellungen des Arbeitsbereichs: täglich (um 09:00 Uhr für den Vortag), wöchentlich, monatlich (am 1. für den Vormonat) oder aus, und ob auch Administratoren ihn erhalten. Zeiträume ohne Ausgaben werden übersprungen. Jeder Bericht zeigt die Ausgaben und die Veränderung zum vorherigen Zeitraum, die wichtigsten Schlüssel, Modelle, Mitglieder und Abteilungen, die Prognose für diesen Monat, die Reichweite des Guthabens sowie die Ausgabenwarnungen und Sperren des Zeitraums. Wer ihn erhält, kann sich über den Link in der E-Mail abmelden; das stoppt nur die eigene Kopie des Berichts dieses Workspace. Ziele, die an Ausgabenberichte weitergeleitet werden, erhalten pro Bericht eine Zusammenfassung. Dieselben Einstellungen heißen in der API für Benachrichtigungseinstellungen spend.report_cadence und spend.report_include_admins. Für Warnungen zu Ausgaben, Budgets, Prognosen, Ausgabenspitzen und niedrigem Guthaben sowie zum Sperren von Anfragen, sobald die Ausgaben ein Limit überschreiten, siehe Ausgabenwarnungen.
Ausgabenberichte per E-Mail werden schrittweise eingeführt. Bis sie aktiviert sind, wird deine Auswahl gespeichert, aber kein Bericht verschickt.

Ziele funktionsfähig halten

Wähle neben einem vorhandenen Ziel Test senden, nachdem du Zugangsdaten rotiert oder seinen Kanal geändert hast. Entferne Ziele, die niemand überwacht, damit Alarme nicht als zugestellt erscheinen, obwohl sie in einem verwaisten Kanal landen. Ein eigener Webhook-Empfänger sollte jede Anfrage prüfen, bevor er sie verarbeitet, zügig eine erfolgreiche Antwort zurückgeben und langsamere Arbeit in einen Hintergrundjob verlagern.

Webhook-Signaturen prüfen

Phaseo signiert jede Zustellung an eigene Webhooks, auch Tests von einem gespeicherten Ziel, nach demselben Schema wie Video- und Batch-Webhooks. Jede Anfrage enthält diese Header:
x-phaseo-signature ist der hexadezimale HMAC-SHA256 aus dem Wert von x-phaseo-timestamp, einem Punkt (.) und dem unveränderten Request-Body, berechnet mit dem Signaturgeheimnis des Ziels (whsec_…). x-phaseo-timestamp ist in Unix-Sekunden angegeben. So prüfst du eine Zustellung:
  1. Lies den unveränderten Body, bevor du ihn als JSON parst.
  2. Berechne die Signatur neu und vergleiche sie in konstanter Zeit.
  3. Lehne Zeitstempel ab, die mehr als fünf Minuten von deiner Uhr abweichen.
  4. Dedupliziere anhand von x-phaseo-event-id. Fehlgeschlagene Zustellungen werden wiederholt, und jeder Versuch wird mit einem neuen Zeitstempel erneut signiert.

Ein Geheimnis erzeugen oder rotieren

Das Geheimnis wird nur einmal angezeigt, beim Anlegen des Ziels. Um es zu ersetzen, wähle Geheimnis rotieren neben dem Ziel unter Einstellungen → Benachrichtigungen oder rufe POST /v1/notifications/destinations/{id}/rotate-secret auf. Die nächste Zustellung wird mit dem neuen Geheimnis signiert, und das alte funktioniert nicht mehr; aktualisiere deinen Empfänger also sofort. Eigene Webhooks, die vor Einführung der Signierung angelegt wurden, haben kein Geheimnis und werden weiterhin unsigniert zugestellt. In den Einstellungen sind sie als Unsigniert markiert. Wähle Geheimnis erzeugen, hinterlege das Geheimnis in deinem Empfänger und sende dann einen Test, um die Prüfung zu kontrollieren. Tests aus dem Bereich Ziel hinzufügen, bevor das Ziel gespeichert ist, sind unsigniert, weil noch kein Geheimnis existiert. E-Mail-, Slack-, Discord- und Microsoft-Teams-Ziele werden nicht signiert: Diese Dienste authentifizieren die Webhook-URL oder das Bot-Token selbst.
Zuletzt geändert am 7. November 2026