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) |
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.O que pertence a um espaço de trabalho
Fluxos
Modelos conversacionais construídos no editor visual. Cada fluxo pertence a exatamente um espaço de trabalho.
Chaves de API
Chaves usadas para autenticar sistemas externos ao criar sessões e enviar mensagens via API.
Clientes OAuth
Credenciais de cliente usadas para incorporação via iframe. Cada cliente é vinculado a um único espaço de trabalho.
Agentes de IA
Configurações de agentes OpenAI usadas pelo nó OpenAI Agent dentro dos fluxos.
Setores
Departamentos ou equipes para os quais conversas podem ser transferidas via nó Transfer.
Incorporação via iframe
Espaços de trabalho podem habilitar ou desabilitar a incorporação via iframe através da flagiframe_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.
Consulte o guia de Incorporação via Iframe para instruções de configuração e a página Autenticação de Incorporação para o fluxo de autenticação.