Saltar al contenido principal

​
Descripción general

Esta guía cubre cómo configurar OneSignal WordPress Web Push Plugin v3+.
Para la documentación de la versión antigua 2.x.x de WordPress, ver Plugin legacy WordPress.

​
Novedades en Versión 3+

Esta versión marca una actualización significativa al simplificar el proceso de configuración. Con Versión 3+, puedes manejar todas tus configuraciones de prompt en un solo lugar—el Dashboard OneSignal.
  • 🚀 Actualización SDK: Actualiza OneSignal Web SDK de versión 15 a 16
  • 💬 Prompts en Dashboard: Configura todos los prompts de permiso directamente en el dashboard OneSignal—sin código personalizado requerido
  • ⏩ Publicación con un clic: Marca “Send notification when post is published” para enviar notificaciones push automáticamente
  • 🧑‍🤝‍🧑 Targeting de audiencia: Elige qué segmentos reciben notificaciones para cada publicación
  • 📲 Integración app móvil: Envía a suscriptores de app móvil con deep linking opcional
Para la documentación de la versión antigua 2.x.x de WordPress, ver Plugin legacy WordPress.

​
Configuración

Antes de comenzar, asegúrate de tener:
  • Cuenta OneSignal (gratis para crear)
  • Acceso admin WordPress para instalar y configurar plugins
  • Sitio web habilitado con HTTPS (requerido para notificaciones web push)

​
1. Configurar WordPress en Dashboard OneSignal

Navega a Settings > Push & In-App > Web > WordPress Plugin or Website Builder

Selecciona WordPress de las opciones Website Builder en tu dashboard OneSignal

​
Configuración del sitio

  • Site Name: El nombre de tu sitio y título de notificación predeterminado.
  • Site URL: Debe coincidir con la URL exacta de tu sitio WordPress (sigue la política de mismo origen)
  • Auto Resubscribe: Habilita esto para resuscribir automáticamente a usuarios que limpian sus datos del navegador cuando regresan a tu sitio (sin nuevo prompt de permiso requerido)
  • Default Icon URL: Archivo PNG o JPG cuadrado de 256x256px para notificaciones y prompts – MacOS Safari no mostrará un prompt de notificación sin un icono.

Ingresa tu URL de sitio exacta. https://tu-sitio.com es diferente de https://www.tu-sitio.com—usa solo un formato consistentemente

¿Probando localmente? Ver Guía de pruebas locales para desarrollo localhost

​
Prompts de permiso

Configura tus prompts de permiso para Push, Email y SMS. El Push Slide Prompt está habilitado por defecto, pero puedes personalizar o agregar prompts adicionales.
Consejo: Comienza con prompts simples y agrega complejidad gradualmente. Puedes modificar todas las configuraciones de prompt en cualquier momento a través del dashboard OneSignal. Explora todas las opciones disponibles en Prompts de permiso web.
  • Configuración básica de Prompt
  • Avanzado: Segmentación basada en categorías
1

Haz clic en Push Slide Prompt para personalizar

Accede y personaliza tus configuraciones de push slide prompt

2

Configura tiempo y texto:

  • Establece Auto Prompt a 1 vista de página y 1 segundo para pruebas iniciales
    • Personaliza texto y apariencia del prompt
    • Ajusta tiempo basado en comportamiento del usuario después del lanzamiento

Configura tiempo de auto-prompt y personaliza apariencia del prompt

3

Haz clic en Done cuando hayas terminado de configurar el prompt.

​
Notificación de bienvenida

Configura una notificación inmediata enviada después de que los usuarios se suscriben por primera vez. Esto:
  • Agradece a los usuarios por suscribirse
  • Demuestra cómo aparecen las notificaciones
  • Aumenta el engagement y reduce cancelaciones de suscripción
Configura tu texto de mensaje de bienvenida y tiempo, luego desplázate hacia abajo y haz clic en Save.
Omite la sección Advanced Push Settings por ahora — estas son para configuración Web SDK personalizada. Haz clic en Save para continuar.

​
2. Configurar plugin WordPress

Después de guardar tu configuración del dashboard, verás tu App ID y API Key. Copia estos valores a tu plugin WordPress:

Copia tu App ID y API Key del dashboard OneSignal

¿No ves una API Key? Sigue nuestra guía Keys & IDs para crear una.
1

En tu admin WordPress, navega a las configuraciones del plugin OneSignal

2

Pega el App ID y REST API Key exactamente como se muestra en tu dashboard

Asegúrate de que tu App ID y REST API Key del plugin WordPress coincidan exactamente con tu dashboard OneSignal

​
Configuraciones avanzadas

Configura opciones adicionales del plugin según tus necesidades:

Configuraciones avanzadas para funcionalidad mejorada y seguimiento de analytics

