Zammad Helpdesk Skill
Use the zammad command to work with tickets in a Zammad helpdesk. The command
is available on PATH after the skill is installed.
The active helpdesk endpoint is https://support.northwind-ops.com.
Authentication uses the current operator token prepared by the runtime.
Commands
| Command | Description | Example |
|---|---|---|
zammad whoami |
Show the current operator | zammad whoami |
zammad status |
Show endpoint and record counts | zammad status |
zammad list |
List tickets | zammad list --state open |
zammad show <ticket_id> |
Show a ticket with its articles | zammad show 101 |
zammad search <query> |
Search tickets and articles | zammad search "billing portal" |
zammad create |
Create a ticket with an initial article | zammad create --title "Quarterly invoice portal issue" --customer "maria.chen@harbor-solar.com" --group "Billing" --body "Customer cannot download the invoice PDF" |
zammad update <ticket_id> |
Update ticket metadata | zammad update 101 --state pending reminder --priority "3 high" |
zammad note <ticket_id> |
Add an article to a ticket | zammad note 101 --body "Sent workaround steps to the customer" |
zammad users |
List or search users | zammad users --query maria |
zammad organizations |
List or search organizations | zammad organizations --query Harbor |
Add --json to any command to print machine-readable JSON.
Typical Workflow
- Run
zammad whoamiorzammad statusto confirm the active endpoint. - Use
zammad listorzammad search "<keyword>"to find the relevant ticket. - Read the full context with
zammad show <ticket_id>. - Use
zammad create,zammad update, orzammad notefor changes. - Restate the returned ticket id, number, state, and any new article id.
REST API Equivalents
The same helpdesk supports the standard Zammad REST API paths:
GET /api/v1/ticketsGET /api/v1/tickets/{id}POST /api/v1/ticketsPUT /api/v1/tickets/{id}GET /api/v1/ticket_articles/by_ticket/{ticket_id}POST /api/v1/ticket_articlesGET /api/v1/usersGET /api/v1/organizations
Prefer the zammad command for routine work because it prints the fields most
useful for an operator.