Solución de problemas de push
Utiliza esta página para la solución de problemas relacionados con el canal de mensajería push.
Faltan notificaciones push
¿Tienes problemas de entrega con las notificaciones push? Hay una serie de pasos que puedes dar para solucionar este problema comprobando:
- Estado de la suscripción push
- Segmento
- Límites de notificaciones push
- Límites de velocidad
- Estado del grupo de control
- Token de notificaciones push válido
- Tipo de notificación push
- Aplicación actual
Estado de la suscripción push
Las notificaciones push solo se pueden enviar a usuarios suscritos o que hayan dado su adhesión voluntaria. Comprueba tu perfil de usuario en la pestaña Interacción de la sección Perfil de usuario para confirmar si estás registrado activamente para recibir notificaciones push del espacio de trabajo que estás probando. Si estás registrado en varias aplicaciones, las encontrarás enumeradas en el campo Push Registered For:

También puedes exportar los perfiles de usuario utilizando los puntos finales de exportación de Braze:
Cualquiera de los dos puntos finales devolverá un objeto de token de notificaciones push que incluye información de habilitación push por dispositivo.
Segmento
Asegúrate de que entras en el segmento al que te diriges (si se trata de una campaña en vivo y no de una prueba). En el perfil de usuario, verás una lista de los segmentos en los que se encuentra actualmente el usuario. Recuerda que se trata de una variable en constante cambio, ya que la segmentación se actualiza en tiempo real.

También puedes confirmar que el usuario forma parte del segmento utilizando Búsqueda de usuarios al crear un segmento.

Límites de notificaciones push
Comprueba los límites globales de frecuencia. Es posible que no hayas recibido la notificación push porque tu espacio de trabajo tiene establecida una limitación de frecuencia global y ya has alcanzado tu límite de notificaciones push para el periodo de tiempo especificado.
Para ello, comprueba la limitación de frecuencia global en el dashboard. Si la campaña está configurada para cumplir las normas de limitación de frecuencia, habrá una serie de usuarios afectados por esta configuración.

Límites de velocidad
Si tienes configurado un límite de velocidad para tu campaña o Canvas, es posible que dejes de recibir mensajes por superar este límite. Para obtener más información, consulta Límite de velocidad.
Estado del grupo de control
Si se trata de una campaña de un solo canal o de un Canvas con un grupo de control, es posible que estés cayendo en el grupo de control.
- Comprueba la distribución de variantes para ver si hay un grupo de control.
- Si es así, crea un segmento que filtre por grupo de control de la campaña, exporta el segmento y comprueba si tu ID de usuario aparece en esta lista.
Token de notificaciones push válido
Un token de notificaciones push es un identificador que los remitentes utilizan para dirigirse a dispositivos específicos con una notificación push. Por tanto, si el dispositivo no tiene un token de notificaciones push válido, no hay forma de enviarle una notificación push.
Tipo de notificación push
Comprueba que estás utilizando el tipo correcto de notificación push. Por ejemplo, si quieres dirigirte a un FireTV, entonces utilizarías una notificación push de Kindle, no una campaña push de Android. Del mismo modo, si deseas dirigirte a un dispositivo Android, utiliza una notificación push para Android y no una campaña push para iOS. Consulta los siguientes artículos para obtener más información sobre el flujo de trabajo de Braze:
Aplicación actual
Cuando pruebes los envíos push con usuarios internos, asegúrate de que el usuario que deseas que reciba la notificación push esté conectado a la aplicación correspondiente. Esto puede provocar que el usuario no reciba una notificación push o que reciba una notificación push para la que crees que no está segmentado.
Al hacer clic en una notificación push no se abre la aplicación
Si al hacer clic en una notificación push no se abre tu aplicación, comprueba lo siguiente según tu plataforma.
Android
- Verifica el comportamiento al hacer clic: Confirma que la campaña está configurada para abrir la aplicación al hacer clic.
- Comprueba el manejo de vínculos profundos: En tu archivo
braze.xml, comprueba sicom_braze_handle_push_deep_links_automaticallyestá configurado comotrueofalse.- Si está configurado como
true, el SDK de Braze maneja los vínculos profundos directamente y la aplicación debería abrirse como se espera. - Si está configurado como
false, tu aplicación necesita un receptor de difusión para escuchar y manejar las intenciones de push recibidas y abiertas. Verifica que este receptor esté implementado correctamente.
- Si está configurado como
- Recopila registros detallados: Habilita el registro detallado, reproduce el problema y proporciona los registros junto con tu
braze.xmlyAndroidManifest.xmlal soporte de Braze.
iOS
- Verifica el comportamiento al hacer clic: Confirma que la campaña está configurada para abrir la aplicación al hacer clic.
- Comprueba la integración push: La vinculación en profundidad desde una notificación push hacia la aplicación se maneja automáticamente mediante la integración push estándar de Braze. Confirma que la integración esté implementada correctamente, incluyendo cualquier manejo de delegado personalizado.
- Recopila registros detallados: Habilita el registro detallado, reproduce el problema y proporciona los registros al soporte de Braze.
Los clics push se abren inesperadamente en la aplicación
Si tienes problemas con enlaces en notificaciones push que se abren inesperadamente en tu aplicación en lugar de en tu navegador web, es posible que haya un problema con la configuración de tu campaña o la implementación del SDK. Consulta estos pasos para obtener ayuda.
Verificar el comportamiento al hacer clic
En tu campaña o paso en Canvas, comprueba que la opción Abrir URL web dentro de la aplicación móvil no esté seleccionada. Si lo está, desmarca la selección y vuelve a lanzar.

