Configuración de notificaciones push web

Para empezar a enviar notificaciones push web con Pushwoosh, necesita configurar su plataforma de push web y habilitar la solicitud de suscripción que se muestra a los usuarios.

Importante

Asegúrese de que el SDK de Web Push esté correctamente integrado en su sitio web. Este es un paso obligatorio para permitir que los usuarios se suscriban y reciban notificaciones. Más información

Para comenzar la configuración, vaya a Ajustes > Configurar Plataformas > Notificaciones Push Web y haga clic en Conectar.

Configurar notificaciones push web para todos los navegadores (excepto versiones antiguas de Safari)

Esta configuración se aplica a todos los navegadores modernos, incluidas las últimas versiones de Safari, que ahora admiten notificaciones push web de forma nativa.

Nota: Las versiones más antiguas de Safari (macOS 10.14–12) requieren una configuración aparte. Puede configurarlo en una sección dedicada. Más información

Para iniciar la configuración, haga clic en Configurar en Configuración para todos los navegadores.

En la ventana de configuración, elija una de las siguientes opciones:

• Crear una nueva configuración de push Recomendado si no ha configurado previamente notificaciones push web a través de otro servicio. Pushwoosh generará automáticamente un nuevo par de claves VAPID.

• Usar configuración existente Elija esta opción si ya tiene claves VAPID, por ejemplo, de Firebase, y desea seguir usándolas sin pedir a los usuarios que se suscriban de nuevo.

Crear una nueva configuración de push

Elija Crear una nueva configuración de push si no ha configurado previamente notificaciones push web con otro servicio. Pushwoosh generará automáticamente las claves VAPID (Voluntary Application Server Identification) necesarias para usted.

¿Qué son las claves VAPID?

Las claves VAPID son un par de claves pública-privada utilizadas en el Protocolo Web Push para autenticar el servidor de la aplicación al enviar notificaciones push a los navegadores web. La clave pública se comparte con el navegador cuando un usuario se suscribe a las notificaciones. La clave privada permanece en su servidor y se utiliza para firmar de forma segura cada mensaje que envía.

Haga clic en Configurar para generar y aplicar las claves.

Una vez creadas, Pushwoosh utilizará automáticamente estas claves en la configuración del SDK. Más información sobre la integración del SDK de Web Push

Usar configuración existente

Si ya tiene claves VAPID (como las generadas a través de Firebase), puede reutilizarlas para configurar las notificaciones push web en Pushwoosh.

Para ello:

1. Seleccione Usar configuración existente.

2. En el campo Certificado de Web Push, introduzca su clave pública VAPID.

3. En el campo Clave Privada de Web Push, introduzca su clave privada VAPID.

4. Haga clic en Configurar para guardar y aplicar los ajustes.

Cómo encontrar las claves VAPID en Firebase

Si está migrando desde Firebase y necesita reutilizar sus claves VAPID existentes, siga estos pasos para encontrarlas.

Certificado de Web Push

1. En Firebase, navegue a Configuración del proyecto → Cloud Messaging.
2. Desplácese hacia abajo hasta la sección Configuración web y copie el par de claves existente.

3. Péguelo en el campo Certificado de Web Push en el formulario de configuración web de Pushwoosh.

Clave privada de Web Push

1. En la Consola de Firebase, vaya a Configuración del proyecto → Cloud Messaging → Configuración web.
2. Haga clic en el menú de tres puntos en Acciones junto al par de claves y seleccione Mostrar clave privada. Esta clave es esencial para garantizar que las notificaciones Web Push funcionen correctamente.

3. Copie la clave mostrada en su portapapeles.

4. En el formulario de Configuración Web de Pushwoosh, péguela en el campo Clave Privada de Web Push.

5. Haga clic en Aplicar para guardar sus cambios.

Reconfigurar la configuración de push web

Si ya ha configurado las notificaciones push web pero necesita actualizar sus credenciales (como reemplazar sus claves VAPID), aquí le explicamos cómo hacerlo:

1. Haga clic en Reconfigurar en Configuración para todos los navegadores.

2. En la ventana emergente que aparece, introduzca sus nuevas claves VAPID:

   • Certificado de Web Push: su nueva clave pública VAPID
   • Clave Privada de Web Push: su nueva clave privada VAPID

3. Haga clic en Configurar para guardar los cambios.

Importante

Reemplazar sus claves VAPID afecta a toda su configuración de push web y puede interrumpir la entrega de notificaciones si no se gestiona correctamente. Solo cambie las claves si es realmente necesario y asegúrese de comprender el impacto antes de realizar cualquier actualización.

