SpotWidget
Integración del widget
Embebe el widget de onboarding de pacientes Spot en tu sitio.
El widget es la integración Spot más común. Una clínica o plataforma de agendamiento mintea un token de un solo uso desde su backend, renderiza el widget Skip en un iframe, y escucha eventos de completitud.
Tu backend → POST /api/spot/widget → Skip retorna widget_token + url
Pestaña paciente → carga url con widget_token → GET /api/spot/widget/{token}
Skip retorna event_type + user_data
↓
→ llena form en el iframe → POST /api/spot/user
Skip crea User + Beneficiary
↓
→ evento postMessage → Tu página gestiona el éxitoTres páginas cubren la integración completa:
- Generar widget token — qué llama tu backend.
- Embeber el iframe — qué carga el navegador del paciente.
- Eventos postMessage — cómo reacciona tu página al término del widget.
Para casos inusuales (RUT colisiones, tokens expirados, errores a mitad de flujo) ver Casos borde.
Vida útil de los tokens
| Tipo | TTL | Cuándo usar |
|---|---|---|
| Estándar | 1 hora | Por defecto. Se asume que el paciente termina en una sola sesión. |
| Long-term | 30 días | Pasa long_term_token=true al mintear. Útil cuando el paciente recibe el link por correo/WhatsApp y puede terminar después. |
Host del iframe
El iframe siempre carga desde https://spot.getskip.ai. Asegúrate de que tu CSP lo permita.