messaging
Im Abschnitt messaging richtest du Benachrichtigungen zu Ladevorgängen über Dienste wie Telegram, Pushover, ntfy oder E-Mail ein.
Unter events legst du fest, bei welchen Ereignissen eine Nachricht verschickt wird, und unter services, über welche Dienste sie ankommt.
Beispiel:
messaging: events: ... services: ...Unter events legst du den Nachrichteninhalt für die vordefinierten Ereignisse fest.
Die verfügbaren Ereignisse sind:
start: Laden gestartetstop: Laden beendetconnect: Fahrzeug angeschlossendisconnect: Fahrzeug getrenntsoc: Ladestand des Fahrzeugs geändertguest: Unbekanntes Fahrzeug erkanntasleep: Fahrzeug lädt trotz Ladefreigabe nichtplanoverrun: Ladeplan verfehlt voraussichtlich sein Ziel
Beispiel:
start: # Ereignis Ladestart title: Laden gestartet msg: Laden im Modus "${mode}" gestartettitle ist der Titel der Nachricht.
msg ist der eigentliche Nachrichtentext.
Titel und Nachricht unterstützen Platzhalter, entweder in der einfachen Form ${variableName} oder als Go-Template ({{.variableName}}).
Die verfügbaren Variablen sind unter Nachrichtenformat aufgeführt.
Beispiel (einfache Syntax):
messaging: events: start: title: Laden gestartet msg: >- ${title} lädt ${vehicleTitle} im Modus ${mode} stop: title: Laden beendet msg: >- ${title}: ${vehicleTitle} hat ${chargedEnergy:%.1fk} kWh in ${chargeDuration} geladen. PV-Anteil: ${sessionSolarPercentage:%.0f}% connect: title: Fahrzeug angeschlossen msg: >- ${vehicleTitle} bei ${pvPower:%.1fk} kW PV-Leistung an ${title} angeschlossen disconnect: title: Fahrzeug getrennt msg: >- ${vehicleTitle} nach ${connectedDuration} von ${title} getrenntBeispiel (Go-Template-Syntax mit Berechnungen und Bedingungen):
messaging: events: start: title: "{{.vehicleTitle}}: Laden gestartet" msg: | {{.title}} lädt {{.vehicleTitle}} im Modus {{ toString .mode | upper }}. PV: {{round (divf .pvPower 1000) 1 }} kW Netz: {{round (divf .grid.Power 1000) 1 }} kW {{if .battery}}Hausbatterie: {{round (divf .battery.Power 1000) 1 }} kW ({{.battery.Soc }}%){{end}} stop: title: "{{.vehicleTitle}}: Laden beendet" msg: | {{.title}}: {{round (divf .chargedEnergy 1000) 1 }} kWh in {{.chargeDuration}}. PV-Anteil: {{round .sessionSolarPercentage 0 }}% {{- if .sessionPrice}} Kosten: {{round .sessionPrice 2 }} {{.currency}} ({{round .sessionPricePerKWh 2 }} {{.currency}}/kWh) {{- end}} connect: title: "{{.vehicleTitle}} angeschlossen" msg: | {{.vehicleTitle}} an {{.title}} angeschlossen. Ladestand: {{.vehicleSoc }}% ({{.vehicleRange }} km) PV: {{round (divf .pvPower 1000) 1 }} kW disconnect: title: "{{.vehicleTitle}} getrennt" msg: | {{.vehicleTitle}} nach {{.connectedDuration}} von {{.title}} getrennt.services
Abschnitt betitelt „services“services enthält die Liste der Benachrichtigungsdienste, über die Nachrichten verschickt werden.
Beispiel:
services: - type: template template: pushover app: 12345 recipients: - 234567Die verfügbaren Dienste und ihre Parameter sind auf der Seite Benachrichtigungen aufgeführt.
Jede Dienstseite zeigt ein fertiges evcc.yaml-Beispiel.
Mit type: custom kannst du außerdem beliebige Plugins mit Schreibzugriff verwenden.
Details findest du im Abschnitt benutzerdefinierter Benachrichtigungsdienst.