API · simulator
simulator operations in the OpenAPI contract that accept an API key.
Updated:
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.
- Authentication: API key or dashboard session
- Scopes: None
Request body (required)
application/json: object
Responses
| Status | Description |
|---|---|
200 | OK (object) |
default | Error (RFC 9457) (Problem) |
DELETE /simulator/data
Purgar todo lo is_test del workspace
- Authentication: API key or dashboard session
- Scopes: None
Responses
| Status | Description |
|---|---|
200 | Purgado (SimulatorPurge) |
default | Error (RFC 9457) (Problem) |
GET /simulator/sessions
Listar las sesiones de simulador del workspace
- Authentication: API key or dashboard session
- Scopes: None
Responses
| Status | Description |
|---|---|
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).
- Authentication: API key or dashboard session
- Scopes: None
Request body (optional)
application/json: SimulatorSessionCreate
Responses
| Status | Description |
|---|---|
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)
- Authentication: API key or dashboard session
- Scopes: None
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
session_id | path | Yes | string (uuid) |
Responses
| Status | Description |
|---|---|
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
- Authentication: API key or dashboard session
- Scopes: None
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
session_id | path | Yes | string (uuid) |
Responses
| Status | Description |
|---|---|
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.
- Authentication: API key or dashboard session
- Scopes: None
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
session_id | path | Yes | string (uuid) |
Request body (required)
application/json: object
Responses
| Status | Description |
|---|---|
202 | Aceptado (object) |
default | Error (RFC 9457) (Problem) |