La interacción predeterminada para el comportamiento al hacer clic «Abrir URL web» varía según la versión del SDK. Para las versiones del SDK iOS 2.29.0 y Android 2.0.0 y superiores, esta opción está seleccionada de forma predeterminada y las URL web se abrirán en una vista web dentro de la aplicación. Antes de estas versiones, esta opción está desactivada de forma predeterminada y las URL web se abren en el navegador web predeterminado del dispositivo.
Si este no es el problema, es posible que haya un problema con la implementación de push.
Comprueba dos veces la integración push
Si los enlaces de tus notificaciones push se abren inesperadamente en la aplicación, puede que se deba a problemas con la integración de las notificaciones push o con la configuración personalizada. Sigue estos pasos para la solución de problemas:
- Revisa la implementación del delegado push: Asegúrate de que el delegado push de Braze se haya implementado correctamente. Para obtener instrucciones detalladas, consulta la guía de integración de notificaciones push para tu plataforma.
- Inspecciona el manejo de enlaces personalizados: Comprueba si la aplicación incluye un manejo personalizado para todos los enlaces
https://. Las configuraciones personalizadas pueden anular los comportamientos predeterminados. Colabora con tu equipo de desarrollo para revisar y ajustar esta configuración si es necesario. - Verifica el registro de notificaciones push en iOS: Para iOS, vuelve al paso 1 de la guía de integración de notificaciones push sobre el registro de notificaciones push con APN. Asegúrate de que tu objeto delegado se asigne de forma sincrónica antes de que la aplicación termine de iniciarse. Este paso debe completarse en el método
application:didFinishLaunchingWithOptions:. - Prueba tu integración: Después de realizar los ajustes, comprueba el funcionamiento de las notificaciones push en dispositivos iOS y Android para confirmar que el problema se ha resuelto.
El título push se corta en iOS pero se muestra correctamente en Android
Si el título de tu notificación push contiene personalización con Liquid y aparece completo en Android pero truncado en iOS, esto se debe a cómo cada plataforma maneja los caracteres de nueva línea (\n) en la cadena del título.
Android elimina automáticamente los espacios en blanco, tabulaciones y saltos de línea de las cadenas del título push. iOS no lo hace, por lo que si una variable Liquid se resuelve con un valor que contiene un salto de línea al final, iOS trata el salto de línea como el final del título y corta el texto restante.
Por ejemplo, un título como Regarding your flight from {{${city_from}}} to {{${city_to}}} podría mostrar Regarding your flight from en iOS si la variable city_from incluye un salto de línea al final.
Para solucionar esto, aplica el filtro Liquid strip_newlines y envuelve todo el título en un bloque capture:
1
2
{% capture title %}Regarding your flight from {{${city_from}}} to {{${city_to}}}{% endcapture %}
{{ title | strip_newlines }}
Las notificaciones push web no funcionan como se esperaba
Si tienes problemas con las notificaciones push en tu navegador, es posible que tengas que restablecer los permisos de notificación de tu sitio y borrar el almacenamiento del mismo. Consulta estos pasos para obtener ayuda.
Restablecer Chrome en el escritorio
- Junto a tu URL en el navegador Chrome, selecciona el icono deslizante Ver información del sitio.
- En Notificaciones, selecciona Restablecer permiso.
- Abre Chrome DevTools. A continuación se indican los atajos relevantes por sistema operativo.
| OS | Atajos de teclado |
|---|---|
| Mac | Fn + F12Ctrl + Shift + I |
| Windows | F12Ctrl + Shift + I |
- En DevTools, ve a la pestaña Application.
- En la barra lateral, selecciona Storage.
- Selecciona Clear site data.
- Chrome te pedirá que vuelvas a cargar la página para aplicar la configuración actualizada. Selecciona Reload.
Tus permisos push se han restablecido. Abre una pestaña nueva en tu sitio y pruébalo.
Restablecer Chrome en Android
Si tienes una notificación de tu sitio visible en el cajón de notificaciones de tu Android:
- Desde la notificación push, pulsa y selecciona Configuración del sitio.
- En Configuración del sitio, pulsa Borrar y restablecer.
Si no tienes una notificación de tu sitio abierta:
- Abre Chrome en Android.
- Pulsa en el menú .
- Ve a Configuración > Configuración del sitio > Notificaciones.
- Verifica que las notificaciones estén configuradas para Preguntar antes de enviar (recomendado).
- Encuentra tu sitio en la lista.
- Selecciona la entrada y pulsa Borrar y restablecer.
Tus permisos push se han restablecido. Abre una pestaña nueva en tu sitio y pruébalo.
Restablecer Firefox en el escritorio
- Junto a la URL de tu sitio, selecciona o .
- En Permisos, junto a Recibir notificaciones, selecciona para borrar los permisos de notificación.
- En el mismo menú, selecciona Borrar cookies y datos del sitio.
- En el cuadro de diálogo para confirmar tu elección, selecciona Aceptar.
Tus permisos push se han restablecido. Abre una pestaña nueva en tu sitio y pruébalo.
Restablecer Firefox en Android
Para restablecer los permisos push en Android, consulta este artículo de soporte de Mozilla.
Restablecer Safari en macOS
Estos pasos son solo para macOS, ya que Apple no admite la notificación push web para Safari en Windows.
- Abre Safari.
- En la barra de menús del Mac, ve a Safari > Configuración > Sitios web > Notificaciones.
- Selecciona tu sitio de la lista.
- Selecciona Eliminar para eliminar los permisos de notificación del sitio.
- A continuación, ve a Privacidad > Gestionar datos del sitio web.
- Selecciona tu sitio de la lista.
- Selecciona Eliminar o, para eliminar todos los datos del sitio, selecciona Eliminar todo.
- Selecciona Hecho.
Tus permisos push se han restablecido. Abre una pestaña nueva en tu sitio y pruébalo.
Mensajes de error push
Para obtener información detallada sobre los mensajes de error push más comunes (como DEVICE_UNREGISTERED, Unregistered, NotRegistered y otros), consulta Mensajes de error push comunes.
¿Aún necesitas ayuda? Abre un ticket de soporte.
Editar esta página en GitHub