Brevo Smart-Home-Integration, kostenlos und Open Source
Gladys-Benachrichtigungen per E-Mail und SMS über Brevo, mit Zustellstatus, Szenen und Widgets.
Veröffentlicht von William-De71
- Messaging
- Version 0.1.0
- Erfordert Gladys >=5.1.0
- ★ 0
Überblick
Diese Integration sendet die Benachrichtigungen von Gladys per E-Mail, per SMS oder auf beiden Wegen über die Transaktions-APIs von Brevo (früher Sendinblue). Jeder Gladys-Benutzer wählt seinen Kanal und gibt seine eigene Adresse und/oder Handynummer ein; der Administrator gibt den Brevo-API-Schlüssel einmal für das Haus ein. Von einer Szene gesendete Kamerabilder gehen als E-Mail-Anhang mit.
Außerdem bringt sie:
- drei Szenenauslöser: Nachricht nicht gesendet, Zustellung fehlgeschlagen, SMS-Guthaben niedrig;
- drei Szenenaktionen: E-Mail senden, SMS senden (an jeden, auch an jemanden ohne Gladys-Konto), Brevo-Konto lesen;
- zwei Dashboard-Widgets: das Brevo-Konto und die letzten Nachrichten mit ihrem Zustellstatus.
Transport: Cloud. Die Texte, die Bilder, die Adressen und die Nummern
laufen über die Brevo-API (api.brevo.com) und dann über die Mailserver und
die Mobilfunkanbieter.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer.
- Ein Brevo-Konto. Der kostenlose Tarif sendet 300 E-Mails pro Tag; SMS werden als Guthaben gekauft (ein neues Konto hat keins).
- Ein E-Mail-Absender: eine in Brevo bestätigte Adresse oder eine Adresse einer in Brevo authentifizierten Domain (Absender, Domains, IPs).
- Die öffentliche IP-Adresse Ihres Hauses in Brevo autorisiert, wenn das Konto unbekannte IP-Adressen blockiert (bei seit 2024 erstellten Konten standardmäßig aktiv): Sicherheit → Autorisierte IPs.
Konfiguration
- Öffnen Sie in Brevo SMTP & API → API-Schlüssel und klicken Sie auf
Neuen API-Schlüssel generieren. Kopieren Sie ihn: Er beginnt mit
xkeysib-und wird nur einmal angezeigt. - Öffnen Sie in Gladys Integrationen → Brevo → Konfiguration, fügen Sie den Schlüssel ein und speichern Sie.
- Klicken Sie auf Verbindung testen: Es zeigt das Konto, das E-Mail- und SMS-Guthaben, die Absender und den verwendeten.
- Antwortet der Test, dass Brevo die IP-Adresse blockiert, öffnen Sie in Brevo Sicherheit → Autorisierte IPs (Link in der Konfiguration) und autorisieren Sie die Adresse, die Brevo anzeigt, oder die aus der E-Mail, die Brevo Ihnen geschickt hat.
- Klicken Sie auf Test senden mit Ihrer Adresse und/oder Nummer, um die ganze Kette zu prüfen.
- Jeder Benutzer öffnet den Block Mein Konto desselben Bildschirms, wählt E-Mail, SMS oder E-Mail und SMS und gibt seine Adresse und/oder Handynummer ein.
| Feld | Verwendung |
|---|---|
| API-Schlüssel | Aus SMTP & API → API-Schlüssel, verschlüsselt gespeichert |
| Absenderadresse | Optional: ein bestätigter Absender; leer = der erste aktive Absender des Kontos |
| Absendername | Der Name, den die Empfänger sehen (standardmäßig Gladys) |
| Betreff-Präfix | Vor der ersten Zeile der Benachrichtigung: Gladys: Haustür offen |
| SMS-Absender | Höchstens 11 Buchstaben und Ziffern, ohne Leerzeichen (standardmäßig Gladys) |
| Standard-Ländervorwahl | Wird Nummern ohne Vorwahl vorangestellt (standardmäßig 33: 06… wird zu +336…) |
| Warnung bei wenig SMS-Guthaben | Unter dieser Anzahl SMS-Guthaben löst „SMS-Guthaben niedrig“ einmal aus; 0 = aus |
| Zustellung verfolgen | Liest die Zustellereignisse von Brevo, für das Widget und „Zustellung fehlgeschlagen“ |
Verwendung
Benachrichtigungen
Jede Gladys-Benachrichtigung an einen Benutzer, der „Mein Konto“ ausgefüllt hat, geht über seinen Kanal raus: Alarme, Szenenaktionen „Nachricht senden“, die Antworten von Gladys. Der Betreff der E-Mail besteht aus dem Präfix und der ersten Zeile des Textes; ein Kamerabild geht als Anhang mit. Eine SMS enthält nur den Text, gekürzt auf 1.000 Zeichen: Ab 160 Zeichen (70 mit Zeichen wie ê, ç oder Emojis) wird sie in mehreren Teilen gesendet, von denen jeder Guthaben verbraucht. Mit E-Mail und SMS schlägt die Benachrichtigung nur fehl, wenn keiner der beiden Kanäle durchgegangen ist.
Szenenauslöser
| Auslöser | Wann er auslöst | Variablen |
|---|---|---|
| Nachricht nicht gesendet | Brevo hat eine Benachrichtigung abgelehnt: einmal pro Kanal, erneut erst nach einer Nachricht dieses Kanals | Kanal, Grund, HTTP-Status, Fehler, maskierter Empfänger |
| Zustellung fehlgeschlagen | Brevo hat eine Nachricht angenommen und dann einen Bounce, eine Sperre, eine Spam-Meldung… gemeldet; einmal pro Nachricht | Kanal, Ereignis, maskierter Empfänger, Betreff, Grund, ID, Datum |
| SMS-Guthaben niedrig | Das SMS-Guthaben ist unter die Schwelle gefallen; erneut erst nach einer Aufladung darüber | verbleibendes Guthaben, Schwelle |
„Nachricht nicht gesendet“ und „Zustellung fehlgeschlagen“ lassen sich nach Kanal, Grund oder Ereignis filtern.
Szenenaktionen
- E-Mail senden: eine oder mehrere durch Kommas getrennte Adressen (höchstens 20, jeder Empfänger bekommt seine eigene E-Mail), ein Betreff (leer = Präfix und erste Zeile) und ein Text. Liefert die gesendeten E-Mails, die abgelehnten Adressen und die Nachrichten-ID.
- SMS senden: eine oder mehrere durch Kommas getrennte Nummern (höchstens 20) und ein Text. Liefert die gesendeten SMS und die abgelehnten Nummern.
- Brevo-Konto lesen: liefert das E-Mail- und SMS-Guthaben, den Tarif sowie die heute und diesen Monat gesendeten E-Mails und SMS.
Szenenvariablen sind in jedem Feld erlaubt.
Szenenbeispiele
- Wenn der Alarm ausgelöst wird → SMS senden an den Nachbarn: „Alarm bei uns zu Hause, kannst du mal nachsehen?“.
- Wenn eine SMS nicht gesendet wird (Kanal SMS, Grund „Nicht genug Guthaben“) → dem Administrator eine Nachricht per E-Mail senden: „Brevo hat kein SMS-Guthaben mehr“.
- Wenn eine Zustellung fehlschlägt (Ereignis „Hard Bounce“) → den Administrator benachrichtigen: „{{triggerEvent.data.recipient}} hat {{triggerEvent.data.subject}} nicht erhalten“.
Dashboard-Widgets
- Brevo: E-Mail-Guthaben, SMS-Guthaben (orange nahe der Schwelle, rot darunter), der Zustand der API, der Absender, die heute und diesen Monat gesendeten E-Mails und SMS, die Fehler des Monats und der letzte davon.
- Brevo-Nachrichten: die letzten von Gladys gesendeten E-Mails und SMS mit ihrem Status (gesendet, zugestellt, Hard Bounce, blockiert…); tippen Sie auf eine für die Details.
Die Widgets fragen nie Brevo ab: Sie zeigen, was die Integration bereits weiß. Das Konto wird alle 15 Minuten gelesen, die Zustellereignisse alle 5 Minuten, und nur solange eine Nachricht der letzten zwei Tage auf ihren endgültigen Status wartet.
Fehlerbehebung
- „Brevo lehnt den API-Schlüssel ab“: Prüfen Sie den Schlüssel (er beginnt
mit
xkeysib-) oder generieren Sie einen neuen. Ein SMTP-Schlüssel (xsmtpsib-) funktioniert nicht mit der API. - „Brevo blockiert die IP-Adresse Ihres Hauses“: Autorisieren Sie sie unter Sicherheit → Autorisierte IPs oder schalten Sie die Sperre unbekannter IP-Adressen aus. Bei einer dynamischen IP-Adresse kehrt das Problem nach jedem Wechsel zurück: Autorisieren Sie den Adressbereich oder wählen Sie die automatische Autorisierung.
- „Kein aktiver E-Mail-Absender“: Fügen Sie in Brevo einen Absender hinzu und bestätigen Sie ihn über die E-Mail, die Brevo sendet, oder authentifizieren Sie Ihre Domain.
- „Absender abgelehnt“: Die Adresse der Konfiguration ist kein bestätigter Absender, oder der SMS-Absender hat mehr als 11 Zeichen.
- „Konto darf nicht senden“: Ein neues Brevo-Konto kann eine Zeit lang in Prüfung bleiben, und SMS brauchen Guthaben und manchmal eine Aktivierung: siehe die Brevo-App.
- SMS nicht empfangen: Manche Länder ersetzen einen Namen als Absender durch eine Nummer; das Widget „Brevo-Nachrichten“ zeigt, ob Brevo sie zugestellt hat.
- Protokolle: Integrationen → Brevo → Reiter Überwachung. Adressen und Nummern sind maskiert; der Schlüssel erscheint nie.
Konfigurationseinstellungen
Diese Einstellungen fragt Brevo in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Brevo-API-Schlüssel | section | Nein | Sie brauchen ein Brevo-Konto (der kostenlose Tarif sendet 300 E-Mails pro Tag; SMS werden als Guthaben gekauft). Öffnen Sie in Brevo SMTP & API, Reiter API-Schlüssel, und erzeugen Sie einen Schlüssel: Er beginnt mit xkeysib- und wird nur einmal angezeigt. Brevo blockiert API-Aufrufe von unbekannten IP-Adressen (bei neueren Konten standardmäßig aktiv): Erlauben Sie die öffentliche IP-Adresse Ihres Hauses unter Sicherheit, Autorisierte IPs, sonst werden die Aufrufe abgelehnt. |
| API-Schlüssel | secret | Ja | Beginnt mit xkeysib-. Verschlüsselt gespeichert und nie wieder angezeigt. |
| E-Mails | section | Nein | E-Mails gehen von einem Absender Ihres Brevo-Kontos aus: einer bestätigten Adresse oder einer beliebigen Adresse einer authentifizierten Domain (Absender, Domains, IPs). Lassen Sie die Adresse leer, um den ersten aktiven Absender zu nehmen. Der Betreff ist das Präfix, gefolgt von der ersten Zeile der Benachrichtigung. |
| Absenderadresse | string | Nein | Optional. Ein bestätigter Absender, z. B. [email protected]. |
| Absendername | string | Nein | Der Name, den die Empfänger sehen. |
| Betreff-Präfix | string | Nein | Steht vor der ersten Zeile der Benachrichtigung: „Gladys: Haustür offen“. |
| SMS | section | Nein | SMS verbrauchen das in Brevo gekaufte Guthaben (bei einem neuen Konto keines). Der Absender ist ein Name aus höchstens 11 Buchstaben und Ziffern, ohne Leerzeichen; manche Länder ersetzen ihn durch eine Nummer. Ein Text über 160 Zeichen (70 mit Sonderzeichen wie ê oder Emojis) wird in mehreren Teilen gesendet, jeder verbraucht Guthaben. |
| SMS-Absender | string | Nein | Höchstens 11 Buchstaben und Ziffern, z. B. Gladys oder MeinHaus. |
| Standard-Ländervorwahl | string | Nein | Wird Nummern ohne Vorwahl vorangestellt (0151 1234567 wird mit 49 zu +49 151 1234567). Nur Ziffern: 49 Deutschland, 43 Österreich, 41 Schweiz, 33 Frankreich. |
| Guthaben und Zustellung | section | Nein | Das Konto wird alle 15 Minuten gelesen. Die Zustellverfolgung liest die Ereignisse von Brevo alle 5 Minuten, nur solange eine Nachricht der letzten zwei Tage auf ihren endgültigen Status wartet, und löst „Zustellung fehlgeschlagen“ aus, wenn eine nicht ankam. |
| Warnung bei wenig SMS-Guthaben | number | Nein | Unter dieser Zahl an SMS-Guthaben löst der Szenen-Auslöser „SMS-Guthaben niedrig“ einmal aus. 0 schaltet ihn ab. |
| Zustellung verfolgen | boolean | Nein | Zeigt zugestellt oder unzustellbar im Widget und löst „Zustellung fehlgeschlagen“ aus. |
So installierst du Brevo in Gladys
- Öffne in Gladys Integrationen: Brevo erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-brevo:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-brevo.
Brevo benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Brevo ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation