SpotWidget
Generar un widget token
Endpoint server-side para mintear un widget token de un solo uso.
Tu backend llama a este endpoint para mintear un token y luego redirige o embebe la URL retornada.
Endpoint
POST /api/spot/widget?public_key={tu_public_key}Query opcional: long_term_token=true extiende el TTL de 1 hora a 30 días.
Cuerpo de la request
{
"user_data": {
"name": "María",
"surname": "González",
"email": "maria@example.com",
"phone_number": "+56912345678"
},
"rut": "12345678-9",
"metadata": {
"retry_url": "https://tu-sitio.com/retry"
},
"order_token": "ORDER-001"
}| Campo | Obligatorio | Notas |
|---|---|---|
user_data | sí | Pre-llena el formulario del paciente dentro del widget. El paciente puede editarlo. |
rut | sí | RUT chileno, normalizado (XXXXXXXX-X). Ver Conceptos → RUT. |
metadata.retry_url | no | URL de redirección si el paciente cancela a mitad de flujo. |
order_token | no | ID opaco de correlación. Te vuelve via webhook (flujos AAPD). |
Respuesta
{
"widget_token": "550e8400-e29b-41d4-a716-446655440000",
"url": "https://spot.getskip.ai?token=550e8400-..."
}Usa url directamente como src de un iframe, o ábrelo en una pestaña nueva.
Errores
| Status | Significado | Recuperación |
|---|---|---|
| 401 | public_key inválida o inactiva | Confirma la clave con Skip. Verifica que tu Provider esté activo. |
| 400 | provider_data enviado por un no-meta-provider | Quítalo, o pide a Skip habilitar modo meta-prestador. |
| 422 | RUT mal formado | Normaliza antes de enviar. |
Efectos colaterales
Cuando se crea un token, Skip registra el evento internamente (Slack + Google Sheets) para que el equipo vea las nuevas sesiones en tiempo real. No requiere acción de tu parte.