Zendesk

Plugin para crear tickets en zendesk con pandora.

Introducción

Plugin para gestionar tickets en zendesk. Con este script se pueden crear, actualizar y eliminar tickets de este sistema, desde terminal o desde PandoraFMS.

Matriz de compatibilidad

Sistemas donde se ha probado

CentOS 7, Fedora

Sistemas donde debería funcionar

Cualquier sistema linux 

 

Pre requisitos

Se requiere:

 

* En la versión binaria del plugin no son necesarias estas dependencias puesto que ya vienen incluidas en el.

Configuración

Se tiene que habilitar el acceso a la api con contraseña en zendesk o el de acceso con token. Estas opciones estarán en administrador > API.

image-1641399760071.png

Parámetros

Parámetros

Method -m get,post,put o delete
host -i, --ip nombre de tu sitio zendesk
user -us nombre de tu usuario (email)
password -p password del usuario
token -t  token de la API
ticket name -tn nombre del ticket
ticket comment -tb contenido (texto) del ticket
ticket id -id id del ticket
ticket status -ts new,open,hold, pending,solved o closed
ticket priority -tp urgent,high,normal o low
ticket type -tt problem, incident,question, task

 

Métodos 

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

Crear ticket

Parámetros

Method -m get,post,put o delete
host -i, --ip nombre de tu sitio zendesk
user -us nombre de tu usuario (email)
password -p pass de la API
token -t  token de la API
ticket name -tn nombre del ticket
ticket comment -tb contenido (texto) del ticket
ticket id -id id del ticket
ticket status -ts new,open,hold, pending,solved o closed
ticket priority -tp urgent,high,normal o low
ticket type -tt problem, incident,question, task

Se podrá autenticar en la API con token o pass según lo tengas configurado en zendesk. Para ello introduce el argumento necesario.

Las opciones de creación de grupo son : nombre, comentario (cuerpo del mensaje), status, prioridad y tipo.

La id se le asigna al ticket automáticamente.

Ejemplo de creación de ticket con ejecución manual.

./pandora_zendesk -m post  -i pandoraplugin -us <email> -p <password> -tn "manual" -tb "esto es el contenido de la incidencia" -tp urgent -tt "question" -ts new

Ese comando creara el siguiente ticket :

image-1641400983333.png

image-1641401007730.png

Actualizar ticket

Parámetros

Method -m get,post,put o delete
host -i, --ip nombre de tu sitio zendesk
user -us nombre de tu usuario (email)
password -p pass de la API
token -t token de la API
ticket name -tn nombre del ticket
ticket comment -tb contenido (texto) del ticket
ticket id -id id del ticket
ticket status -ts new,open,hold, pending,solved o closed
ticket priority -tp urgent,high,normal o low
ticket type -tt problem, incident,question, task

 

Ejemplo de actualización de ticket con ejecución manual.

./pandora_zendesk -m put  -i pandoraplugin -us <email> -p <password> -id 19 -tn "yea22h" -tb "Comg" -tp urgent -tt "question" -ts new

Ese comando actualizará el siguiente el siguiente ticket :

image-1641400694458.png

Eliminar ticket

Se borrará un ticket buscando por su id.

Ejemplo con ejecución manual

./pandora_zendesk -m delete -i pandoraplugin -us <email> -p <password> -id 4