Enviar acción PostMessage
La acción Send PostMessage envía un mensaje desde tu experimento Labvanced en ejecución a un objetivo externo, como una página web principal, una aplicación personalizada o un marco incrustado, utilizando la API postMessage del navegador.
Tabla de Contenidos
Descripción general
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 lados
Usar postMessage entre Labvanced y una página externa (como un iFrame o una aplicación principal) es un proceso de dos lados. 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) oyente para recibir mensajes de Labvanced. Ese oyente también debe 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 deberán escribir ese código. Una herramienta de codificación IA 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).
La carga del mensaje contiene el Value to send. Si se establece un Key, se incluye en la carga 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 oyente 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 el destino sea conocido. Se recomienda especificar el dominio exacto por razones de seguridad. |
Key | Adjunta una clave de identificador al mensaje saliente. Esto estructura la carga 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 icono de edición 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 aplicación externa) debe implementar un window.addEventListener('message', ...) oyente para manejar el postMessage entrante de Labvanced.
Lectura adicional y materiales abiertos
- Disparador de PostMessage Recibido: el disparador emparejado para escuchar postMessages entrantes de fuentes externas.
- Menú de Selección de Valores: cómo definir qué valor enviar utilizando 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 incrustados.
- Descripción general de Eventos: una introducción completa al sistema de lógica de disparadores y acciones en Labvanced.