> For the complete documentation index, see [llms.txt](https://docs.otima.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.otima.io/whatsapp/guia-de-usabilidade/gestao-de-workspaces.md).

# Gestão de Workspaces

A Gestão de Workspaces é a área administrativa da plataforma responsável por centralizar o gerenciamento de todos os ambientes criados no sistema.

Um **Workspace** representa um ambiente independente dentro da plataforma, geralmente associado a uma empresa, cliente ou unidade de negócio. Cada workspace possui suas próprias configurações, números de WhatsApp, Business Managers e Wabas vinculados e regras operacionais.

Essa área é acessível apenas para **administradores da plataforma**.

***

### Objetivo 

A gestão permite que o administrador:

* Visualize todos os workspaces cadastrados na plataforma que ele possui acesso
* Crie ou navegue para outros workspaces no menu de perfil
* Edite configurações existentes
* Associe um Business Manager a um workspace
* Ative números oficiais do WhatsApp em uma BMs do workspace específico
* Gerencie permissões e integrações

Essa estrutura garante organização, isolamento de dados e controle total da operação.

***

## Estrutura do Workspace

Cada workspace contém:

* Informações cadastrais do workspace
* Lista de Business Manager vinculados
* Wabas e Números oficiais do WhatsApp pertencente a cada Business Manager
* Configurações operacionais
* Controle de limites e integrações

O workspace funciona como um “container” isolado para cada cliente ou operação.

***

## Associação de Business Manager ao Workspace

### O que é um Business Manager?

O Business Manager é a conta empresarial da Meta responsável por gerenciar ativos como:

* Contas do WhatsApp Business
* Aplicativos
* Permissões
* Contas de anúncio

Todo número oficial do WhatsApp precisa estar vinculado a um Business Manager válido.

***

### Como funciona a associação

A associação de um Business Manager a um Workspace permite que:

* O workspace utilize os ativos vinculados ao Business Manager
* Seja possível ativar números oficiais dentro do workspace
* A plataforma consiga consumir as APIs da Meta corretamente

#### Processo de associação:

1. Acessar a área administrativa e vai na opção **Workspaces**

<div align="center" data-with-frame="true"><figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2F4HfXe7Vzc8jMqRF7mAtT%2Fimage.png?alt=media&amp;token=6818b867-9db1-4fd9-8ef9-2b28fc9e9454" alt="" width="188"><figcaption></figcaption></figure></div>

2. Selecionar o workspace desejado

<div data-with-frame="true"><figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2F5Zkd5zRsw1wkP2gfOd0f%2Fimage.png?alt=media&amp;token=4783ae5f-ef75-4347-ac5b-4a36b9f3d55d" alt="" width="563"><figcaption></figcaption></figure></div>

3. Ir até a seção de configurações do **Workspace**
4. Informar ou selecionar o Business Manager disponível para a associação a esse workspace.&#x20;

<div data-with-frame="true"><figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2F7EhZkDexkGU5z81rkB01%2Fimage.png?alt=media&amp;token=2bac372f-972f-4d84-8e67-c639307bc6c8" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2FHpLYb1XEohzdXrOKddl9%2Fimage.png?alt=media&amp;token=6abb7419-f3fc-4539-92bf-051e91c98919" alt=""><figcaption></figcaption></figure></div>

Automaticamente será transferido o Business Manager, todas as Wabas e números dessa BM para o Workspace

5. Confirmar a vinculação dos Business Manager(s)

> Após a vinculação do Business Manager, o workspace torna-se elegível para uso em todas as plataformas integradas da Ótima, habilitando a ativação e gestão de números pertencentes aos Business Managers associados, de acordo com o workspace selecionado no seu perfil do usuário.

6. Se caso atribuir errado tem a opção de remover

<div data-with-frame="true"><figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2FqmkeaL3PsjGMxYh0T0d3%2FCaptura%20de%20Tela%202026-02-20%20a%CC%80s%2000.42.31.png?alt=media&amp;token=80f8b0aa-3055-44a5-ace5-2f2d823f3193" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2F1B5xGdeO5IX1EtxeEsos%2FCaptura%20de%20Tela%202026-02-20%20a%CC%80s%2000.42.44.png?alt=media&amp;token=9144daf5-250e-4562-b0fb-3e06b8ad1144" alt=""><figcaption></figcaption></figure></div>

***

## Ativação de Números no Workspace

Após o Business Manager estar associado, o administrador poderá ativar números do WhatsApp dentro do workspace.

### Etapas da ativação:

{% embed url="<https://docs.otima.io/provedor/canais-de-comunicacao/whatsapp-business/guia-de-usabilidade/ativacao-e-gerenciamento-de-numeros-oficiais>" %}

***

## Permissões Administrativas

A Gestão de Workspaces é restrita a usuários com perfil:

* Administrador da Plataforma Ótima

Esses usuários possuem permissão para:

* Criar e excluir workspaces
* Alterar Business Manager vinculado
* Ativar ou desativar números
* Ajustar configurações globais

Usuários comuns de um workspace não possuem acesso à gestão global.

***

##

{% hint style="success" %}

## Boas Práticas

* Sempre validar se o Business Manager pertence à empresa correta (antes da associação)
* Garantir que o número ativado esteja devidamente verificado na Meta
* Manter controle de quais números estão ativos por workspace
* Revisar permissões administrativas periodicamente
  {% endhint %}