Solución de problemas de notificaciones push de WNS

En este tema se describen los pasos de solución de problemas iniciales que debe realizar al encontrar problemas con las notificaciones de icono, notificación del sistema y distintivos, incluidos los distintos métodos de notificación: local, push, periódico y notificaciones programadas.

Solución de errores específicos

En esta sección se tratan algunos errores comunes que puede encontrar al trabajar con notificaciones push.

• Comprobación de los registros de eventos
• La notificación push recibe una respuesta "200 OK", pero no se muestra
• La notificación push devuelve un código distinto de "200 OK"
• Errores al intentar crear un canal de notificación push

Comprobación de los registros de eventos

Si las notificaciones push de fichas o toasts no se muestran como se esperaba, consulte los registros de eventos.

• Si se recibe la notificación pero no se muestra: inicie el Visor de eventos y examine el registro Microsoft-Windows-TWinUI/Operational en Aplicaciones y servicios\Microsoft\Windows\Apps.
• Si la notificación no se recibe en absoluto: inicie el Visor de eventos y examine el registro operativo en Aplicaciones y servicios\Microsoft\Windows\PushNotifications-Platform.

La notificación push recibe una respuesta "200 OK", pero no se muestra

Si Los Servicios de notificaciones push de Windows (WNS) devuelven una respuesta "200 OK", entonces entregará la notificación al cliente si el cliente está en línea. Si ha comprobado que el cliente está en línea pero no muestra la notificación, siga estos pasos:

• Causa: errores XML en el contenido de la notificación.

  Corrección: compruebe la sintaxis XML básica y asegúrese de que el XML está completo y correcto. Algunos puntos comunes de error en el contenido XML incluyen lo siguiente:

  • Case sensitivity. Los nombres de etiquetas, los nombres de atributos y los valores de atributos son sensibles a mayúsculas y minúsculas. Asegúrese de que el uso de mayúsculas y minúsculas en XML es correcto.
  • Se debe proporcionar un elemento vinculante para cada formato de mosaico compatible. Debe proporcionar un enlace elemento para cada uno de los tamaños de icono que admita en cada notificación que envíe.
  • Las cadenas de texto no deben contener caracteres XML reservados. Por ejemplo, no puede poner en cursiva las cadenas de teja o mensajes emergentes incluyendo las etiquetas <i> y </i>. Si piensa mostrar los caracteres literales "<i>", deben escaparse correctamente. Para obtener más información sobre los caracteres de escape en XML, vea Entidades de caracteres XML y XAML.
  • Los valores proporcionados para los atributos de lang deben ajustarse a la especificación de ITEF BCP 47.
  • Las cadenas XML enviadas a través de notificaciones push deben usar la codificación UTF-8.
  • Si incluye un elemento de imagen en su carga XML con un atributo src no vacío, debe asegurarse de incluir una referencia a una imagen válida o la notificación será descartada.

• Causa: Uso incorrecto de los parámetros de la API de notificaciones push

  Corregir: consulte la documentación de la API en el espacio de nombres Windows.Networking.PushNotifications para obtener información específica.

• Causa: El tipo de encabezado no coincide con el contenido de la notificación. Si el encabezado X-WNS-Type no está establecido en un valor—tile, distintivo o mensaje breve—que corresponde a la plantilla de notificación especificada en la carga útil, no se mostrará la notificación. Esta falta de coincidencia provocará un error en el cliente y se quitará la notificación.

  Corregir: consulte encabezados de solicitud y respuesta del servicio de notificaciones push para asegurarse de que el servidor de aplicaciones usa el valor correcto para el encabezado X-WNS-Type.

• Causa: el valor de tiempo de vida (TTL), establecido en el encabezado X-WNS-TTL, es demasiado pequeño.

  Corrección: proporcione un valor TTL mayor, teniendo en cuenta que el valor se proporciona en segundos.

Si aún no ve la notificación mostrada después de abordar los puntos de los pasos anteriores, consulte los pasos de solución de problemas para las notificaciones locales en la sección La notificación de baldosa local no se muestra de este tema para recibir más sugerencias.

La notificación push devuelve un código distinto de "200 OK"

Si WNS no devuelve "200 OK", la notificación no se entregará al cliente. Si el código de retorno está en los 400, usted, como desarrollador, debería ser capaz de solucionar el problema.

• La solicitud de notificación devuelve "400 solicitud incorrecta"
• La solicitud de notificación devuelve "401 No autorizado"
• La solicitud de notificación devuelve "401 No autorizado", el token ha expirado.
• La solicitud de notificación devuelve "403 Prohibido"
• La solicitud de notificación devuelve "404 No encontrado"
• La solicitud de notificación devuelve "406 No aceptable"
• La solicitud de notificación devuelve "410 Gone"

La solicitud de notificación devuelve "400 solicitud incorrecta"

• Causa: el uso de uno o varios encabezados WNS podría ser incorrecto o la solicitud HTTP no era válida.

  Corregir: consulte encabezados de solicitud y respuesta del servicio de notificaciones push para asegurarse de que su servidor de aplicaciones esté usando todos los encabezados personalizados según se describe.

La solicitud de notificación devuelve "401 No autorizado"

