Zammad Smart-Home-Integration, kostenlos und Open Source

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/zammad7.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â
- In Gladys Integrationen â Zammad installieren.
- 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).
- Adresse: die Adresse von Zammad wie im Browser, z. B.
- Klicke auf Verbindung testen: Es meldet, wie viele Tickets offen und eskaliert sind, und die verfolgten Gruppen, die es nicht gibt.
- 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):
| Funktion | Bedeutung |
|---|---|
| Offene Tickets | Status neu, offen, Erinnerung wartend oder SchlieĂen wartend |
| Neue Tickets | Status neu |
| Wartende Tickets | Status Erinnerung wartend oder SchlieĂen wartend |
| Eskalierte Tickets | offen, nach der Eskalationszeit ihres SLA |
| Nicht zugewiesene Tickets | offen, ohne Besitzer |
| Mir zugewiesene Tickets | offen, im Besitz des Token-Agenten (nur Instanz) |
| Heute erstellte Tickets | seit 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Àt3 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 highauĂ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.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Zammad | section | Nein | Ein 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. |
| Adresse | string | Ja | Adresse von Zammad wie im Browser, mit https:// fĂŒr HTTPS und :Port, falls nicht der Standard. |
| Zugriffstoken | secret | Ja | Profil, Token-Zugang in Zammad, Berechtigung âAgenten-Ticketsâ. |
| Optionen | section | Nein | |
| Verfolgte Gruppen | string | Nein | Namen durch Kommas getrennt: ein weiteres GerÀt pro Gruppe mit eigenen ZÀhlern. Leer: nur das GerÀt der Instanz. |
| Selbstsignierte Zertifikate akzeptieren | boolean | Nein | FĂŒr eine https://-Adresse mit selbstsigniertem Zertifikat. Nur fĂŒr deinen eigenen Server aktivieren. |
| Aktualisierungsintervall | select | Nein | Wie oft Zammad gelesen wird (sechs Anfragen). Eskalationszeiten und Mitternacht werden immer pĂŒnktlich verfolgt. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen beim HinzufĂŒgen eines GerĂ€ts und an Szenen gesendete Texte. |
So installierst du Zammad in Gladysâ
- Ăffne in Gladys Integrationen: Zammad erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- 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). - Ăffne den Bildschirm Konfiguration der Integration, fĂŒlle die Einstellungen aus und speichere.
- 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.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub â Quelle dieser Dokumentation