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

# Onboarding do Operador

> O que um owner de workspace faz no produto para deixar a plataforma pronta para tráfego real de WhatsApp.

# Onboarding do Operador

O app do operador agora tem uma rota dedicada `Setup` em `/setup` para configuração de primeiro acesso.

Use-a para o trabalho de conexão de primeiro acesso.
Use `Settings` em `/settings` para manutenção contínua depois que o workspace estiver ativo.

## O Que o Setup Cobre

O fluxo de setup foi desenhado para responder a quatro perguntas:

1. O perfil do workspace está usável?
2. Há um canal de WhatsApp anexado ao workspace?
3. Os segredos do provider estão armazenados com segurança?
4. A plataforma já validou o suficiente da conexão para iniciar testes controlados?

## Fluxo Esperado do Produto

1. Faça login como o primeiro owner do workspace.
2. Abra o `Setup`.
3. Revise a identidade do workspace e do canal.
4. Insira os segredos de provider gerenciados pelo workspace.
5. Valide a configuração do provider.
6. Abra a caixa de entrada e execute um teste de envio controlado.

## Segredos e Armazenamento

O produto distingue entre duas classes de segredo:

* **Segredos de plataforma/bootstrap**: valores pertencentes ao deployment, como credenciais de servidor do Supabase e URLs base. Permanecem como configuração de ambiente de runtime.
* **Segredos gerenciados pelo workspace**: credenciais de provider específicas de cada tenant, inseridas através do produto. São escritas no lado do servidor e armazenadas no Supabase Vault, com apenas status mascarado e metadados de validação expostos na UI.

A UI não retorna valores de segredo descriptografados após a escrita.

## Checklist de Prontidão

O checklist de setup está completo quando:

* o perfil do workspace está definido
* a identidade do canal está presente
* o token de acesso da Meta está armazenado
* o segredo de assinatura de webhook está armazenado
* o verify token da Meta está armazenado
* a validação da Meta não reporta mais um token inválido

## Notas Operacionais

* Segredos de provider baseados em ambiente ainda funcionam como fallback de bootstrap.
* Uma vez que exista um segredo gerenciado pelo workspace no Vault, ele tem precedência sobre o fallback de ambiente para aquele workspace.
* As escritas em Settings são restritas a owner/admin/developer.

## Fazendo onboarding de uma WhatsApp Business Account adicional

Os passos acima descrevem a primeira WABA que um workspace conecta. Um workspace não está mais limitado a uma única WABA — o fluxo `/welcome` também pode apresentar um **seletor de três caminhos** (traga seu próprio token, faça onboarding com a gente via Meta Embedded Signup, ou migre uma conta de WhatsApp já existente) quando a feature flag de Embedded Signup estiver habilitada. Cada WABA adicional recebe seu próprio slot isolado de access token, então um segundo número onboardado nunca sobrescreve as credenciais da primeira WABA.

Veja [Meta Embedded Signup e Multi-WABA](/pt-BR/platform/embedded-signup) para o fluxo completo, os pré-requisitos de feature flag e como a resolução de token por WABA funciona no momento do envio.

## Leia a seguir

* [Meta Embedded Signup e Multi-WABA](/pt-BR/platform/embedded-signup)
* [Conectar WhatsApp](/pt-BR/platform/connect-whatsapp)
* [Plano de Migração](/pt-BR/platform/migration)
* [Operações de Webhook](/pt-BR/operations/webhooks)