Iniciar sesión en Zammad con un token API

Escrito por Michał, el desarrollador de Zamio · Actualizado:

Zamio inicia sesión en Zammad con un token API personal en lugar de una contraseña. Lo introduces una vez y te olvidas de iniciar sesión. Aquí explico qué tiene que activar el administrador y qué hace cada agente.

Por qué un token y no una contraseña

Elegí los tokens por seguridad y porque es la opción más práctica en un teléfono:

  • Tu contraseña nunca pasa por la app. También funciona si entras en Zammad con SSO o usas verificación en dos pasos.
  • Permisos limitados. El token solo recibe ticket.agent, y eso basta para todo lo que hace la app.
  • Puedes revocarlo cuando quieras en Zammad sin cambiar la contraseña, por ejemplo si pierdes el teléfono.
  • Se queda en el dispositivo. El token se guarda en el llavero de iOS (Keychain) o en el Android Keystore. No se almacena en ninguna nube. La app se conecta directamente desde tu teléfono al Zammad de tu empresa.

Para administradores: permitir el acceso por token

  1. En Zammad, abre la configuración de administración (icono del engranaje) y ve a Configuración → Sistema → API.
  2. Activa el acceso por token API (API Token Access).

Si un agente sigue sin ver Acceso por token en su perfil, comprueba que su rol tiene el permiso user_preferences.access_token (Gestionar → Roles).

Para agentes: crear un token

  1. En Zammad, en el navegador, haz clic en tus iniciales o tu avatar en la esquina inferior izquierda y elige Perfil → Acceso por token.
  2. Haz clic en Crear.
  3. Nombre: algo que te diga dónde se usa, p. ej. Zamio – iPhone.
  4. Permisos: marca ticket.agent.
  5. Fecha de caducidad: opcional. Sin ella, el token funciona hasta que lo borres.
  6. Haz clic en Crear y copia el token en ese momento. Zammad solo lo muestra una vez.

Consejo: abre Zammad en el navegador del propio teléfono y crea el token ahí. Así solo tienes que pegarlo en la app y no hace falta que te lo mandes por correo o por chat.

Iniciar sesión en Zamio

  1. URL del servidor: la dirección con la que abres Zammad en el navegador, por ejemplo https://soporte.empresa.es, sin nada detrás del dominio.
  2. Token API: pega el token.

Listo. La sesión sigue abierta hasta que la cierres o hasta que el token caduque o se borre.

Teléfono perdido o empleado que se va

Borra el token en Zammad en Perfil → Acceso por token. La app pierde el acceso a Zammad al instante. La cuenta y la contraseña no cambian.

Solución de problemas

«Token API no válido»
El token se copió incompleto, ha caducado o se ha borrado. Un token existente no se puede volver a ver, así que crea uno nuevo y borra el antiguo.
No veo «Acceso por token» en mi perfil
El administrador no ha activado el acceso por token API o tu rol no tiene user_preferences.access_token. Mira la sección para administradores de arriba.
La app no puede conectarse al servidor
Revisa la dirección: https:// al principio, ninguna ruta detrás del dominio y la misma dirección que usas en el navegador. Si Zammad solo es accesible desde la red de la empresa o por VPN, el teléfono también tiene que estar en esa red.
Faltan tickets o grupos
La app ve exactamente lo que ve tu cuenta de Zammad. Si falta algo, revisa tus grupos y roles en Zammad.

Una vez dentro, el siguiente paso es configurar las notificaciones push.