Mensajes comunes de error push

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

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

En Braze, este mensaje del dashboard puede corresponder a uno de los siguientes motivos de error de APN:

• PayloadEmpty: La carga útil carecía del contenido necesario para el tipo de push que se estaba enviando.
• PayloadTooLarge: La carga útil superó el tamaño máximo de carga útil de APN.

Las causas más comunes incluyen:

• Las claves personalizadas (y sus valores) hacen que la carga útil sea demasiado grande (esto puede incluir valores renderizados por Liquid inesperadamente grandes).
• Una alerta o un cuerpo vacío o faltante donde sea necesario (o una carga útil aps malformada).

Próximos pasos:

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

El push rebotó: BadToken

El error BadToken puede producirse por varias razones:

• El token de notificaciones push no se envía correctamente a Braze (por ejemplo, en registerDeviceToken: o el equivalente de tu plataforma).
  • Comprueba el token en el Registro de actividad de mensajes. Por lo general, debería tener el aspecto de una larga cadena de letras y números (como 6e407a9be8d07f0cdeb9e714733a89445f57a89ec890d63867c482a483506fa6). Si no es así, comprueba el código relacionado con 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 tipo de notificación rebota en producción, pero no en desarrollo.
    
    
• Perfil de aprovisionamiento no coincidente:
  • Esto puede ocurrir si tu certificado no coincide con el que se utilizó para obtener el token. Si sospechas que este es el caso, los próximos pasos son:
    • Asegúrate de que el certificado push que se utiliza para enviar push desde el panel de Braze y el perfil de aprovisionamiento están configurados correctamente.
    • Vuelve a crear el certificado de APN y, a continuación, vuelve a crear el perfil de aprovisionamiento después de configurar el certificado de APN en app_id. Esto a veces puede resolver algunos problemas más visibles.

ID de paquete no permitido

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

1. Verifica el ID de paquete. Confirma que el ID de paquete configurado en los ajustes de tu aplicación en Braze coincide exactamente con el ID de paquete de tu aplicación. Esto incluye cualquier variación de sufijo (por ejemplo, .debug, .staging).
2. Comprueba tu configuración de autenticación de APN. Confirma que tu aplicación está configurada con la clave .p8 de APN correcta y que la clave está asociada al mismo equipo de desarrollador de Apple que la aplicación a la que estás enviando.
3. Confirma el entorno de la aplicación. Si tienes ID 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. Suele ocurrir por alguna de las siguientes razones:

• El usuario desinstaló la aplicación. Esta es la causa más común.
• Se actualizaron los certificados push. Si tu equipo cambió o renovó los certificados de APN, los usuarios que se registraron con los certificados anteriores pueden tener tokens no vá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 APN 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 ID de equipo de la aplicación. Para resolverlo:

1. Verifica tu ID de equipo y tu ID de clave: Si estás usando una clave de autenticación .p8, confirma que el ID de equipo y el ID de clave configurados en el panel de Braze (Configuración > Configuración de la aplicación > selecciona tu aplicación iOS) coinciden con los valores de tu cuenta de desarrollador de Apple.
2. Comprueba el ID de paquete: Asegúrate de que el ID de paquete registrado en Braze coincide 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 APN: Si estás usando un certificado .p12, verifica que seleccionaste el entorno correcto (desarrollo frente a producción) al cargarlo. Para las claves .p8, esto se gestiona automáticamente.

El push rebotó: Se eliminó del servicio de retroalimentación de APN

Esto suele ocurrir cuando alguien desinstala la aplicación. Braze consulta cada noche el servicio de retroalimentación de APN para obtener una lista de tokens no válidos. Para más información, consulta Comunicación con APN de Apple.