Dokumentation der API

Benachrichtigungen per Mail

Stonewake kann Ihnen eine Mail senden, wenn eine Meldung zum Buch Ihres Teams den Schweregrad erreicht, den Sie wählen. Diese Seite erklärt, wie Sie sie einschalten, was eine Mail sagt, welche Meldungen Sie erreichen, welche Obergrenzen gelten und wie jede Zustellung protokolliert wird. Sie schalten sie im Dashboard ein. Die API und MCP lesen das Zustellprotokoll und nie eine Adresse.

Einschalten

Öffnen Sie im Dashboard die Einstellungen. Die Karte Benachrichtigungen per Mail sendet Ihre Meldungen an die Mailadresse Ihrer Anmeldung. Schalten Sie sie ein, wählen Sie den niedrigsten Schweregrad, der Sie erreicht, nur kritisch, hoch und kritisch oder jeder Schweregrad, und speichern Sie. Die Einstellung gilt nur für Sie. Sie umfasst jede Meldungsklasse, die Ihr Team hält, und ändert die Meldungen von niemand anderem. Ausschalten beendet die Benachrichtigungen per Mail an Sie sofort. Trägt Ihre Anmeldung keine Mailadresse, kann Sie keine Meldung per Mail erreichen, und die Karte sagt das. Ein API Schlüssel erhält nie Benachrichtigungen per Mail.

Was eine Mail sagt

Eine Mail ist in der Sprache der Meldungen Ihres Arbeitsbereichs geschrieben. Eine deutsche Benachrichtigung per Mail trägt den englischen Text unter dem deutschen; eine englische ist nur englisch. Der Betreff beginnt mit Stonewake und nennt den Schweregrad und, soweit bekannt, das Unternehmen. Die Mail nennt das Unternehmen, soweit bekannt, was sich geändert hat, das Datum, das die Quelle angibt, und die Quelle selbst, sodass jede Aussage ihre Herkunft trägt, und sie verlinkt das Dashboard. Daten sind Kalendertage nach der Uhrzeit Ihres Arbeitsbereichs, deutsche Zeit, sofern die Administration Ihres Arbeitsbereichs nicht britische Zeit gewählt hat.

Welche Meldungen Sie erreichen

Eine Meldung erreicht Sie per Mail, wenn sie zu Ihrem Team oder zum ganzen Arbeitsbereich gehört, ihr Schweregrad mindestens dem gewählten entspricht, Sie aktives Mitglied des Teams sind und Ihr Team den Bereich von Stonewake hält, aus dem die Meldung stammt. Ein Nachrichtenereignis erreicht die Teams, deren Buch oder Beobachtungsliste sein Unternehmen hält (Nachrichtenbeobachtung). Eine Tatsache, die bei der Erstellung ihrer Meldung schon alt war, wird für die tägliche Zusammenfassung vermerkt und nicht gesendet. Die Administration Ihres Arbeitsbereichs kann gemeinsam mit Stonewake auch Benachrichtigungen per Mail für die Mitglieder eines Teams einrichten; diese Meldungen kommen auf demselben Weg.

Obergrenzen

Jeder Arbeitsbereich hat ein monatliches Budget für Benachrichtigungen per Mail und eine monatliche Zahl von Zustellungen je Kanal, und das monatliche Kontingent des Mailanbieters gilt ebenfalls. Eine Mail über einer Obergrenze wird zurückgehalten und protokolliert und nie auf anderem Weg gesendet. Eine Adresse, die unzustellbar war oder eine Mail als Spam gemeldet hat, erhält keine weiteren Benachrichtigungen per Mail. Solange für einen Arbeitsbereich keine Obergrenzen eingestellt sind, können ihn noch keine Benachrichtigungen per Mail erreichen, die Karte sagt das, und Ihre Einstellung bleibt für später gespeichert. Mails gehen über einen Mailanbieter in der EU. In einem Demonstrationsarbeitsbereich verlässt keine Mail Stonewake.

Das Zustellprotokoll

Jede Mail hinterlässt einen Eintrag. Jeder Versuch wird als eingereiht, gesendet, fehlgeschlagen oder zurückgehalten mit seinem Grund protokolliert. Ihr eigenes Protokoll sehen Sie auf der Karte. GET /v1/alerts/deliveries mit channel gleich email und das MCP Werkzeug alert_deliveries lesen das Protokoll des Arbeitsbereichs je Meldung, nur mit Kennungen, nie mit einem Empfänger oder einer Adresse.