SpotWidget
Eventos postMessage
Cómo el widget le avisa a tu página cuando el paciente termina, falla o cancela.
El widget se comunica con su frame padre via la API estándar postMessage. Tu página se suscribe una vez y reacciona a los eventos.
Suscribirse
window.addEventListener("message", (event) => {
if (event.origin !== "https://spot.getskip.ai") return;
const { type, payload } = event.data;
switch (type) {
case "SPOT_USER_CREATED":
// El paciente terminó el onboarding. payload.user_id es el ID nuevo.
break;
case "SPOT_WIDGET_CLOSED":
// El paciente cerró el widget sin terminar.
break;
case "SPOT_WIDGET_ERROR":
// Error irrecuperable. payload.code identifica la causa.
break;
}
});Verifica siempre event.origin antes de confiar en el payload — esto es higiene estándar de postMessage, no algo específico de Skip.
Vocabulario de eventos
| Tipo | Cuándo | Payload |
|---|---|---|
SPOT_USER_CREATED | Paciente terminó onboarding | { user_id, rut } |
SPOT_WIDGET_CLOSED | Paciente cerró el widget | sin payload |
SPOT_WIDGET_ERROR | Error irrecuperable dentro del widget | { code, message } |
Confirmar onboarding exitoso desde tu backend
El evento postMessage es la señal del frontend. Si tu lógica de negocio depende de que el usuario realmente fue creado, tu backend debería confirmar también:
GET /api/spot/is_user_subscribed?public_key={tu_public_key}&rut={rut_paciente}Devuelve si el paciente ahora está suscrito (plan pago o créditos de prueba). Ver Estado de suscripción para el shape de la respuesta.