Onboarding del paciente vía widget

El flujo widget es la integración Spot más común. Una clínica o plataforma de agendamiento mintea un token desde su backend, embebe un iframe, y escucha el evento de completitud del paciente. Esta página muestra la secuencia en detalle.

Secuencia

Qué hace cada paso

1. El backend del partner mintea un token. Ver Generar widget token.
2. Skip retorna widget_token y url. El backend pasa la URL al frontend.
3. El frontend renderiza el iframe. Dimensiones y CSP en Embeber el iframe.
4. El widget pide a Skip el estado de la sesión. Esto determina la primera pantalla que ve el paciente.
5. Skip responde con event_type. El widget renderiza acorde. No gestionas las pantallas — el widget lo hace.
6. El paciente envía el form. El widget hace POST directo a Skip con el token de su URL.
7. Skip crea el User, Beneficiary y los links a InsuranceAccount. Devuelve éxito.
8. El widget emite postMessage. Tu frontend escucha y reacciona. Ver Eventos postMessage.

Casos borde que el diagrama no muestra

• Si el RUT colisiona con otro correo (HTTP 409), el widget renderiza una pantalla de recuperación en vez del form. Ver Casos borde.
• Si el token expiró (HTTP 410), el widget muestra un error y el paciente rebota a tu metadata.retry_url.
• Si el paciente cierra el iframe a mitad de flujo, recibes WIDGET_FORM_CLOSE en vez de SPOT_USER_CREATED.

Demo

Grabación pendiente. Cuando llegue el video demo, se embebe acá como YouTube unlisted. Track en Videos demo.