Diagnóstico de notificaciones push

Guía de diagnóstico para cuando una notificación no llega o no llega a quien debería. Sigue el orden: está puesto de la causa más frecuente a la menos.

El usuario no recibe ninguna notificación

Comprobaciones

1. ¿Aceptó las notificaciones? Si no, no existe token_md5 para ese dispositivo y no hay nada que enviar.
2. ¿Desinstaló y reinstaló la app? El token cambia; el antiguo ya no sirve.
3. ¿Tiene las notificaciones desactivadas en los ajustes del sistema para esa app?
4. ¿Está el token incluido en la audiencia del envío?

Causas habituales

Permiso nunca concedido, token obsoleto tras una reinstalación, o segmentación que no incluía a ese dispositivo. Ver usuarios, dispositivos y tokens.

Llega a unos dispositivos y a otros no

Comprobaciones

1. ¿El patrón es por sistema operativo? Un fallo solo en iOS o solo en Android apunta a la configuración de esa plataforma.
2. ¿Los que no la reciben tienen tokens antiguos?
3. ¿La audiencia se construyó con un CSV exportado hace tiempo?

Causas habituales

Degradación normal de la base de tokens, o una audiencia construida sobre datos desactualizados.

La notificación llega pero no abre el contenido correcto

Comprobaciones

1. ¿La URL del campo url es correcta y pública?
2. ¿Pertenece a un dominio asociado a la app? Ver deep links.
3. ¿La URL ha sido reescrita por una herramienta de tracking?

El envío por API devuelve error

Comprobaciones

1. ¿La cabecera x-api-key es correcta y la clave sigue activa?
2. ¿El payload incluye los campos obligatorios: title, heading y los destinatarios en deviceId?
3. ¿dateEnd, si lo envías, es un timestamp Unix en segundos y está en el futuro?
4. ¿Los valores de deviceId son hashed installation ID vigentes y no identificadores de otro tipo?

Ver API de notificaciones push.

Qué enviar a soporte

Cuanta más de esta información traiga el ticket, menos ida y vuelta:

• Identificador de la app y entorno.
• Fecha y hora aproximada del envío, con zona horaria.
• Cómo se hizo el envío: backoffice o API.
• Si fue por API, el payload enviado sin la API key y la respuesta recibida.
• Uno o dos identificadores concretos de dispositivos que no recibieron la notificación.
• Sistema operativo y versión de los dispositivos afectados.
• Si el problema es generalizado o solo en algunos dispositivos.