Zum Hauptinhalt springen

Zammad Smart-Home-Integration, kostenlos und Open Source

Zammad-Integration für Gladys Assistant

Zammad-Helpdesk: offene, neue, wartende und eskalierte Tickets, Ereignisse, Tickets aus Szenen.

Auf GitHub ansehenAlle Integrationen

Dein Zammad-Helpdesk in Gladys: die Zahl der offenen, neuen, wartenden und eskalierten Tickets, der nicht zugewiesenen, der dir zugewiesenen und der heute erstellten, für die ganze Instanz und für die Gruppen deiner Wahl. Eine Szene reagiert auf ein neues Ticket oder auf ein Ticket, das seine SLA-Eskalationszeit überschritten hat, eine andere eröffnet ein Ticket von einem Sensor oder einer Taste aus, und das Dashboard listet die neuesten offenen Tickets.

Feedback willkommen. Diese Integration wurde gegen einen echten Zammad-Server getestet (Docker-Image ghcr.io/zammad/zammad 7.2.2, Oktober 2026), noch nicht im Alltag. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.

Was du brauchst​

  • Gladys Assistant 5.1.0 oder neuer.
  • Ein Zammad, das Gladys erreicht: selbst gehostet oder von Zammad gehostet (*.zammad.com). Getestet mit Zammad 7.2; Elasticsearch ist nicht nötig.
  • Ein persönliches Zugriffstoken eines Zammad-Agenten. In Zammad: dein Avatar → Profil → Token-Zugang → Erstellen, mit der Berechtigung Agenten-Tickets (ticket.agent). Kopiere es: Zammad zeigt es nur einmal. Fehlt das Menü, aktiviert ein Administrator API-Token-Zugang unter System → API.

Die Integration sieht die Tickets der Gruppen, auf die dieser Agent Zugriff hat, und erstellt Tickets als dieser Agent. Ein eigener Agent, Mitglied der zu verfolgenden Gruppen, hält alles übersichtlich.

Einrichtung​

  1. In Gladys Integrationen → Zammad installieren.
  2. Im Bildschirm Konfiguration:
    • Adresse: die Adresse von Zammad wie im Browser, z. B. https://helpdesk.example.org (bei Bedarf mit :Port);
    • Zugriffstoken: das oben erstellte Token;
    • Verfolgte Gruppen (optional): Gruppennamen durch Kommas getrennt, z. B. Users, Hardware. Jede bekommt ein eigenes Gerät mit ihren Zählern. Leer: nur das Gerät der Instanz;
    • Selbstsignierte Zertifikate akzeptieren: nur für deinen eigenen Server mit selbstsigniertem Zertifikat;
    • Aktualisierungsintervall: 1, 2 (Standard), 5 oder 10 Minuten;
    • Sprache der Funktionsnamen: die Namen, die die Funktionen beim Hinzufügen eines Geräts bekommen (standardmäßig Französisch).
  3. Klicke auf Verbindung testen: Es meldet, wie viele Tickets offen und eskaliert sind, und die verfolgten Gruppen, die es nicht gibt.
  4. Füge unter Entdeckung die gewünschten Geräte hinzu.

Jede Abfrage kostet sechs kleine Anfragen (der Benutzer, die Status, die Gruppen, die offenen, die eskalierten und die heute erstellten Tickets) und eine weitere je 100 Tickets über die ersten 100 einer Suche hinaus, höchstens 1000 Tickets pro Suche.

Geräte​

  • Zammad: die ganze Instanz (die Gruppen des Agenten).
  • Zammad <Gruppe>: eines pro verfolgter Gruppe.

Funktionen (Zähler, mit Verlauf):

FunktionBedeutung
Offene TicketsStatus neu, offen, Erinnerung wartend oder Schließen wartend
Neue TicketsStatus neu
Wartende TicketsStatus Erinnerung wartend oder Schließen wartend
Eskalierte Ticketsoffen, nach der Eskalationszeit ihres SLA
Nicht zugewiesene Ticketsoffen, ohne Besitzer
Mir zugewiesene Ticketsoffen, im Besitz des Token-Agenten (nur Instanz)
Heute erstellte Ticketsseit Mitternacht erstellt (Zeit von Gladys), egal welcher Status

Die Eskalationszeiten kommen aus den SLAs von Zammad: Ohne SLA eskaliert kein Ticket. Die Zähler ändern sich bei jeder Abfrage, um Mitternacht und zur nächsten Eskalationszeit.

Dashboard​

Das Widget Offene Tickets zeigt die 10 neuesten offenen Tickets mit Nummer, Titel, Status und Gruppe; eskalierte in Rot, neue in Orange. Darüber zwei Kacheln: offene und eskalierte Tickets.

Einstellungen: Gerät (leer: die ganze Instanz; ein Gruppengerät: nur diese Gruppe) und Zähler anzeigen (deaktivieren, um nur die Liste zu behalten).

Szenen​

