API · simulator
Operaciones de simulator del contrato OpenAPI que aceptan una clave de API.
Actualizado:
POST /simulator/clock
Fijar (o borrar con now = null) el reloj simulado del workspace
Solo si ENV != production; en producción responde 403. El instante fijado sigue corriendo en tiempo real.
- Autenticación: Clave de API o sesión del panel
- Scopes: Ninguno
Cuerpo de la solicitud (obligatorio)
application/json: object
Respuestas
| Estado | Descripción |
|---|---|
200 | OK (object) |
default | Error (RFC 9457) (Problem) |
DELETE /simulator/data
Purgar todo lo is_test del workspace
- Autenticación: Clave de API o sesión del panel
- Scopes: Ninguno
Respuestas
| Estado | Descripción |
|---|---|
200 | Purgado (SimulatorPurge) |
default | Error (RFC 9457) (Problem) |
GET /simulator/sessions
Listar las sesiones de simulador del workspace
- Autenticación: Clave de API o sesión del panel
- Scopes: Ninguno
Respuestas
| Estado | Descripción |
|---|---|
200 | OK (array<SimulatorSession>) |
default | Error (RFC 9457) (Problem) |
POST /simulator/sessions
Crear una sesión de simulador (cliente de prueba + conversación)
Canal simulator (F2-12, ADR 0013): mismo pipeline que WhatsApp, sin proveedor externo.
Solo panel (sesión + CSRF), roles owner/manager; el tenant sale de la sesión.
El cliente queda is_test (fuera de listados reales, automatizaciones y reportes).
- Autenticación: Clave de API o sesión del panel
- Scopes: Ninguno
Cuerpo de la solicitud (opcional)
application/json: SimulatorSessionCreate
Respuestas
| Estado | Descripción |
|---|---|
201 | Creada (SimulatorSession) |
default | Error (RFC 9457) (Problem) |
DELETE /simulator/sessions/{session_id}
Borrar una sesión (cliente, conversación, mensajes y reservas de prueba)
- Autenticación: Clave de API o sesión del panel
- Scopes: Ninguno
Parámetros
| Nombre | En | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
session_id | path | Sí | string (uuid) |
Respuestas
| Estado | Descripción |
|---|---|
204 | Borrada |
default | Error (RFC 9457) (Problem) |
GET /simulator/sessions/{session_id}/messages
Mensajes de la sesión con la traza del bot (debug) para el inspector
- Autenticación: Clave de API o sesión del panel
- Scopes: Ninguno
Parámetros
| Nombre | En | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
session_id | path | Sí | string (uuid) |
Respuestas
| Estado | Descripción |
|---|---|
200 | OK (array<SimulatorMessage>) |
default | Error (RFC 9457) (Problem) |
POST /simulator/sessions/{session_id}/messages
Enviar un mensaje como el cliente de prueba
Mismo camino que el webhook entrante (persistir, SSE, cola). La respuesta del bot llega por GET /v1/conversations/stream.
- Autenticación: Clave de API o sesión del panel
- Scopes: Ninguno
Parámetros
| Nombre | En | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
session_id | path | Sí | string (uuid) |
Cuerpo de la solicitud (obligatorio)
application/json: object
Respuestas
| Estado | Descripción |
|---|---|
202 | Aceptado (object) |
default | Error (RFC 9457) (Problem) |