Seguimiento de parámetros URL Agrega parámetros de analytics a URLs de notificación para seguimiento. Importante: Escapa caracteres especiales—la entrada se agrega tal cual a las URLs. Ejemplo para Google Analytics: 
utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin
Ejemplo con caracteres especiales: 
utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots
Configuraciones adicionales
  • Custom Post Types: Agrega tipos de publicación de plugins para habilitar opciones de notificación
  • Automatically send notifications when a post is published: Marca automáticamente la casilla de notificación al publicar posts para que las notificaciones se envíen sin tener que marcar la casilla manualmente
  • Automatically send notifications when a post is updated: Marca automáticamente la casilla de notificación al actualizar posts para que las notificaciones se envíen sin tener que marcar la casilla manualmente
  • Automatically send notifications when a page is published: Marca automáticamente la casilla de notificación al publicar páginas para que las notificaciones se envíen sin tener que marcar la casilla manualmente
  • Automatically send notifications when a page is updated: Marca automáticamente la casilla de notificación al actualizar páginas para que las notificaciones se envíen sin tener que marcar la casilla manualmente
  • Automatically send a push notification when I publish a post from 3rd party plugins: Envía automáticamente notificaciones desde plugins de publicación externos
  • Mobile App Integration: Envía notificaciones a tus suscriptores de app móvil usando el mismo OneSignal App ID

​
3. Completar migración (Solo usuarios actualizando)

Las nuevas instalaciones pueden omitir este paso. Si estás actualizando desde v2+, sigue adelante…
Sensible al tiempo: Completa estos pasos lo antes posible para evitar que los usuarios pierdan notificaciones durante la transición.
1

Después de guardar tu configuración del dashboard OneSignal, regresa a WordPress

2

Haz clic en Migration Completed en las configuraciones del plugin

3

Haz clic en Save Settings para finalizar la actualización

Haz clic en Migration Completed para finalizar tu actualización de plugin

¡Configuración completa! Haz clic en Save Settings para terminar la configuración del plugin.

​
Probar tu configuración

  • Prueba inicial
  • Verificar suscripción
  • Enviar mensaje de prueba
  1. Visita tu sitio web (evita navegación incógnito/privada—los usuarios no pueden suscribirse en estos modos) 2. Busca el slidedown prompt que configuraste

Tu slidedown prompt configurado debería aparecer según tus configuraciones de tiempo

  1. Haz clic en el botón de suscripción (etiquetado como “Subscribe” en este ejemplo)
  2. Acepta el permiso del navegador cuando se te solicite

Prompt de permiso del navegador (apariencia varía por navegador) es requerido para notificaciones web push

  1. Verifica la notificación de bienvenida (si está configurada)

La notificación de bienvenida aparece inmediatamente después de una suscripción exitosa

¡Éxito! Tu sitio WordPress ahora está configurado para notificaciones web push. Los usuarios comenzarán a aparecer en tus Subscriptions a medida que se suscriban.
Siguientes pasos:
¿Tienes problemas? Consulta nuestra guía de solución de problemas WordPress para soluciones comunes.

​
Publicar notificaciones

Cuando programas un post para ser publicado, OneSignal también programará una notificación push para ser enviada a tus suscriptores en el tiempo programado. Si reprogramas el post, la notificación push será cancelada y se programará un nuevo push para el nuevo tiempo. Puedes ver tus notificaciones programadas y canceladas en el dashboard OneSignal bajo Delivery > Scheduled Messages. Ver Reportes de mensajes push para más detalles.

​
Notificaciones básicas de post

Al crear o editar un post WordPress, localiza el metabox OneSignal Push Notifications (usualmente en la parte inferior o barra lateral del editor de posts).

Metabox OneSignal Push Notifications—arrastra para reposicionar si es necesario

Para enviar una notificación:
  • Marca “Send notification when post is published or updated”
  • Desmarca para omitir enviar una notificación para ese post

​
Targeting de audiencia

​
Enviar a todos los suscriptores (predeterminado)

Por defecto, las notificaciones van a todos los suscriptores push.

​
Enviar a segmentos específicos

Dirige audiencias específicas usando segmentos que crees en OneSignal Dashboard > Audience > Segments. Si configuraste categorías en el Paso 3, crea los segmentos correspondientes:
  1. Ve a Audience > Segments en tu dashboard OneSignal
  2. Crea segmentos usando tus claves de tag, ej.:
    • Segmento News: Tag news es 1
    • Segmento Deals: Tag deals es 1

¡Los tags distinguen mayúsculas! 'news' y 'News' son tags diferentes

  1. Después de crear segmentos, actualiza tu editor de posts WordPress
  2. Selecciona tu segmento objetivo del menú desplegable

Selecciona segmentos específicos para dirigir grupos de usuarios relevantes

Segmentación avanzada: Crea segmentos basados en comportamiento del usuario, ubicación, tipo de dispositivo y más. Los Tags proporcionan la mayor flexibilidad para datos de usuario personalizados y personalización.

​
Personalizar contenido de notificación

