Skip to content

Mensajes de error comunes de push

Esta página cubre los mensajes de error comunes de la mensajería push.

Push rebotado: MismatchSenderId

MismatchSenderId indica un fallo de autenticación. Firebase Cloud Messaging (FCM) se autentica con un par de datos clave: senderID y clave de API de FCM. Ambos deben validarse para verificar su exactitud. Para más información, consulta la documentación de Android sobre este problema.

Los fallos comunes pueden incluir:

  • senderID incorrecto
  • Registro múltiple si se registran con otro servicio push con un senderID diferente

Push rebotado: InvalidRegistration

InvalidRegistration puede ocurrir cuando un token de notificaciones push está malformado. Los fallos comunes pueden incluir cuando:

  • Las personas pasan tokens de registro de Braze manualmente pero no llaman a getToken(). Por ejemplo, pueden pasar el ID de instancia completo. El token en el mensaje de error se ve como |ID|1|:[regular token].
  • Las personas se registran con múltiples servicios. Actualmente esperamos que los intents de registro push lleguen de la forma antigua, así que si las personas se registran en múltiples lugares y capturamos intents de otros servicios, podemos obtener tokens de notificaciones push malformados.

Push rebotado: NotRegistered

NotRegistered generalmente significa que la aplicación ha sido eliminada del dispositivo (como nuestra señal de desinstalación). Esto también puede ocurrir si hay un registro múltiple y un segundo registro invalida el token de notificaciones push que Braze recibe.

DEVICE_UNREGISTERED

Este error aparece en el Registro de actividad de mensajes como:

Received 'Error: DEVICE_UNREGISTERED, ' sending to '[Token String]'

Esto generalmente ocurre por una de las siguientes razones:

  • El usuario desinstaló la aplicación. Esta es la causa más común. Cuando la aplicación se elimina de un dispositivo, el token de notificaciones push se vuelve inválido.
  • Las credenciales push se actualizaron en la aplicación. Si tu equipo cambió las credenciales o certificados de FCM incluidos en la aplicación, los usuarios que se registraron con las credenciales anteriores tienen tokens inválidos hasta que la aplicación los vuelva a registrar.
  • Una lógica personalizada está cancelando el registro de los usuarios de push. Esto es poco frecuente, pero es técnicamente posible cancelar programáticamente el registro de un dispositivo de push usando el SDK de Firebase/Android.

Error al enviar push porque la carga útil no era válida

Este mensaje puede aparecer en la pestaña Engagement del perfil de usuario en Configuración de contacto > Registro de cambios de push cuando el servicio de notificaciones push de Apple (APNs) rechaza la solicitud push debido a una carga útil no válida.

En Braze, este mensaje del dashboard puede corresponder a una de las siguientes razones de error de APNs:

  • PayloadEmpty: la carga útil no contenía el contenido requerido para el tipo de push que se estaba enviando.
  • PayloadTooLarge: la carga útil excedió el tamaño máximo de carga útil de APNs.

Las causas comunes incluyen:

  • Claves personalizadas (y sus valores) que hacen la carga útil demasiado grande (esto puede incluir valores renderizados por Liquid inesperadamente grandes).
  • Una alerta o cuerpo vacío o faltante donde es requerido (o una carga útil aps malformada de otra manera).

Próximos pasos:

  • Reduce el tamaño de la carga útil recortando claves personalizadas y acortando valores dinámicos grandes.
  • Si envías a través de la API, valida la carga útil JSON final (incluyendo el tamaño) antes de enviar.

Push rebotado: BadToken