Auslöser​

  • Neues Zammad-Ticket: Ein Ticket wurde in einer Gruppe des Agenten erstellt, bei der nächsten Abfrage gesehen (auch wenn es inzwischen geschlossen wurde).
  • Zammad-Ticket eskaliert: Ein offenes Ticket hat seine SLA-Eskalationszeit überschritten (Erstantwort, Aktualisierung oder Lösung). Es löst einmal pro Eskalationszeit aus: Setzt eine Antwort eine neue Zeit und läuft auch diese ab, löst es erneut aus.

Beide lassen sich nach Gruppe (genau wie in Zammad) und Priorität (die Standardprioritäten 1 low, 2 normal, 3 high) filtern. Beide geben der Szene Titel, Ticketnummer, Ticket-ID, Gruppe, Priorität, Status, Kunde und Ticket-Adresse weiter; beim zweiten auch die Eskalationszeit.

Aktionen​

  • Zammad-Ticket erstellen: eröffnet ein Ticket mit einem Titel in einer Gruppe (Name oder ID; leer: die erste verfolgte Gruppe, sonst die erste Gruppe des Agenten), mit einem Text (leer: der Titel), einer Priorität (leer: die Standardpriorität von Zammad) und einer Kunden-E-Mail (leer: der Agent des Tokens; eine unbekannte Adresse legt den Kunden an). Die nächsten Schritte erhalten Ticket-ID, Ticketnummer, Titel, Gruppe und Ticket-Adresse.

Szenen-Ideen​

  • Ein Wassermelder im Serverraum: Zammad-Ticket erstellen „Wasser erkannt“ in der Gruppe Hardware, Priorität 3 high.
  • Zammad-Ticket eskaliert in der Gruppe Support: das Bürolicht blinken lassen und eine Nachricht mit Titel und Ticket-Adresse senden.
  • Neues Zammad-Ticket mit Priorität 3 high außerhalb der Bürozeiten: die Bereitschaft benachrichtigen.

Fehlerbehebung​

  • „Zugriffstoken abgelehnt“: Das Token ist falsch, abgelaufen oder gelöscht: Erstelle ein neues.
  • „dem Token fehlt die Berechtigung Agenten-Tickets“: Erstelle das Token neu mit der Berechtigung Agenten-Tickets.
  • „diese Adresse antwortet nicht wie Zammad“: Prüfe die Adresse; hinter einem Reverse-Proxy unter einem Pfad gib diesen Pfad mit an (https://example.org/zammad).
  • „umgeleitet“: Gib direkt die https://-Adresse an.
  • „Zertifikat abgelehnt“: Aktiviere Selbstsignierte Zertifikate akzeptieren (nur für deinen eigenen Server).
  • Nie ein eskaliertes Ticket: Zammad setzt Eskalationszeiten nur über ein SLA (Verwalten → SLAs) mit einem Kalender.
  • Eine Gruppe unter Verfolgte Gruppen, die es nicht gibt, wird ignoriert: Verbindung testen nennt sie.

Grenzen​

  • Abfrage alle 1 bis 10 Minuten: Ein neues Ticket löst seine Szene bei der nächsten Abfrage aus, nicht sofort (Zammad-Webhooks werden nicht genutzt).
  • Höchstens 1000 Tickets pro Suche: Darüber werden die ältesten offenen Tickets nicht gezählt. Die eskalierten werden getrennt gelesen und immer gezählt.
  • Der Prioritätsfilter bietet die Standardprioritäten von Zammad an; umbenannte Prioritäten lassen sich dort nicht wählen.
  • Ein Ticket, das erstellt wird, während die Integration oder Zammad länger als eine Stunde gestoppt ist, löst seine Szene nicht aus.
  • Nicht mit der Zammad GmbH oder der Zammad Foundation verbunden.

Konfigurationseinstellungen​

Diese Einstellungen fragt Zammad in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Dein ZammadsectionNeinEin Zammad, selbst gehostet oder von Zammad gehostet. In Zammad: Avatar, Profil, Token-Zugang, Erstellen, mit der Berechtigung „Agenten-Tickets“ (ticket.agent). Die Zähler sind die der Gruppen dieses Agenten.
AdressestringJaAdresse von Zammad wie im Browser, mit https:// für HTTPS und :Port, falls nicht der Standard.
ZugriffstokensecretJaProfil, Token-Zugang in Zammad, Berechtigung „Agenten-Tickets“.
OptionensectionNein
Verfolgte GruppenstringNeinNamen durch Kommas getrennt: ein weiteres Gerät pro Gruppe mit eigenen Zählern. Leer: nur das Gerät der Instanz.
Selbstsignierte Zertifikate akzeptierenbooleanNeinFür eine https://-Adresse mit selbstsigniertem Zertifikat. Nur für deinen eigenen Server aktivieren.
AktualisierungsintervallselectNeinWie oft Zammad gelesen wird (sechs Anfragen). Eskalationszeiten und Mitternacht werden immer pünktlich verfolgt.
Sprache der FunktionsnamenselectNeinNamen der Funktionen beim Hinzufügen eines Geräts und an Szenen gesendete Texte.

So installierst du Zammad in Gladys​

  1. Öffne in Gladys Integrationen: Zammad erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-zammad:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-zammad.

Zammad 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​

Zammad 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 guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am