• Causa: El servidor de aplicaciones debe usar el identificador de seguridad de paquete correcto (SID de paquete) y la clave secreta que se le ha proporcionado al registrar la aplicación. Si has cambiado recientemente tu clave secreta en el Panel de la Tienda Windows, también tendrás que actualizar el servidor de aplicaciones.

  corregir: visita el Panel de la Tienda Windows para comprobar el SID del paquete y el secreto.

La solicitud de notificación devuelve "401 No autorizado", el token ha expirado.

• Causa: un token de acceso tiene una duración finita. Si envía una notificación con un token de acceso expirado, las credenciales del servidor de aplicaciones no son válidas y no se puede enviar la notificación.

  Corregir: Solicite un nuevo token de acceso de WNS autenticándose con el Identificador de Seguridad del Paquete (SID del paquete) y la clave secreta. Para obtener más información, consulte el resumen de Windows Push Notification Services (WNS)

La solicitud de notificación devuelve "403 Prohibido"

• Causa: este error se produce cuando el token de acceso que presentó no coincide con las credenciales necesarias para enviar notificaciones a la dirección URL del canal correspondiente. Todas las aplicaciones deben registrarse en la Tienda Windows para recibir credenciales para su servidor de aplicaciones. Para cada aplicación, solo se pueden usar las credenciales proporcionadas por la Tienda Windows para enviar notificaciones a esa aplicación y solo se pueden usar para esa aplicación concreta.

  Corrección: Inicie sesión en el panel de la Tienda Windows con su cuenta de desarrollador. Seleccione la aplicación y haga clic en "Características avanzadas" -> "Administrar la configuración del servicio en la nube". Seleccione "Identificar la aplicación" para leer las instrucciones sobre cómo actualizar el manifiesto de la aplicación para que coincida con las credenciales del servicio en la nube.

La solicitud de notificación devuelve "404 No encontrado"

• Causa: este error normalmente significa que la dirección URL del canal no está formada correctamente. La dirección URL del canal nunca debe alterarse ni modificarse al enviar una notificación a WNS. La dirección URL del canal siempre debe tratarse como una cadena opaca; nunca es necesario examinar ni conocer su contenido.

  Corrección: compruebe que el código no modifica la dirección URL del canal cambiando uno o varios de sus caracteres o cambiando su codificación.

La solicitud de notificación devuelve "406 No aceptable"

• Causa: WNS tiene directivas de protección vigentes para evitar que las aplicaciones malintencionadas afecten negativamente al servicio para otros usuarios y desarrolladores. Un número excesivo de notificaciones en un período de tiempo demasiado corto puede dar lugar a la eliminación explícita de notificaciones de WNS.

  Corrección: revise la frecuencia de notificación para ver si se puede reducir o optimizar para generar una mejor experiencia de usuario.

La solicitud de notificación devuelve "410 Gone"

• Causa: la dirección URL del canal ha expirado. No se pueden enviar más notificaciones hasta que la aplicación se ejecute y solicite una nueva dirección URL de canal.

  Corregir: La aplicación de la Microsoft Store debe solicitar una URL de canal cada vez que se inicie. No se garantiza que la dirección URL del canal asignada permanezca igual. Si la dirección URL ha cambiado, el cliente debe actualizar la información en su servidor en la nube.

Errores al intentar crear un canal de notificación push

• La creación de un canal de notificación produce un error de ERROR_NO_NETWORK
• La creación de un canal de notificación resulta en un error de WPN_E_CLOUD_INCAPABLE
• La creación de un canal de notificación produce un error de WPN_E_INVALID_APP

La creación de un canal de notificación produce un error de ERROR_NO_NETWORK

• Causa: WNS requiere una conexión a Internet para crear un canal de notificación.

  Corregir: compruebe la conectividad a Internet.

La creación de un canal de notificación resulta en un error de WPN_E_CLOUD_INCAPABLE

• Causa: La aplicación no ha declarado la funcionalidad de Internet en su manifiesto de aplicación (package.appxmanifest).

  Corrección: asegúrese de que el manifiesto de la aplicación haya declarado la funcionalidad de Internet. En el editor de manifiestos de Visual Studio, encontrará esta opción en la pestaña Capacidades como Internet (cliente). Para obtener más información, consulte Capabilities.

La creación de un canal de notificación produce un error de WPN_E_INVALID_APP

• Causa: La aplicación debe usar un nombre de paquete válido. Si aún no ha recibido uno, puede obtenerlo a través del portal de la Tienda Windows en "Características avanzadas".

  Corregir: Para obtener detalles sobre cómo recuperar un identificador de seguridad de paquete (PKSID) para tu aplicación de la Tienda Windows, consulta Información general de Windows Push Notification Services (WNS).

Informe de un problema

Si ha probado las soluciones sugeridas en este tema y no ha resuelto el problema, publique un mensaje en los foros de Microsoft para discutirlo con desarrolladores de Microsoft y con otras partes interesadas.

Para las notificaciones push, además de una descripción del problema, es posible que se le pida que proporcione la dirección URL del canal y un ejemplo de la respuesta que recibió de WNS, incluidos los códigos de error HTTP y los encabezados HTTP. Hay encabezados específicos que el servidor de aplicaciones debe registrar al notificar un problema. Para obtener más información, consulte los encabezados de solicitud y respuesta del servicio de notificaciones push .