El error BadToken puede ocurrir por varias razones:

  • El token de notificaciones push no se está enviando a Braze correctamente (por ejemplo, en registerDeviceToken: o el equivalente de tu plataforma).
    • Verifica el token en el Registro de actividad de mensajes. Generalmente debería verse como una cadena larga de letras y números (como 6e407a9be8d07f0cdeb9e714733a89445f57a89ec890d63867c482a483506fa6). Si no es así, revisa el código involucrado en el envío del token de notificaciones push a Braze.

  • Entorno de aprovisionamiento no coincidente:
    • Si te registras con un certificado de desarrollo e intentas enviar con uno de producción, puedes ver este error.
    • Braze solo admite certificados universales para entornos de producción. Probar push en entornos de desarrollo con un certificado universal no funcionará.
    • Este reporte envía rebotes en producción pero no en desarrollo.

  • Perfil de aprovisionamiento no coincidente:
    • Esto puede ocurrir si tu certificado no coincide con el que se usó para obtener el token. Si se sospecha esto, los próximos pasos incluyen:
      • Asegurarte de que el certificado push que se usa para enviar push desde el panel de Braze y el perfil de aprovisionamiento estén configurados correctamente.
      • Recrear la certificación APNS y luego recrear el perfil de aprovisionamiento después de que el certificado APNS esté configurado para el app_id. Esto a veces puede resolver algunos problemas más visibles.

ID de paquete no permitido

El error TopicDisallowed significa que APNs rechazó el push porque el tema (ID de paquete) en la solicitud no está permitido para las credenciales de autenticación que se están usando. Para resolver esto:

  1. Verifica el ID de paquete. Confirma que el ID de paquete configurado en la configuración de tu aplicación en Braze coincida exactamente con el ID de paquete de tu aplicación. Esto incluye cualquier variación de sufijo (por ejemplo, .debug, .staging).
  2. Verifica tu configuración de autenticación de APNs. Confirma que tu aplicación esté configurada con la clave .p8 de APNs correcta y que la clave esté asociada con el mismo equipo de Apple Developer que la aplicación a la que estás enviando.
  3. Confirma el entorno de la aplicación. Si tienes IDs de aplicación separados en Braze para compilaciones de desarrollo y producción, verifica que cada uno esté configurado con las credenciales push y el entorno correctos.

Unregistered

Este error aparece en el Registro de actividad de mensajes como:

Received 'Unregistered' sending to '[Token String]'

Este es el equivalente en iOS del error DEVICE_UNREGISTERED de Android. Generalmente ocurre por una de las siguientes razones:

  • El usuario desinstaló la aplicación. Esta es la causa más común.
  • Los certificados push se actualizaron. Si tu equipo cambió o renovó los certificados de APNs, los usuarios que se registraron con los certificados anteriores pueden tener tokens inválidos hasta que la aplicación los vuelva a registrar.
  • Una lógica personalizada está cancelando el registro de los usuarios de push. Esto es poco frecuente, pero es técnicamente posible cancelar programáticamente el registro de notificaciones remotas usando el SDK de iOS.

InvalidProviderToken

El error InvalidProviderToken significa que APNs rechazó la solicitud porque el token de autenticación (de una clave .p8) o el certificado push (.p12) no coincide con el ID de paquete o el Team ID de la aplicación. Para resolver esto:

  1. Verifica tu Team ID y Key ID: si estás usando una clave de autenticación .p8, confirma que el Team ID y el Key ID configurados en el panel de Braze (Settings > App Settings > selecciona tu aplicación iOS) coincidan con los valores en tu cuenta de Apple Developer.
  2. Verifica el ID de paquete: asegúrate de que el ID de paquete registrado en Braze coincida con el ID de paquete de tu aplicación. Una discrepancia, como una diferencia en mayúsculas o un sufijo .debug, causa este error.
  3. Vuelve a cargar la clave o el certificado: si la clave .p8 o el certificado .p12 se regeneró o revocó recientemente, carga la nueva clave en Braze y elimina la anterior.
  4. Confirma el entorno de APNs: si estás usando un certificado .p12, verifica que seleccionaste el entorno correcto (desarrollo versus producción) al cargarlo. Para las claves .p8, esto se maneja automáticamente.

Push rebotado: el servicio de retroalimentación de APNS lo eliminó

Esto generalmente ocurre cuando alguien desinstala la aplicación. Braze consulta el servicio de retroalimentación de APNS cada noche para obtener una lista de tokens inválidos. Para más información, consulta la documentación de Apple sobre Comunicación con APNs.
New Stuff!