Configurar la solicitud de suscripción

Para enviar notificaciones push, los usuarios deben otorgar permiso explícitamente a través de la solicitud a nivel de sistema del navegador. Sin este permiso, no se pueden entregar las notificaciones.

Debido a los recientes cambios en las políticas de Chrome y Firefox, la ventana emergente de permiso nativa solo puede aparecer después de que el usuario interactúe con la página (por ejemplo, haciendo clic en un botón). Para cumplir con este requisito, Pushwoosh muestra un widget de Solicitud de Suscripción por defecto. Este widget anima a los usuarios a optar por participar y, tras su consentimiento, activa la solicitud nativa del navegador.

Consejo

Una solicitud bien diseñada que explique el valor de las notificaciones (por ejemplo, “Reciba las últimas noticias y actualizaciones”) puede mejorar significativamente las tasas de aceptación.

Para personalizar el texto y la apariencia de la solicitud, haga clic en Ajustes.

Tipos de solicitud

Hay dos tipos de solicitudes de suscripción disponibles:

• Widget predeterminado Proporcionado por Pushwoosh y mostrado automáticamente. Aprenda a personalizar el widget predeterminado.

• Widget personalizado Use su propio diseño de widget. Más información

Nota: Debido a limitaciones de la plataforma, los cambios en el widget pueden tardar hasta 30 minutos en aparecer. Si los cambios no se reflejan, contacte al equipo de Soporte de Pushwoosh.

Configuración de Safari (macOS 10.14–12)

Para admitir notificaciones push en versiones más antiguas de Safari (macOS 10.14–12), debe completar un proceso de configuración separado utilizando sus credenciales de Apple Developer. Este paso solo es necesario para estas versiones antiguas, ya que las versiones más recientes de Safari (macOS Ventura y posteriores) admiten la configuración estándar de push web incluida en la Configuración para todos los navegadores.

Obtener las credenciales requeridas de Apple

1. Vaya a la sección Certificates, Identifiers & Profiles del Portal de Desarrolladores de Apple.

2. Añada un nuevo certificado.

3. Elija el tipo Website Push ID Certificate y haga clic en Continue.

4. Seleccione el Website Push ID - su cadena de dominio inverso única, como web.com.example.domain (debe comenzar con web.).

5. Suba una Solicitud de Firma de Certificado (Certificate Signing Request). Para obtener más información sobre cómo crear Solicitudes de Firma de Certificado, consulte el artículo de Ayuda de la Cuenta de Desarrollador.

6. Después, descargue el certificado de notificación push.

Nota

El certificado que descarga de Apple es un archivo .cer. Para obtener el archivo .p12 necesario para configurar Pushwoosh, debe exportar una clave privada. Vea los detalles en la guía de Configuración de iOS.

Configurar Safari en Pushwoosh

1. Haga clic en Configurar en Configuración de Safari.

2. Rellene los siguientes campos en el formulario de configuración:

Nombre del sitio web	El nombre de su sitio web que aparece en la solicitud de push.
Dominios permitidos	Lista de dominios permitidos para solicitar permiso de notificación (uno por línea).
Plantilla de URL	URL que se abre cuando un usuario hace clic en la notificación. Admite marcadores de posición como %@para insertar valores dinámicos. Ejemplo: https://yourwebsite.com/%@
Icono del sitio web	Suba una imagen PNG cuadrada (256×256 px). Pushwoosh la redimensiona automáticamente para diferentes interfaces.
Archivo de clave	Suba el certificado .p12 exportado desde su cuenta de Apple Developer.
Contraseña de clave privada	Contraseña utilizada al exportar el archivo .p12.

3. Haga clic en Configurar para guardar sus cambios.

Pushwoosh generará automáticamente el paquete de push con el conjunto de iconos, el diccionario JSON del sitio web y el archivo de manifiesto que Safari solicita al servidor. Puede descargarlo cuando lo necesite.

Importante

Cuando se le pide a un usuario permiso para recibir notificaciones push, Safari solicita al servidor web de Pushwoosh un push package. El paquete contiene datos utilizados por la interfaz de usuario de la notificación, como el nombre y el icono de su sitio web, así como una firma criptográfica que verifica que su notificación proviene de una fuente confiable: usted.

El paquete de push con todo su contenido es descargado UNA SOLA VEZ por cada usuario suscrito al registrarse, y no se puede forzar su actualización en los dispositivos.

Considere esto al lanzar las notificaciones push de Safari para su sitio web en producción.