IMAP-Template-Suche: Filterung von E-Mails nach Betreff

Home Assistant 2. Sep. 2025

Einleitung
In der heutigen Zeit ist die Automatisierung von Prozessen im Smart Home und in der IT von großer Bedeutung. Eine häufige Anforderung ist das Filtern von E-Mails, um nur relevante Informationen zu erhalten. In diesem Artikel wird erläutert, wie man in einem IMAP-Trigger nach einem bestimmten Wort im Betreff einer E-Mail suchen kann, um gezielte Aktionen auszulösen.

Problem
Ein Benutzer möchte einen IMAP-Trigger so konfigurieren, dass er nur dann reagiert, wenn das Wort „Zugestellt“ im Betreff der E-Mail enthalten ist. Der ursprüngliche Trigger funktioniert bereits für den Absender, jedoch fehlt die Filterung für den Betreff.

Lösung
Um das gewünschte Verhalten zu erreichen, kann eine Bedingung in den Trigger integriert werden, die überprüft, ob das Wort „Zugestellt“ im Betreff der E-Mail vorhanden ist. Dies geschieht durch die Verwendung eines Template-Conditions in der Automatisierung.

Hier ist der vollständige Code, der die Bedingung für den Betreff hinzufügt:

trigger:
  - platform: event
    event_type: imap_content
    event_data:
      sender: order-update@amazon.de
      subject: ???
      initial: true
      id: order update
      enabled: true

condition:
  - condition: template
    value_template: >
      {{ 'Zugestellt' in trigger.event.data.subject }}

In diesem Code wird die Bedingung condition hinzugefügt, die überprüft, ob das Wort „Zugestellt“ im Betreff (subject) der E-Mail enthalten ist. Nur wenn diese Bedingung erfüllt ist, wird die Automatisierung ausgelöst.

Schritte zur Umsetzung
1. Öffne die Konfigurationsdatei für deine Automatisierung.
2. Füge den Trigger für den IMAP-Event hinzu, wie im obigen Beispiel gezeigt.
3. Ergänze die Bedingung, um das Vorhandensein des Wortes „Zugestellt“ im Betreff zu überprüfen.
4. Speichere die Änderungen und lade die Konfiguration neu, um die Automatisierung zu aktivieren.

Hintergrundwissen
IMAP (Internet Message Access Protocol) ist ein Protokoll, das es ermöglicht, E-Mails auf einem Server zu verwalten. Bei der Automatisierung von E-Mail-Triggern ist es wichtig, die Struktur der empfangenen Daten zu verstehen. Der trigger.event.data enthält alle relevanten Informationen zur E-Mail, einschließlich des Absenders und des Betreffs.

Typische Fehler, die bei der Implementierung auftreten können, sind:
- Falsche Schreibweise des Schlüsselworts im Betreff.
- Fehlende oder falsche Konfiguration des IMAP-Servers.

Zusätzliche Infos

FunktionErklärung
`trigger`Definiert den Auslöser für die Automatisierung.
`event_type`Typ des Ereignisses, hier `imap_content`.
`event_data`Enthält spezifische Daten zur E-Mail, wie Absender und Betreff.
`condition`Bedingung, die erfüllt sein muss, damit die Automatisierung ausgeführt wird.
`value_template`Template, das zur Auswertung der Bedingung verwendet wird.

Hinweise & Best Practices
- Stelle sicher, dass der IMAP-Server korrekt konfiguriert ist und die Verbindung stabil ist.
- Teste die Automatisierung mit verschiedenen E-Mails, um sicherzustellen, dass die Filterung wie gewünscht funktioniert.
- Verwende spezifische Schlüsselwörter, um die Genauigkeit der Filterung zu erhöhen und unerwünschte Auslösungen zu vermeiden.