Zammad is het helpdesk en support ticketing systeem binnen ASD-PMA. Het biedt ticket management, knowledge base, automation en multi-channel support.
| Eigenschap | Waarde |
|---|---|
| Poort | 9120 |
| Container | asd-zammad |
| Database | PostgreSQL (asd-zammad-postgres) |
| Cache | Redis + Memcached |
| Health endpoint | / |
| Categorie | Support |
| Classificatie | Secondary |
| Trigger | Actie |
|---|---|
| Nieuw ticket | Toewijzen aan groep |
| SLA bijna verlopen | Notificatie agent |
| Ticket gesloten | Feedback email |
| Keyword match | Tag toevoegen |
Zammad biedt een REST API.
# Via UI: Profile > Token Access > Create
# Of via Admin > System > API
# Lijst tickets
curl -s "http://localhost:9120/api/v1/tickets" \
-H "Authorization: Token token=YOUR_TOKEN" | jq .
# Ticket details
curl -s "http://localhost:9120/api/v1/tickets/123" \
-H "Authorization: Token token=YOUR_TOKEN" | jq .
# Ticket aanmaken
curl -X POST "http://localhost:9120/api/v1/tickets" \
-H "Authorization: Token token=YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Nieuwe support vraag",
"group": "Users",
"customer_id": "guess:customer@example.com",
"article": {
"subject": "Support vraag",
"body": "Ik heb hulp nodig met...",
"type": "note",
"internal": false
}
}'
| Command | Omschrijving |
|---|---|
just start zammad |
Start Zammad stack |
just stop zammad |
Stop Zammad |
just status zammad |
Bekijk status |
just logs zammad |
Bekijk logs |
just info zammad |
Service info |
just backup zammad |
Backup database |
# Rails console
docker exec -it asd-zammad-rails rails c
# Zammad CLI
docker exec -it asd-zammad-rails zammad run rails c
Zammad gebruikt SAML voor SSO (geen OAuth2):
sso:
type: saml
redirect_path: /auth/saml/callback
quirks:
- Uses SAML (not OAuth2)
- Requires manual UI configuration
- Configure via Admin > Security > Third-party Applications
Authentik: SAML Provider aanmaken
http://IP:9120/auth/saml/callbackhttp://IP:9120/auth/saml/metadataZammad: Admin > Security > Third-party > SAML
Let op: Programmatische SAML configuratie is geblokkeerd door Zammad API validatie.
Zammad kan notificaties sturen naar Mattermost:
# In Zammad: Admin > Integrations > Webhook
Type: Webhook
Endpoint: https://mattermost.example.com/hooks/xxx
Events: ticket.create, ticket.update
# Alle Zammad containers
docker ps --filter "name=asd-zammad"
# Rails logs
docker logs asd-zammad-rails --tail 100
# Scheduler logs
docker logs asd-zammad-scheduler --tail 50
# Test email configuratie
docker exec -it asd-zammad-rails rails r "Channel.find(1).fetch"
# Check email channels
docker exec -it asd-zammad-rails rails r "Channel.all.each{|c| puts c.inspect}"
# Check SAML configuratie
docker exec -it asd-zammad-rails rails r "Setting.get('auth_saml')"
# SAML logs
docker logs asd-zammad-rails 2>&1 | grep -i saml