​
Comportamiento predeterminado

  • Title: Usa tu título del sitio WordPress (Settings > General)
  • Message: Usa el título del post
  • Image: Usa la imagen destacada del post (si está establecida)
  • URL: Enlaza al post publicado

​
Contenido personalizado

Marca “Customize notification content” para sobrescribir predeterminados:

Personaliza título de notificación, contenido y otros elementos

Resultado de ejemplo:

Notificación push personalizada como aparece a los usuarios

​
Agregar tipo de post personalizado al plugin WordPress OneSignal

​
Encuentra el nombre de tu tipo de post personalizado

Mira la barra de direcciones de tu navegador al crear un nuevo post. La URL se verá así: 
https://tusitio.com/wp-admin/post-new.php?post_type=tu_tipo_personalizado
El valor del parámetro post_type (por ejemplo, tu_tipo_personalizado) es el nombre exacto que necesitarás agregar en las configuraciones del plugin OneSignal.

​
Agregar a configuraciones OneSignal

  1. Ve a OneSignal > Settings en admin WordPress
  2. En Advanced Settings, agrega los nombres de tus tipos de post personalizados al campo Custom Post Types
  3. Guarda configuraciones
Ejemplos comunes: product (WooCommerce), tribe_events (Events Calendar), portfolio

​
Integración app móvil

Si tienes una app móvil usando el mismo OneSignal App ID:
  1. Habilita “Send notification to Mobile app subscribers” en configuraciones del plugin
  2. En el metabox del post, agrega una Mobile URL para deep linking
  3. Los usuarios móviles serán dirigidos a tu app en lugar del navegador web
Listo para escalar: Explora estrategias push avanzadas y journeys automatizados para campañas de notificación sofisticadas.
¿Notificaciones no aparecen? Consulta nuestra guía de solución de problemas web push para soluciones.

​
Preguntas frecuentes

Nota: Este método solo funciona con slidedown y prompts de permiso nativos, no con campana o prompts de enlace personalizado.
  1. En tu dashboard OneSignal, ve a Settings > Push & In-App > Web Settings
  2. Selecciona tu prompt de la tabla Permission Prompt Setup
  3. Desmarca Auto Prompt y haz clic en Done

Deshabilita Auto Prompt para controlar manualmente cuándo aparecen los prompts

  1. Desplázate hacia abajo, haz clic en Save, luego en Finish
  2. Agrega código JavaScript personalizado a páginas específicas donde quieres que aparezcan los prompts
Esto te da control completo sobre el tiempo y ubicación de los prompts. Ver Prompts de permiso web para detalles de implementación.
¡Sí! Si tu app móvil usa el mismo OneSignal App ID:
  1. Habilita “Send notification to Mobile app subscribers” en las configuraciones del plugin WordPress
  2. Al publicar posts, usa el campo Mobile URL en el metabox OneSignal para especificar deep links
  3. Sin una Mobile URL personalizada, los usuarios serán dirigidos a tu sitio web
Esta función habilita mensajería multi-plataforma desde una sola interfaz WordPress.
El plugin WordPress actualmente soporta solo notificaciones push. Para email y SMS:
  1. Email: Sigue nuestra guía de configuración Email, luego usa herramientas de mensajería Email
  2. SMS: Sigue nuestra guía de configuración SMS, luego usa herramientas de mensajería SMS
Ambos canales pueden gestionarse desde el mismo dashboard OneSignal junto con tus notificaciones push.
Problemas de caché: El caché de WordPress puede retrasar los cambios de migración.Solución:Paso 1: Haz clic derecho en tu sitio web y selecciona InspectPaso 2: Ve a la pestaña NetworkPaso 3: Marca “Disable cache”

Deshabilita caché del navegador para forzar la carga de archivos actualizados después de la migración

Paso 4: Actualiza tu sitio web para ver la configuración actualPaso 5: Limpia las configuraciones de tu plugin de caché WordPress si aplica
Este error indica migración incompleta:

Error 404 en consola del navegador indica proceso de migración incompleto

Solución:
  1. Asegúrate de haber guardado tu configuración del dashboard OneSignal
  2. En WordPress, haz clic en “Migration Completed” en las configuraciones del plugin
  3. Haz clic en Save Settings para finalizar la actualización
Este error solo afecta a usuarios actualizando desde versión 2.x.x.
Sí, puedes usar el filtro onesignal_send_notification.
Coloca código PHP personalizado en wp-content/mu-plugins/onesignal-custom.php. Esto asegura que se cargue correctamente y previene que sea sobrescrito por actualizaciones.
<?php

add_filter('onesignal_send_notification', function($fields, $post_id) {

  // Incluye cualquier propiedad mencionada en la Create Notification API Reference:
  // https://documentation.onesignal.com/reference/push-notification ej.:

  // Agregar botones de acción
  $fields['web_buttons'] = array(
    array(
      "id" => "read-more",
      "text" => "Read More",
      "url" => get_permalink($post->ID)
    )

  // Devolver el array de campos modificado
  return $fields;

}, 10, 2);