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

# Organizações

> A organização é o tenant — a fronteira de tudo no Apollo Space. Aqui está como ela funciona.

Uma consultora entra na segunda-feira, escolhe um cliente no seletor de orgs,
e o workspace inteiro vira daquele cliente: os leads dele, os agentes dele, as
conversas dele, a conta dele. Uma hora depois ela troca para o próximo cliente
e a tela se comporta como se o primeiro nunca tivesse existido.

Essa linha limpa é a **organização** — a fronteira que o Apollo Space, o
sistema operacional de IA da sua empresa, desenha em volta de tudo. É o que
permite um único login abrigar três clientes, ou três unidades de negócio, sem
ninguém nunca ter dúvida de quais dados estão na tela.

## O que é uma organização

Uma **organização** (ou **org**) é o **tenant** do Apollo Space: a fronteira
onde dados, agentes, integrações e faturamento vivem. Todo recurso
que você cria — um lead, um agente, uma conversa — pertence a exatamente
uma organização.

<Info>
  Um usuário pode pertencer a **várias organizações** (ex.: um consultor
  que atende três clientes). O Apollo Space nunca mistura: ao trocar de org no
  menu, todo o contexto da tela atualiza pra refletir aquela tenant.
</Info>

<Note>
  **Apollo Space está em fase de acesso por convite.** A equipe Apollo Space
  libera o seu primeiro acesso (entre em contato pelos canais
  oficiais). A partir daí o onboarding é self-serve — você cria a
  org da sua empresa direto no app e convida o time. Não há
  cadastro público.
</Note>

## Modelo de papéis

Dentro de uma org, cada membro tem um **papel** que define o que pode
fazer:

| Papel      | O que pode fazer                                                           |
| ---------- | -------------------------------------------------------------------------- |
| **Owner**  | Tudo — incluindo trocar plano, deletar a org, adicionar/remover membros    |
| **Admin**  | Configurar agentes, integrações, pipelines, ver toda a org                 |
| **Member** | Operar dia-a-dia (criar leads, conversar com agentes, despachar campanhas) |
| **Viewer** | Somente leitura — útil para auditores ou stakeholders externos             |

Convites são feitos por e-mail. Veja [Convidar o time](/pt/guides/invite-team)
para o passo-a-passo.

## Isolamento de dados — multi-tenant de verdade

Esta seção é a parte **técnica/de segurança**. Se você só quer usar o
Apollo Space, pode pular — mas é importante saber que ela existe.

### Isolamento aplicado no banco

Cada tabela do Apollo Space que carrega dados de cliente está protegida por
uma regra no banco que **só permite ler/escrever linhas da org ativa**
naquela sessão. Em termos práticos: mesmo que um bug na aplicação
esqueça de filtrar por org, o banco recusa o acesso.

```mermaid theme={null}
flowchart LR
    A[Usuário acessa /minha-org/leads] --> B[Backend identifica org ativa]
    B --> C[Marca sessão do banco com identificador]
    C --> D[Query lê tabela tenant]
    D --> E{Linha pertence à org ativa?}
    E -->|Sim| F[Retorna]
    E -->|Não| G[Banco omite — como se não existisse]
```

### Por que isso importa

* **Sem cross-bleed**: um descuido na camada de aplicação ainda assim
  não vaza dados entre orgs — o banco intercepta.
* **Auditável**: o time de segurança da sua empresa pode verificar o
  modelo diretamente, sem depender de promessa contratual.
* **SOC-ready**: o desenho é audit-friendly e cobrável por revisão
  externa.

## Diferentes contextos numa mesma org

A organização tem três contextos lógicos que aparecem na UI:

<CardGroup cols={3}>
  <Card title="Workspace (compartilhado)" icon="users">
    Onde o time inteiro opera. Leads, pipelines, conversas dos agentes
    org-scoped, documentos. Padrão para a maioria das telas.
  </Card>

  <Card title="Espaço pessoal" icon="user">
    Cada membro tem um espaço próprio (notas, traces de teste,
    integrações pessoais — ex.: o Notion do seu próprio time).
  </Card>

  <Card title="Digital Twin" icon="user-astronaut">
    O agente "twin" de um líder — representa decisões e voz dele em
    conversas que ele não vai mediar diretamente. Veja
    [Digital Twins](/pt/agents/digital-twins).
  </Card>
</CardGroup>

## Limite por org

Uma organização tem orçamento próprio em [Stars](/pt/billing/stars) e seus
próprios [caps de gasto](/pt/billing/caps). Nada do que acontece em uma org
afeta o saldo da outra — mesmo que o mesmo usuário esteja em ambas.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Agentes" icon="robot" href="/pt/concepts/agents">
    Cada org tem agentes próprios. Veja como funcionam.
  </Card>

  <Card title="Multi-tenant security" icon="shield-check" href="/pt/trust/multi-tenant">
    Detalhe técnico do modelo de isolamento — para times de segurança.
  </Card>
</CardGroup>