API · simulator
Operações de simulator do contrato OpenAPI que aceitam uma chave de API.
Atualizado:
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.
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Corpo da solicitação (obrigatório)
application/json: object
Respostas
| Status | Descrição |
|---|---|
200 | OK (object) |
default | Error (RFC 9457) (Problem) |
DELETE /simulator/data
Purgar todo lo is_test del workspace
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Respostas
| Status | Descrição |
|---|---|
200 | Purgado (SimulatorPurge) |
default | Error (RFC 9457) (Problem) |
GET /simulator/sessions
Listar las sesiones de simulador del workspace
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Respostas
| Status | Descrição |
|---|---|
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).
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Corpo da solicitação (opcional)
application/json: SimulatorSessionCreate
Respostas
| Status | Descrição |
|---|---|
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)
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Parâmetros
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
session_id | path | Sim | string (uuid) |
Respostas
| Status | Descrição |
|---|---|
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
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Parâmetros
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
session_id | path | Sim | string (uuid) |
Respostas
| Status | Descrição |
|---|---|
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.
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Parâmetros
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
session_id | path | Sim | string (uuid) |
Corpo da solicitação (obrigatório)
application/json: object
Respostas
| Status | Descrição |
|---|---|
202 | Aceptado (object) |
default | Error (RFC 9457) (Problem) |