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.

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 🙂