Benachrichtigungen

Über Benachrichtigungen bleibst du über deine Ladevorgänge auf dem Laufenden, z. B. per Telegram, Pushover, ntfy oder E-Mail. Du legst fest, bei welchen Ereignissen eine Nachricht verschickt wird, und kannst Titel und Inhalt mit Platzhaltern selbst gestalten. Die Einrichtung erfolgt über Konfiguration → Benachrichtigungen.

Dienste

Unter Dienste fügst du einen oder mehrere der folgenden Dienste hinzu.

E-Mail

Ereignisse

Nachrichten können für folgende Ereignisse verschickt werden:

Ereignis	Wird ausgelöst, wenn …
`start`	das Laden beginnt
`stop`	das Laden beendet wird
`connect`	ein Fahrzeug angeschlossen wird
`disconnect`	ein Fahrzeug getrennt wird
`soc`	sich der Ladestand des Fahrzeugs ändert
`guest`	ein unbekanntes Fahrzeug erkannt wird
`asleep`	ein Fahrzeug trotz Ladefreigabe nicht lädt
`planoverrun`	ein Ladeplan sein Ziel voraussichtlich verfehlt

Jedes Ereignis hat einen Titel und eine Nachricht. Beide lassen sich mit Platzhaltern individuell gestalten.

Nachrichtenformat

Nachricht mit einfacher Syntax, z. B. für das Ereignis stop:

${title}: ${vehicleTitle} geladen mit ${chargedEnergy:%.1fk}kWh in ${chargeDuration}.
Sonnenanteil: ${sessionSolarPercentage:%.0f}%

Dieselbe Nachricht mit Go-Template-Syntax, mit Berechnungen (z. B. Umrechnung W → kW) und Bedingungen:

{{.title}}: {{round (divf .chargedEnergy 1000) 1 }} kWh in {{.chargeDuration}}.
Sonnenanteil: {{round .sessionSolarPercentage 0 }}%
{{- if .sessionPrice}}
Kosten: {{round .sessionPrice 2 }} {{.currency}} ({{round .sessionPricePerKWh 2 }} {{.currency}}/kWh)
{{- end}}

Platzhalter

In Titel und Nachricht können Variablen verwendet werden, um evcc-Informationen anzuzeigen. Es gibt zwei Schreibweisen, die auch kombiniert werden können:

Einfach: ${variablenName}, z. B. ${vehicleTitle}. Optional mit Formatierung wie ${pvPower:%.1fk}: neben den üblichen printf-Angaben teilt das Suffix k den Wert durch 1000 (z. B. Wh → kWh). Zeitdauern wie ${chargeDuration} werden automatisch sekundengenau ausgegeben (z. B. 1h23m4s).
Go-Template: {{.variablenName}} — ermöglicht Berechnungen, Bedingungen und sprig-Funktionen.

Verfügbare Variablen

Die verfügbaren Variablen entsprechen den Daten der REST API. Beim Versand einer Nachricht werden die Daten des auslösenden Ladepunkts und die globalen Daten in einer flachen Struktur zusammengeführt. D. h. sowohl globale Werte (z. B. pvPower, grid.Power) als auch ladepunktspezifische Werte (z. B. mode, chargedEnergy, vehicleTitle) sind direkt verfügbar. Verschachtelte Werte wie grid.Power oder battery.Soc sind nur mit der Go-Template-Syntax erreichbar; die Großschreibung der Feldnamen ist dabei erforderlich.

Häufig genutzte Ladepunkt-Variablen:

title: Name des Ladepunkts
loadpoint: Nummer des Ladepunkts 1, 2, …
mode: Lademodus off/now/minpv/pv
charging: Ladevorgang aktiv
enabled: Ladefreigabe erteilt
connected: Fahrzeug angeschlossen
chargedEnergy: Geladene Energie der Sitzung in Wh
chargeDuration: Ladedauer
chargePower: Aktuelle Ladeleistung in W
connectedDuration: Anschlussdauer
chargeRemainingDuration: Restladezeit bis Ziel
chargeRemainingEnergy: Restenergie bis Ziel in Wh
phasesActive: Aktuell aktive Phasen
vehicleTitle: Name des Fahrzeugs
vehicleName: Technischer Name des Fahrzeugs
vehicleSoc: Fahrzeug-Ladestand in %
vehicleRange: Fahrzeug-Reichweite in km
vehicleOdometer: Kilometerstand in km
sessionSolarPercentage: Sonnenanteil der Ladesitzung in %
sessionPrice: Kosten der Ladesitzung
sessionPricePerKWh: Durchschnittspreis pro kWh
sessionCo2PerKWh: Durchschnittliche CO₂-Emissionen pro kWh
planActive: Ladeplan aktiv
smartCostActive: Günstiges Laden aktiv

Häufig genutzte globale Variablen:

siteTitle: Name der evcc-Instanz
pvPower: Aktuelle PV-Leistung in W
homePower: Aktueller Hausverbrauch in W
grid.Power: Netzbezug (+) / Einspeisung (−) in W
battery.Power: Batterieleistung in W
battery.Soc: Batterie-Ladestand in %
currency: Tarif-Währung
tariffGrid: Aktueller Netzpreis pro kWh
tariffFeedIn: Einspeisevergütung pro kWh
tariffCo2: Aktuelle CO₂-Intensität
statistics.<zeitraum>.*: Ladestatistiken für die Zeiträume 30d, 365d, thisYear und total (avgCo2, avgPrice, chargedKWh, solarPercentage)

Die vollständige Liste aller verfügbaren Felder findest du in der API-Antwort unter http://evcc.local:7070/api/state.

Beide Schreibweisen funktionieren in den Titel- und Nachrichtenfeldern der Oberfläche. Die Konfiguration über evcc.yaml ist in der messaging-Referenz beschrieben.