Guía de Usuario: Gestión de Tickets con Integración Wisphub

Requisitos previos

• Tener acceso activo al módulo de Chat.
• La integración con Wisphub debe estar configurada y operativa.
• El cliente con el que conversas debe estar registrado previamente en Wisphub (o contar con los datos para su búsqueda).

---

Paso a paso para crear un ticket

1 Iniciar la creación: Mientras chateas con un cliente, localiza el botón de "Crear Ticket" en el panel de acciones. Se abrirá una ventana emergente (modal).

2 Sincronizar Catálogos: Al abrirse el formulario, el sistema llamará a Wisphub para cargar los departamentos, staff y asuntos disponibles. Espera un segundo a que las listas se desplieguen.

3 Buscar al Cliente: En el campo de búsqueda, escribe el nombre o la empresa del cliente. El sistema te mostrará sugerencias basadas en tu base de datos de Wisphub. Selecciona la correcta.

4 Completar Detalles: Llena la información del problema, asigna a un responsable y define la prioridad. Recuerda que la claridad aquí ayudará al técnico asignado.

5 Guardar y Confirmar: Haz clic en "Guardar". El sistema validará los datos y enviará el ticket a Wisphub. Recibirás un mensaje de confirmación con el número de ticket generado.

---

Explicación simple de los campos

A continuación, detallamos qué información debe ingresar en cada apartado para que el ticket sea efectivo en Wisphub:

Campo	Descripción
Cliente / Empresa	Usa el buscador para asociar el ticket a una cuenta real en Wisphub. Es vital para la trazabilidad.
Asunto	El título del problema (ej. "Sin señal", "Cambio de clave"). Estas opciones vienen directamente de tu catálogo de Wisphub.
Departamento	Área encargada de resolver el ticket (Soporte Técnico, Ventas, Administración).
Origen	Indica por dónde llegó la solicitud (en este caso, suele ser "Chat" o "WhatsApp").
Staff asignado	Nombre del colaborador que recibirá la tarea en su panel de Wisphub.
Fecha de inicio y cierre	Define cuándo comienza el reporte y la fecha estimada de solución. El formato se ajusta automáticamente.
Estado y Prioridad	Indica qué tan urgente es el caso (Baja, Media, Alta) y su situación actual (Nuevo, En Proceso).

---

Validaciones y reglas importantes

---

Errores comunes y soluciones

Si encuentras problemas al intentar guardar, consulta la siguiente tabla para resolverlos rápidamente:

Mensaje / Problema	Causa Probable	Cómo Resolver
"Error de conexión con Wisphub"	Problemas de red o el servicio de Wisphub está temporalmente fuera de línea.	Verifica tu internet. Si persiste, contacta al administrador para validar la API Key.
"Faltan campos obligatorios"	No seleccionaste Cliente o Asunto.	Revisa los campos resaltados en rojo y completa la información.
"No se encontraron resultados"	El cliente no existe en Wisphub con ese nombre.	Verifica la ortografía o busca por el ID de cliente o empresa.
"Error de validación de Wisphub"	Datos enviados no cumplen con las reglas del sistema externo (ej. formato de texto inválido).	Lee el detalle del mensaje, corrige el dato mencionado y vuelve a intentar.

---

Buenas prácticas de uso

• Sincronización: Si realizaste cambios en los nombres de tu staff en Wisphub hace pocos minutos, dale un momento al sistema para que refresque los catálogos en el chat.
• Precisión: Evita usar el asunto "Otros". Trata de clasificar el ticket correctamente para que las estadísticas de Wisphub sean útiles para la gerencia.
• Seguimiento: Una vez guardado el ticket, informa al cliente el número de folio que el sistema te proporcione. Esto genera confianza.

---

Resultado esperado al guardar

Al hacer clic en el botón de guardar, el sistema realizará lo siguiente:

1. Validará que todos los campos obligatorios tengan información.
2. Enviará los datos a la plataforma Wisphub de manera segura.
3. Confirmación exitosa: Verás un aviso verde indicando que el ticket fue creado.
4. Vínculo: El ticket quedará ligado a la conversación de chat actual para futuras consultas.

---

Preguntas Frecuentes

1. ¿Qué hago si no aparece el staff que necesito asignar?
Verifica en Wisphub que el usuario esté activo y tenga permisos para recibir tickets en el departamento seleccionado.

2. ¿Puedo crear un ticket si el cliente no está en Wisphub?
No directamente desde esta integración. Primero debes dar de alta al cliente en Wisphub para que el buscador del chat pueda encontrarlo.

3. ¿El ticket se actualiza en tiempo real en Wisphub?
Sí, la creación es inmediata. Una vez que recibes la confirmación en el chat, el ticket ya es visible en el panel administrativo de Wisphub.

4. ¿Puedo adjuntar archivos al ticket desde el modal?
Por ahora, el modal permite la creación de la ficha de datos. Los archivos adjuntos deben gestionarse según la configuración de tu empresa (usualmente desde el panel principal de tickets).

5. ¿Por qué me sale "Error de conexión" si mi internet funciona?
Es posible que las credenciales de la integración hayan expirado o que Wisphub esté realizando mantenimiento. Reporta esto a tu supervisor si el error dura más de 5 minutos.

6. ¿Cómo sé que el ticket realmente se guardó?
El sistema siempre te mostrará una notificación de éxito. Si no la ves y el modal se cierra abruptamente, revisa el historial de tickets del cliente para confirmar.

---