Workspaces

Un workspace es un espacio de datos separado dentro de tu organización. Clientes, cobros, reglas, plantillas, canales, integraciones, webhooks, importaciones y exportaciones pertenecen a un workspace — y solo aparecen para quien tiene acceso a él.

Organización (tu cuenta)
└── Workspace          ← espacio de datos (ej.: "Principal", "Minorista")
    └── Empresa        ← persona jurídica, con CNPJ (la "matriz")
        └── Sucursal   ← unidad de negocio dentro de la empresa

Toda organización comienza con el workspace Principal. Usa otros cuando necesites carteras que no se mezclan: operaciones distintas, clientes de un socio, un entorno para probar reglas. Para separar unidades de una misma cartera, usa empresas y sucursales.

Qué queda en el workspace y qué queda en la organización

En el workspace	En la organización (vale para todos)
Clientes, cobros, acuerdos, disputas, tareas	Miembros y roles (permisos)
Reglas, plantillas, clasificaciones, canales	Datos de la cuenta y marca
Empresas y sucursales, layouts de correo	Consumo (suma de todos los workspaces)
Integraciones, webhooks, importaciones, exportaciones	Auditoría de miembros y workspaces
Portal del deudor (configuración y subdominio)

Cambiar de workspace

El encabezado muestra el workspace activo junto al nombre de la organización. Haz clic para cambiar — las pantallas pasan a mostrar los datos del workspace elegido. Quien tiene acceso a más de un workspace elige en cuál entrar justo después de iniciar sesión.

Crear, renombrar y eliminar

En la pantalla Workspaces (menú lateral, grupo Cuenta):

• Nuevo workspace crea el espacio ya con una empresa matriz; quien lo crea pasa a ser su owner. Requiere el permiso workspaces.create.
• Renombrar y Eliminar son de los owners del workspace (y de los administradores de la organización).
• Eliminar oculta todos los datos del workspace y desactiva sus integraciones y webhooks. El diálogo muestra cuántas personas, cobros, integraciones y webhooks se verán afectados y pide el nombre del workspace para confirmar. El último workspace de la organización no se puede eliminar.

Quién accede a cada workspace

En la pantalla Miembros, el botón de workspaces de cada fila lista los workspaces de la organización. Marca los que el miembro puede abrir:

• Desmarcar pausa el acceso (el historial se conserva) y cierra la sesión del miembro de inmediato.
• Un workspace nunca queda sin owner: quitar el último se rechaza.
• Al invitar a alguien, elige los workspaces de la invitación; sin elección, vale el workspace en el que estás.
• Los administradores de la organización acceden a todos los workspaces, incluso a los creados después.

Lo que cada uno puede hacer dentro del workspace sigue definido por los roles y permisos.

En la API y en el MCP

• API: envía el id del workspace en el header X-Workspace-Id. Es opcional mientras la organización tenga un solo workspace; con dos o más, la llamada sin el header responde 400 WORKSPACE_REQUIRED. Lista los workspaces en GET /v1/workspaces. El ID también aparece en la pantalla Workspaces.
• MCP: toda herramienta que accede a datos acepta el argumento workspace_id; la herramienta dunning_workspaces_list lista los workspaces de la persona conectada.
• Webhooks: el cuerpo de cada entrega incluye workspace_id, y un endpoint solo recibe los eventos de su propio workspace.