Dokumentation der API

Benachrichtigungen per SMS

Stonewake kann Ihnen eine kurze Textnachricht senden, wenn ein Engagement im Buch Ihres Teams auf Rot wechselt. Diese Seite erklärt, wie eine Nummer eingerichtet wird, was eine Nachricht sagt, wann eine Nachricht zurückgehalten wird und wie jede Zustellung protokolliert wird. Ihre Nummer verwalten Sie nur im Dashboard. Die API und MCP lesen das Zustellprotokoll und nie eine Nummer.

Ihre Nummer einrichten

Öffnen Sie im Dashboard die Einstellungen und geben Sie Ihre Mobilnummer im internationalen Format ein, beginnend mit der Ländervorwahl, zum Beispiel +49. Angenommen werden nur Mobilnummern in Deutschland, Österreich, der Schweiz, dem Vereinigten Königreich, Frankreich, den Niederlanden, Luxemburg, Belgien, Italien und Spanien; Mehrwertdienst, Shared Cost, Satelliten und Festnetznummern nie. An die Nummer wird nichts gesendet, bis die Administration Ihres Arbeitsbereichs sie in den Einstellungen freigibt. Die Freigabe sendet einen sechsstelligen Bestätigungscode, und die Nummer erhält Benachrichtigungen erst, nachdem Sie den Code eingegeben haben, was zeigt, dass die Nummer Ihnen gehört. Ein Code gilt zehn Minuten und erlaubt fünf Versuche. Sie können höchstens fünf Codes am Tag und einen pro Minute anfordern.

Ihre Nummer wird verschlüsselt gespeichert und Ihnen maskiert angezeigt, nur die ersten beiden und die letzten beiden Ziffern sind sichtbar. Sie erscheint nie in einem Log oder im Zustellprotokoll. Wenn Sie die Nummer entfernen, endet jede Nachricht sofort, und die gespeicherte Nummer wird endgültig gelöscht. Dasselbe gilt für die alte Nummer, wenn Sie eine neue eingeben. Wenn die Administration Sie aus dem Arbeitsbereich entfernt, wird Ihre Nummer im selben Schritt gelöscht. Die Nummer eines Mitglieds, das den Arbeitsbereich bereits verlassen hat, kann die Administration ebenfalls entfernen, und sie gibt eine solche Nummer nie frei.

Was eine Nachricht sagt

Eine Nachricht ist in der Sprache der Meldungen Ihres Arbeitsbereichs geschrieben. Auf Deutsch lautet eine Benachrichtigung "Stonewake. Eine neue kritische Meldung in Ihrem Arbeitsbereich. Details im Dashboard." und bei einer wichtigen Meldung "wichtige" statt "kritische". Auf Englisch lautet sie "Stonewake. A new critical alert in your workspace. Details in the dashboard." und bei einer wichtigen Meldung "important" statt "critical". Der Bestätigungscode kommt in derselben Sprache. Eine Nachricht nennt kein Unternehmen, keine Zahl und keinen Kunden, denn eine Textnachricht wird unverschlüsselt übertragen und ist auf einem gesperrten Bildschirm lesbar. Die Einzelheiten stehen im Dashboard hinter Ihrer Anmeldung. Die Nachrichten werden über einen SMS Anbieter in der EU mit dem Absendernamen Stonewake gesendet.

Welche Meldungen Ihr Telefon erreichen

Welche Meldungsklassen überhaupt ein Telefon erreichen, legt die Administration Ihres Arbeitsbereichs gemeinsam mit Stonewake je Team fest, im selben Teamabonnement, das auch über die Benachrichtigungen per Mail entscheidet. Eine Meldung erreicht nur Mitglieder des Teams, zu dem sie gehört, und nur solange sie aktive Mitglieder sind und ihr Team den Bereich von Stonewake hält, aus dem die Meldung stammt. Innerhalb dessen grenzt Ihre eigene Einstellung ein, was Ihr Telefon erreicht. Standardmäßig trägt die SMS nur den Wechsel eines Engagements im Buch Ihres Teams auf Rot. Sie können sie auf alle kritischen Meldungen erweitern, etwa eine Insolvenzbekanntmachung zu einem beobachteten Unternehmen, oder auf kritische und wichtige Meldungen. Informationsmeldungen gehen nie per SMS, und ein Nachrichtenereignis erreicht ein Telefon nur, wenn es kritisch ist, gleich wie Sie es eingestellt haben (Nachrichtenbeobachtung). Eine Tatsache, die bei der Erstellung ihrer Meldung schon alt war, mehr als zwei Tage bei einer Statusänderung oder mehr als 30 Tage bei einem Registerereignis, wird für die tägliche Zusammenfassung vermerkt und nicht gesendet.

Ruhezeiten

Sie können Ruhezeiten nach der Uhrzeit Ihres Arbeitsbereichs festlegen, in deutscher Zeit, sofern die Administration Ihres Arbeitsbereichs nicht britische Zeit gewählt hat. Die Einstellungsseite nennt die Uhrzeit unter den Ruhezeiten. Die Uhrzeit folgt der Sommerzeit, Ruhezeiten von 22:00 bis 07:00 bleiben also auch in den Nächten der Zeitumstellung 22:00 bis 07:00. Eine Nachricht, die in diese Zeit fällt, wird zurückgehalten und protokolliert, und sie wird nicht später gesendet. Standardmäßig kommt eine kritische Meldung trotzdem durch, und Sie können das ausschalten.

Sprache und Uhrzeit der Meldungen

Die Administration Ihres Arbeitsbereichs wählt auf der Einstellungsseite die Sprache, in der jede Meldung geschrieben ist, Deutsch oder Englisch, und die Uhrzeit, nach der sich Ruhezeiten und die Daten in Meldungen richten, deutsche oder britische Zeit. Die Wahl gilt für jeden Kanal, SMS, Mail, Teams und Webhooks. Ein Arbeitsbereich, der nichts gewählt hat, erhält seine Meldungen auf Deutsch und in deutscher Zeit. Eine deutsche Benachrichtigung per Mail trägt den englischen Text unter dem deutschen; eine englische ist nur englisch.

Obergrenzen

Jeder Arbeitsbereich hat eine tägliche Obergrenze an Nachrichten für den Arbeitsbereich und für jedes Mitglied sowie ein Monatsbudget, und Stonewake hält eine tägliche Obergrenze über alle Arbeitsbereiche zusammen. Bestätigungscodes zählen gegen dieselben täglichen Obergrenzen wie Meldungen. Eine Nachricht über einer Obergrenze wird zurückgehalten und protokolliert, und eine Nachricht, die nicht gesendet werden konnte, wird nicht erneut gesendet. Solange für einen Arbeitsbereich keine Obergrenzen festgelegt sind, ist SMS dort nicht verfügbar. In einem Demonstrationsarbeitsbereich verlässt keine Nachricht Stonewake, und der Bestätigungscode wird stattdessen auf dem Bildschirm angezeigt.

Das Zustellprotokoll

Jede Nachricht hinterlässt einen Eintrag. Jeder Versuch wird als eingereiht, gesendet, zugestellt oder nicht zugestellt nach dem Zustellbericht des Anbieters, fehlgeschlagen oder zurückgehalten mit seinem Grund protokolliert, Ruhezeiten oder eine Obergrenze. Ihr eigenes Protokoll sehen Sie im Dashboard. GET /v1/alerts/deliveries und das MCP Werkzeug alert_deliveries lesen das Protokoll des Arbeitsbereichs je Meldung, nur mit Kennungen, nie mit einem Empfänger, einer Nummer oder einem Unternehmensnamen.