# Zammad

# Introducción

Plugin para gestionar *tickets* en Zammad, puedes crear, eliminar y actualizar *tickets*.

[SIGUIENTE >](https://pandorafms.com/guides/public/books/zammad/page/matriz-de-compatibilidad)

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="border-collapse: collapse; width: 100%; height: 84px;"><tbody><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Sistemas donde se ha probado**</td><td style="width: 50%; height: 28px;">CentOS 7, Fedora.

</td></tr><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Sistemas donde debería funcionar**</td><td style="width: 50%; height: 28px;">Cualquier sistema GNU/Linux.

</td></tr></tbody></table>

[ &lt; ANTERIOR](https://pandorafms.com/guides/public/books/zammad/page/introduccion) [SIGUIENTE &gt;](https://pandorafms.com/guides/public/books/zammad/page/pre-requisitos)

# Pre requisitos

Se requiere:

- Habilitar autenticación básica o mediante *token* de la API.
- \* Python3 .
- \* Librería `requests`.

**\* En la versión binaria del *plugin* no es requerido tener estas dependencias puesto que ya vienen incluidas en el compilado.**

[&lt; ANTERIOR](https://pandorafms.com/guides/public/books/zammad/page/matriz-de-compatibilidad) [SIGUIENTE &gt;](https://pandorafms.com/guides/public/books/zammad/page/configuracion)

# Configuración

Se tiene que habilitar la autenticación mediante *token* ( **Access Token** ) o básica ( **Acceso a Password** ) haciendo clic en **Administrar** y luego en **API**.

[![pfms-bookstack-zimmad-image-01.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/pfms-bookstack-zimmad-image-01.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/pfms-bookstack-zimmad-image-01.png)

El *token* se crea haciendo clic en **Perfil** y luego en **Access token**:

[![pfms-bookstack-zimmad-image-02.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/pfms-bookstack-zimmad-image-02.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/pfms-bookstack-zimmad-image-02.png)

Para que funcione debe poner `ticket.agent` en permisos.

[&lt; ANTERIOR](https://pandorafms.com/guides/public/books/zammad/page/pre-requisitos) [SIGUIENTE &gt;](https://pandorafms.com/guides/public/books/zammad/page/parametros)

# Parámetros

**Parámetros**

<table border="1" id="bkmrk-method--m-get%2Cpost%2Cp" style="height: 435px;"><tbody><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">Method</td><td style="height: 29px; width: 56.3594px;">-m</td><td style="height: 29px; width: 195.172px;">get,post,put o delete</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">host</td><td style="height: 29px; width: 56.3594px;">-i, --ip</td><td style="height: 29px; width: 195.172px;">nombre de tu sitio zammad</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">user</td><td style="height: 29px; width: 56.3594px;">-us</td><td style="height: 29px; width: 195.172px;">nombre de tu usuario (email)</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">password</td><td style="height: 29px; width: 56.3594px;">-p</td><td style="height: 29px; width: 195.172px;">pass de la API</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">token</td><td style="height: 29px; width: 56.3594px;">-t </td><td style="height: 29px; width: 195.172px;">token de la API</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket name</td><td style="height: 29px; width: 56.3594px;">-tn</td><td style="height: 29px; width: 195.172px;">nombre del ticket</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket comment</td><td style="height: 29px; width: 56.3594px;">-tb</td><td style="height: 29px; width: 195.172px;">contenido (texto) del ticket</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket id</td><td style="height: 29px; width: 56.3594px;">-id</td><td style="height: 29px; width: 195.172px;">id del ticket</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket status</td><td style="height: 29px; width: 56.3594px;">-ts</td><td style="height: 29px; width: 195.172px;">estado</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket priority</td><td style="height: 29px; width: 56.3594px;">-tp</td><td style="height: 29px; width: 195.172px;">prioridad</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket type</td><td style="height: 29px; width: 56.3594px;">-tt</td><td style="height: 29px; width: 195.172px;">tipo</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket group</td><td style="height: 29px; width: 56.3594px;">-tg</td><td style="height: 29px; width: 195.172px;">grupo</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket subject</td><td style="height: 29px; width: 56.3594px;">-tsub</td><td style="height: 29px; width: 195.172px;">subject</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket customer</td><td style="height: 29px; width: 56.3594px;">-tc</td><td style="height: 29px; width: 195.172px;">customer (el customer como tal es el correo del customer registrado)</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket note</td><td style="height: 29px; width: 56.3594px;">-tnote</td><td style="height: 29px; width: 195.172px;">nota</td></tr></tbody></table>

**Métodos**

Get para listar, post para crear ticket, put para actualizar ticket y delete para borrar ticket .

# Crear ticket

**Argumentos necesarios**

-m (post)

-i (host)

-us y -p o -t (user y password o solo token dependiendo de la autenticación)

-tn (nombre ticket)

-tg (nombre grupo)

-tp (prioridad)

-ts (status)

-tsub (subject)

-tb (contenido)

-tt (tipo)

-tc (customer)

-tnote (nota)

Ejemplo ejecución manual :

```
./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>
```

**En el argumento -i (host) he puesto pandoraplugin porque el nombre de mi sitio es : https://pandoraplugin.zammad.com/**

Se creará el ticket :

[![image-1641912120586.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641912120586.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641912120586.png)

# Actualizar ticket

**Argumentos necesarios**

-m (put)

-i (host)

-us y -p o -t (user y password o solo token dependiendo de la autenticación)

-id (id ticket)

-tn (nombre ticket)

-tg (nombre grupo)

-tp (prioridad)

-ts (status)

-tsub (subject)

-tb (contenido)

-tt (tipo)

-tc (customer)

-tnote (nota)

Ejemplo ejecución manual :

```
./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>
```

Se actualizará el ticket con esa id:

[![image-1641911410297.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641911410297.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641911410297.png)

# Eliminar ticket

Se eliminará el ticket buscando por id.

**Ejemplo con ejecución manual.**

```
./pandora_zammad -m delete  -i pandoraplugin -t <token> -id 13 
```