Saltar a contenido

OTRS

Integrar OTRS con la Plataforma Web Redborder manager

Esta documentación proporciona una guía paso a paso para integrar OTRS con la Plataforma Web Redborder. Al seguir estas instrucciones, podrás crear un Servicio Web en OTRS, lo que te permitirá realizar solicitudes POST para crear tickets.

Esta documentación está basada en la versión 6.0.40 de OTRS Community Edition.

Ejemplo del Endpoint de la API

Aquí tienes un ejemplo del endpoint de la API que crearás:

Create Ticket API Endpoint
http://<maquina-virtual-ip>/otrs/nph-genericinterface.pl/Webservice/redborder/CreateTicket?UserLogin=root@localhost&Password=redborder

Parámetros

  • <url>: La URL base de tu instancia de OTRS. Por ejemplo, http://<maquina-virtual-ip> en un entorno de desarrollo, o https://example.com en un entorno de producción.
  • UserLogin: El nombre de usuario del usuario que realizará la solicitud. En este ejemplo, es root@localhost.
  • Password: La contraseña del usuario especificado en UserLogin.

Parámetros Configurables

  • <web-service>: El nombre del servicio web que crearás, como redborder.
  • <route-mapping>: El mapeo de ruta para la solicitud, que será para la creación de tickets.

La estructura general del endpoint de la API con parámetros es la siguiente:

API de la creación de tickets visto con parámetros
<url>/otrs/nph-genericinterface.pl/Webservice/<web-service>/<route-mapping>?UserLogin=<username>&Password=<password>

Pasos para Crear un Servicio Web en OTRS

Sigue estos pasos para crear un servicio web en OTRS:

Note

Ten en cuenta que necesitas un rol de administrador para configurar un Servicio Web.

Inicia sesión como usuario admin y ve al Panel de Administración.

  • Inicia sesión en tu portal web de OTRS con una cuenta de administrador.
  • Navega al Panel de Administración.

Acceder a Servicios Web

  • Desplázate hacia abajo hasta la tarjeta de Servicios Web (Web Services en inglés) y haz clic en ella.

Añadir Nuevo Servicio Web

  • Haz clic en el botón "Añadir Servicio Web" (Add Web Service en inglés).

Nombrar el Servicio Web

  • En el panel General, introduce el nombre del servicio web, como por ejemplo redborder.

Configurar la Operación de Creación de Tickets

  • Añade la operación Ticket::TicketCreate en la sección "OTRS as provider".

Establecer Detalles de la Operación

  • Establece el Nombre de la operación, por ejemplo, Create a Ticket (en inglés).

Configurar el Transporte de Red

  • Establece HTTP::REST como el Transporte de Red y haz clic en "Configure" (en inglés).

Definir el Mapeo de Ruta

  • Establece el Route Mapping for Operation a /CreateTicket, Maximum message length a 100000 and Send Keep-Alive a No (en inglés).

Guardar el Servicio Web

  • Haz clic en "Save and finish" para finalizar y generar el servicio web.

Configurar la Interfaz Web de Redborder para Usar la API de OTRS

  1. Ve a Herramientas -> Integraciones.
  2. Haz click en la carta llamada "Integración con la API de OTRS" (en el botón de "Empezar").
  3. Rellena todos los campos.
  4. Presiona el botón "Actualizar" para aplicar los cambios.

Ejemplo del endpoint creado
http://<pagina-web-otrs>/otrs/nph-genericinterface.pl/Webservice/redborder/CreateTicket?UserLogin=root@localhost&Password=redborder