Überwachung

Benachrichtigungen (E-Mail & Webhook)

Die drei Wege, auf denen dich Firmenbuch.app über Registeränderungen informiert — und wie du sie einrichtest.

Erkennt der Abgleich eine Änderung an einer beobachteten Firma, meldet Firmenbuch.app sie über einen oder mehrere Kanäle:

  • In-App — die Glocke oben zeigt neue Alerts. In allen Tarifen verfügbar, ohne Einrichtung.
  • E-Mail — ein Digest der neuen Änderungen (ab Pro). Benötigt eine verifizierte Absender-Domain auf Betreiberseite.
  • Webhook — ein signierter POST an deine HTTPS-URL, in Echtzeit weiterverarbeitbar (Enterprise).

Webhooks & Signaturprüfung

Webhooks richtest du im Entwickler-Bereich ein. Jede Zustellung trägt eine Signatur im Header x-companybook-signature — ein HMAC-SHA256 über den Rohbody mit deinem Webhook-Secret. Prüfe sie in deinem Endpoint, bevor du die Daten verarbeitest, um Fälschungen abzuweisen.

Das Webhook-Signatur-Secret wird nur einmal angezeigt (bei der Einrichtung) — bewahre es sicher auf. Geht es verloren, erzeuge ein neues.