Notificaciones push de Zammad en tu teléfono
Zammad no envía por sí mismo notificaciones push a los teléfonos. Zamio las añade con dos funciones estándar de Zammad: un webhook y un disparador (Trigger). Un administrador de Zammad lo configura una sola vez y se tarda unos cinco minutos. Funciona con Zammad 6 y 7, en servidor propio o en Zammad Cloud.
Cómo funciona
Dos ajustes deciden lo que pasa:
- El disparador decide cuándo. Solo se envía una notificación si se cumplen las condiciones del disparador.
- El grupo del ticket decide quién. La notificación llega a todos los agentes del grupo del ticket que usan Zamio con las notificaciones activadas. Quien hizo el cambio no la recibe.
Paso 1: Registra tu servidor Zammad
- Abre notification.zamio.kaju.pl/setup.html.
- En Zammad Server URL, escribe la dirección de tu Zammad, por ejemplo
https://soporte.empresa.es. Usa exactamente la dirección que escriben tus agentes al iniciar sesión en la app (ver solución de problemas). - En HMAC Signature Token, inventa un secreto de al menos 8 caracteres. Pegarás el mismo valor en Zammad en el paso 2.
- Haz clic en Register Server y copia la URL del webhook. Tiene este aspecto:
https://notification.zamio.kaju.pl/webhook/group?server=https://soporte.empresa.es
El servidor queda a la espera de verificación. Se confirma automáticamente cuando llega desde tu Zammad el primer webhook firmado correctamente.
Paso 2: Crea el webhook en Zammad
- En Zammad, ve a Gestionar → Webhooks → Nuevo webhook (Manage → Webhook → New Webhook).
- Nombre: por ejemplo
Zamio push. - Endpoint: pega la URL del paso 1.
- Token de firma (Signature Token): el mismo secreto que pusiste en el paso 1.
- Deja activada la verificación SSL (SSL Verification).
- Deja desactivado el payload personalizado (Custom Payload). El servicio lee el payload estándar de Zammad (ticket y artículo).
- Guarda.
Paso 3: Crea los disparadores
Un disparador que salta con cada cambio en un ticket inunda a los agentes de notificaciones. Yo lo configuro para tres situaciones en las que vale la pena interrumpir a alguien:
| Situación | Condiciones del disparador |
|---|---|
| Un ticket llega a un grupo | Grupo ha cambiado |
| Un ticket cambia de estado | Estado ha cambiado |
| El cliente responde | Artículo › Acción es creado, y Artículo › Remitente es Cliente |
Zammad combina las condiciones de un mismo disparador con Y, así que lo más sencillo es crear tres disparadores, uno por fila. Si conoces el modo experto de Zammad, puedes juntarlos en un solo disparador con O.
Para cada disparador:
- Ve a Gestionar → Disparadores → Nuevo disparador (Manage → Trigger → New Trigger).
- Activado por (Activated by): Acción.
- Añade las condiciones de la tabla.
- En Ejecutar cambios en objetos (Execute changes on objects), elige Notificación → Webhook y selecciona
Zamio push. - Guarda.
Paso 4: Activa las notificaciones en la app
Cada agente abre Configuración → Notificaciones push en Zamio y permite las notificaciones cuando el teléfono lo pregunte. El teléfono queda registrado para el servidor Zammad en el que el agente ha iniciado sesión.
Paso 5: Pruébalo
Pide a un compañero que responda a un ticket de tu grupo, o inicia sesión en Zammad en el navegador como otro usuario. No recibes notificaciones de tus propios cambios, así que cambiar tú mismo un ticket y esperar la notificación es la falsa alarma más habitual.
Solución de problemas
- Nadie recibe notificaciones
- Revisa la dirección del servidor. Las notificaciones se asocian por la dirección exacta:
httpsfrente ahttp, otro subdominio o un puerto cuentan como servidores distintos. Si registrastehttps://zammad.empresa.espero los agentes inician sesión enhttps://soporte.empresa.es, no coincide nada. Registra la dirección que usan de verdad los agentes. - Zammad muestra un error al enviar el webhook
- Seguramente el token de firma en Zammad no coincide con el secreto que pusiste en la página de configuración. Si el servidor nunca llegó a confirmarse, regístralo de nuevo con otro secreto. Si ya estaba confirmado, la página de configuración rechazará un nuevo registro. Escríbeme a kontakt@kaju.pl y lo restablezco.
- Un agente no recibe notificaciones
- El agente tiene que ser miembro del grupo del ticket en Zammad. En el teléfono, comprueba que las notificaciones de Zamio están permitidas en los ajustes del sistema y luego desactiva y vuelve a activar las notificaciones en la app.
- He activado el payload personalizado (Custom Payload)
- Desactívalo. Sin los objetos estándar
ticketyarticleel servicio no puede crear la notificación y rechaza el webhook. - Uso dos servidores Zammad
- Solo recibes notificaciones del servidor en el que tienes la sesión iniciada en la app.