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

Cambio en un ticket Disparador de Zammad Webhook firmado Servicio de notificaciones de Zamio Apple / Google Teléfonos de los agentes

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

  1. Abre notification.zamio.kaju.pl/setup.html.
  2. 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).
  3. En HMAC Signature Token, inventa un secreto de al menos 8 caracteres. Pegarás el mismo valor en Zammad en el paso 2.
  4. 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

  1. En Zammad, ve a Gestionar → Webhooks → Nuevo webhook (Manage → Webhook → New Webhook).
  2. Nombre: por ejemplo Zamio push.
  3. Endpoint: pega la URL del paso 1.
  4. Token de firma (Signature Token): el mismo secreto que pusiste en el paso 1.
  5. Deja activada la verificación SSL (SSL Verification).
  6. Deja desactivado el payload personalizado (Custom Payload). El servicio lee el payload estándar de Zammad (ticket y artículo).
  7. 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ónCondiciones del disparador
Un ticket llega a un grupoGrupo ha cambiado
Un ticket cambia de estadoEstado ha cambiado
El cliente respondeArtí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:

  1. Ve a Gestionar → Disparadores → Nuevo disparador (Manage → Trigger → New Trigger).
  2. Activado por (Activated by): Acción.
  3. Añade las condiciones de la tabla.
  4. En Ejecutar cambios en objetos (Execute changes on objects), elige Notificación → Webhook y selecciona Zamio push.
  5. 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: https frente a http, otro subdominio o un puerto cuentan como servidores distintos. Si registraste https://zammad.empresa.es pero los agentes inician sesión en https://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 ticket y article el 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.