> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whatabot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Espaços de Trabalho

> Containers organizacionais para fluxos e recursos.

## Visão geral

Um **espaço de trabalho** é a unidade organizacional principal no whataBot. Ele agrupa todos os recursos necessários para construir e executar fluxos conversacionais: fluxos, chaves de API, clientes OAuth, agentes de IA e setores. Espaços de trabalho pertencem a uma **conta**, e uma única conta pode ter muitos espaços de trabalho, permitindo separação multi-tenant de responsabilidades.

## Campos do espaço de trabalho

| Campo            | Tipo    | Descrição                                               |
| ---------------- | ------- | ------------------------------------------------------- |
| `id`             | UUID v7 | Identificador único, ordenável por tempo                |
| `name`           | string  | Nome de exibição do espaço de trabalho                  |
| `iframe_enabled` | boolean | Se o espaço de trabalho pode ser incorporado via iframe |
| `timezone`       | string  | Fuso horário IANA (padrão: `UTC`)                       |

<Callout type="info">
  O campo `timezone` é usado pelo motor de fluxos ao formatar datas e horários
  dentro dos nós (ex: a variável `system.hour`). Certifique-se de que ele
  corresponda ao fuso horário do seu público-alvo.
</Callout>

## O que pertence a um espaço de trabalho

<CardGroup cols={2}>
  <Card title="Fluxos" icon="diagram-project">
    Modelos conversacionais construídos no editor visual. Cada fluxo pertence a
    exatamente um espaço de trabalho.
  </Card>

  <Card title="Chaves de API" icon="key" href="/api-reference/authentication">
    Chaves usadas para autenticar sistemas externos ao criar sessões e enviar
    mensagens via API.
  </Card>

  <Card title="Clientes OAuth" icon="lock" href="/embed/authentication">
    Credenciais de cliente usadas para incorporação via iframe. Cada cliente é
    vinculado a um único espaço de trabalho.
  </Card>

  <Card title="Agentes de IA" icon="robot">
    Configurações de agentes OpenAI usadas pelo nó OpenAI Agent dentro dos
    fluxos.
  </Card>

  <Card title="Setores" icon="building">
    Departamentos ou equipes para os quais conversas podem ser transferidas via
    nó Transfer.
  </Card>
</CardGroup>

## Incorporação via iframe

Espaços de trabalho podem habilitar ou desabilitar a incorporação via iframe através da flag `iframe_enabled`. Quando habilitada, aplicações externas podem incorporar o editor de fluxos do whataBot dentro de sua própria interface usando um cliente OAuth vinculado àquele espaço de trabalho.

<Callout type="tip">
  Consulte o guia de [Incorporação via Iframe](/embed/overview) para instruções
  de configuração e a página [Autenticação de
  Incorporação](/embed/authentication) para o fluxo de autenticação.
</Callout>