Zammad plugin
Plugin to create, edit or delete tickets in zammad with pandora.
- Introduction
- Compatibility matrix
- Pre requisites
- Configuration
- Parameters
- Create ticket
- Update ticket
- Delete ticket
Introduction
Plugin to manage tickets in Zammad.
Compatibility matrix
| Systems where it has been tested |
CentOS 7, Fedora |
| Systems where it should work |
Any linux system |
Pre requisites
Required:
- Enable basic or API token authentication
- * Python3
- * Module requests
* In the binary version of the plugin it is not necessary to install these dependencies, since they are already included in the plugin.
Configuration
You have to enable token or basic authentication by clicking on manage and then API.
The token can be created by clicking on profile and then on "access token":
For it to work you will have to set ticket.agent to permissions.
Parameters
Parámeter
| Method | -m | get,post,put o delete |
| host | -i, --ip | name site zammad |
| user | -us | name user (email) |
| password | -p | pass API |
| token | -t | token API |
| ticket name | -tn | name ticket |
| ticket comment | -tb | content ticket |
| ticket id | -id | id ticket |
| ticket status | -ts | state |
| ticket priority | -tp | priority |
| ticket type | -tt | type |
| ticket group | -tg | group |
| ticket subject | -tsub | subject |
| ticket customer | -tc | customer (the customer as such is the e-mail address of the registered customer) |
| ticket note | -tnote | note |
Methods
Get to list, post to create ticket, put to update ticket and delete to delete ticket.
Create ticket
Necessary arguments
-m (post)
-i (host)
-us y -p o -t (user and password or token only depending on authentication)
-tn (name ticket)
-tg (name group)
-tp (priority)
-ts (status)
-tsub (subject)
-tb (contenido)
-tt (type)
-tc (customer)
-tnote (note)
Example manual execution :
./pandora_zammad -m post -i pandoraplugin -t <token> -tn "ejemplo creacion" -tg Users -tp 3 -tt note -ts 2 -tsub subject -tb "el contenido de la incidencia" -tnote nota -tc <customer>
In the argument -i (host) I have put pandoraplugin because the name of my site is : https://pandoraplugin.zammad.com/
The ticket will be created:
Update ticket
Necessary arguments
-m (put)
-i (host)
-us y -p o -t (user y password o solo token dependiendo de la autenticación)
-id (id ticket)
-tn (name ticket)
-tg (name group)
-tp (priority
-ts (status)
-tsub (subject)
-tb (content)
-tt (type)
-tc (customer)
-tnote (note)
Example manual execution :
./pandora_zammad -m put -id 3 -i pandoraplugin -t <token> -tn probando123 -tg Users -tp 3 -tt note -ts 2 -tsub <subject> -tb "el contenido de la incidencia" -tnote nota -tc <email>
The ticket will be updated with that id:
Delete ticket
The ticket will be deleted by searching by id.
Example with manual execution.
./pandora_zammad -m delete -i pandoraplugin -t <token> -id 13