
Enviar Acción PostMessage
La acción Send PostMessage envía un mensaje desde tu experimento en ejecución de Labvanced a un destino externo, como una página web principal, una aplicación personalizada, o un marco embebido, utilizando la API postMessage del navegador.
Tabla de Contenidos
Resumen
Esta acción está listada bajo API Actions en el menú de selección de acciones.

Casos de Uso Comunes
- Notificar a una aplicación principal (por ejemplo, un LMS o portal institucional) cuando un participante alcanza un cierto punto o completa una tarea.
- Pasar un valor de variable, como un puntaje, una respuesta, o una etiqueta de condición, a un sistema externo en tiempo real.
La Configuración de Dos Caras
Utilizar postMessage entre Labvanced y una página externa (como un iFrame o una aplicación principal) es un proceso de dos caras. Labvanced maneja un lado: esta acción envía el mensaje. El otro lado es la página externa, que debe estar programada para recibirlo.
La API postMessage es una característica estándar del navegador. La página externa necesita un window.addEventListener('message', handler) listener para recoger mensajes de Labvanced. Ese listener también debería filtrar por dominio, verificando que el origen del mensaje sea Labvanced, para que solo actúe sobre mensajes de una fuente confiable. Tú o tu desarrollador necesitarán escribir ese código. Una herramienta de codificación AI puede ayudar a generarlo rápidamente si es necesario.
Cómo Funciona
Cuando esta acción se activa, Labvanced envía un postMessage a la ventana objetivo. El mensaje se entrega a cualquier página en Destination Domain que esté escuchando con un window.addEventListener('message', handler).
El payload del mensaje contiene Value to send. Si se establece un Key, este se incluye en el payload para que el extremo receptor pueda identificar el tipo de mensaje y manejarlo en consecuencia.
La página externa es responsable de procesar el mensaje. Su listener debe verificar el origen del mensaje antes de actuar sobre él, para asegurarse de que solo responda a mensajes enviados desde Labvanced.
Al seleccionar Send PostMessage, aparecerá la siguiente configuración:

Opciones de Acción
| Elemento del Menú | Opciones de Acción Enviar PostMessage |
|---|---|
Destination Domain | Especifica el origen objetivo que debe recibir el mensaje. El valor predeterminado es *, que envía a cualquier origen. Reemplaza * con la URL completa del objetivo (por ejemplo, https://yoursite.com) cuando se conozca el destino. Se recomienda especificar el dominio exacto por motivos de seguridad. |
Key | Adjunta una clave de identificador al mensaje saliente. Esto estructura el payload del mensaje como Key: value, que el extremo receptor puede usar para distinguir diferentes tipos de mensajes. Déjalo vacío si no se necesita clave. |
Value to send | Define los datos a incluir en el mensaje saliente. Haz clic en el ícono de editar para abrir el Value-Select Menu y especificar qué enviar: un valor constante, una variable de Labvanced, o una expresión. |
Nota: El sistema que recibe el mensaje (la página principal o la aplicación externa) debe implementar un window.addEventListener('message', ...) listener para manejar el postMessage entrante de Labvanced.
Lectura Adicional
Disparador de PostMessage Recibido
El disparador asociado para escuchar postMessages entrantes de fuentes externas.
Menú de Selección de Valores
Cómo definir qué valor enviar usando variables, constantes o expresiones.
Extensión de Puente Web de Labvanced
Contexto sobre cómo se utiliza postMessage para la comunicación con sitios web externos embebidos.