- Home
- Integrations
- Zammad
Incident Management
Connect WizStatus to Zammad
Automatically open and close Zammad tickets when WizStatus detects incidents. The integration uses Zammad's HTTP Token authentication, supports priority and group routing, and adds articles for every incident state change to keep an auditable conversation in your helpdesk.
Benefits
- Automatic ticket creation when incidents fire
- Bi-directional sync: closing the Zammad ticket auto-resolves the WizStatus incident
- Priority derived from incident severity, overridable per channel
- Self-hosted helpdesk friendly (no SaaS lock-in)
- Full audit trail via ticket articles for every event
Setup Guide
Follow these steps to set up the integration
Generate a Zammad HTTP Token
In Zammad, open Profile > Token Access > "Add new". Grant ticket.agent permission and copy the generated token.
Warning
The token is shown only once — store it securely.
Identify the target group and customer
Decide which Zammad group should own the tickets (e.g. "Support") and the customer email used as the requester for monitoring tickets.
Tip
Create a dedicated Zammad customer like monitoring@yourcompany to keep monitoring tickets isolated.
Configure the channel in WizStatus
Go to Settings > Alert Contacts, add a new channel, pick Zammad, and paste your instance URL, token, group and customer email.
Tip
Override the priority if you want all alerts to land at the same Zammad priority instead of mapping from severity.
Send a test notification
Use the Test button on the channel card. WizStatus calls /api/v1/users/me to verify the token and reports the result.
Tip
If the test fails, check that the token has ticket.agent rights and that the WizStatus pod can reach your Zammad URL.
Enable bi-directional sync (optional)
Generate a webhook secret in the channel form (or paste your own), then in Zammad Admin > System > Webhooks create a webhook pointing to https://wizstatus.com/api/monitoring/webhook/zammad/<channel_id>/, sign with the same secret (HMAC SHA256, header X-Hub-Signature-256), and attach it to a Trigger that fires on ticket state changes.
Tip
Without the webhook the integration remains one-way: WizStatus opens and closes tickets, but closing a ticket in Zammad does not affect the WizStatus incident.
Configuration Options
Available configuration settings
| Option | Description | Required |
|---|---|---|
Instance URL | Base URL of your Zammad instance (HTTPS recommended) | |
HTTP Token | Zammad HTTP token with ticket.agent permission | |
Group | Zammad group owning the created tickets | |
Customer Email | Email of the Zammad customer attached to the ticket | |
Priority | Override the severity-derived priority (1 low / 2 normal / 3 high) | |
Close State | Zammad state used on resolution (defaults to "closed") | |
Inbound Webhook Secret | Shared secret for HMAC SHA256 verification of inbound Zammad triggers. Required to enable bi-directional sync. |
Features
Limitations
- Custom Zammad fields are not exposed in the channel config
Frequently Asked Questions
Ready to Get Started?
Start monitoring your services in minutes
Get started for freeNo credit card required • 20 free monitors forever