> ## 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.

# Convidar o time

> Como adicionar membros à sua organização Apollo Space — papéis, governança e o que acontece com os dados quando alguém sai.

## O que você vai construir

Ao final deste guia, você consegue:

* Adicionar colegas à sua organização Apollo Space (member, admin, viewer)
* Mudar o papel deles depois conforme a responsabilidade evolui
* Remover quem saiu do time, sem perder histórico
* Auditar quem convidou quem, em que data

Tempo estimado: **5 minutos por convite**.

## Quem pode convidar

Apenas **Owners** e **Admins** da organização. Members e Viewers não
veem essa opção no menu — proteção contra escalação de privilégio
acidental.

## Passo 1: abrir o diálogo de convite

**Settings → Membros → Convidar**.

<Info>
  Se você não vê o botão **Convidar**, seu papel é Member ou Viewer.
  Peça pro Owner / Admin da sua org promover seu papel ou disparar o
  convite por você.
</Info>

## Passo 2: escolher e-mail + papel inicial

Preencha o e-mail do convidado e escolha um dos quatro papéis:

| Papel      | Resumo                                         |
| ---------- | ---------------------------------------------- |
| **Owner**  | Tudo. Inclusive deletar a org.                 |
| **Admin**  | Tudo do dia-a-dia. Não promove Owners.         |
| **Member** | Opera. Não mexe em configuração / faturamento. |
| **Viewer** | Só leitura.                                    |

Veja [Organizações](/pt/concepts/organizations) pro detalhe de cada um.

<Tip>
  **Comece restrito.** Convide novos membros como Member por default;
  promova a Admin só quando o role justificar. É mais fácil expandir
  privilégio depois do que pedir pra alguém "me devolver o admin".
</Tip>

## Passo 3: enviar

Clique **Enviar convite**. Apollo Space:

1. Gera um link único pro e-mail informado
2. Dispara o e-mail (template padrão Apollo Space)
3. Mostra o convite na lista de **Pendentes**

**Resultado esperado:** o convidado recebe e-mail em segundos. Você
vê a linha na aba **Pendentes** com badge "Aguardando aceite".

<Warning>
  **O link de convite é single-use e expira em 7 dias.** Se o
  convidado não aceitar nesse prazo, você precisa re-emitir (botão
  **Reenviar** na linha de pendentes — gera link novo e invalida o
  anterior).
</Warning>

## Passo 4: o convidado aceita

O convidado clica no link e:

| Situação                       | O que acontece                                           |
| ------------------------------ | -------------------------------------------------------- |
| **Já tem conta Apollo Space**  | Loga na conta existente e entra direto na sua org        |
| **Não tem conta Apollo Space** | O link permite criar a conta dele já vinculada à sua org |

<Info>
  **O convite intra-org é o caminho oficial pra trazer alguém pra
  dentro do Apollo Space.** Como a plataforma está em fase de acesso por
  convite, não há cadastro público — o link que você dispara como
  owner/admin é o que permite a pessoa criar conta no Apollo Space.
</Info>

## Mudar o papel depois

Em **Settings → Membros**, cada linha tem um dropdown de papel.
Selecione o novo papel e confirme.

<Warning>
  **Só Owners promovem Owners.** Admins não conseguem mexer no nível
  de Owner. Esta restrição protege contra: uma conta Admin
  comprometida tomar controle total da org.
</Warning>

## Remover um membro

Em **Settings → Membros**, botão **Remover** ao lado do nome.
Confirma o diálogo e o membro perde acesso imediatamente.

### O que acontece com o que ele criou

| Tipo de dado                                                | O que acontece                                                             |
| ----------------------------------------------------------- | -------------------------------------------------------------------------- |
| **Leads, atividades, conversas**                            | Ficam — só mudam de owner se você re-atribuir. Histórico preservado.       |
| **Notas pessoais no Brain pessoal**                         | Ficam inacessíveis pra org. Se precisa do conteúdo, peça antes de remover. |
| **Integrações pessoais** (Notion pessoal via Composio etc.) | Acesso revogado, token criptografado deletado.                             |
| **Audit log das ações dele**                                | Preservado. "João criou tal lead em tal data" continua na timeline.        |

## Convites pendentes

Em **Settings → Membros → Pendentes**, você vê todos os convites
não-aceitos. Ações disponíveis por linha:

| Ação                    | O que faz                           |
| ----------------------- | ----------------------------------- |
| **Reenviar**            | Gera link novo, invalida o anterior |
| **Cancelar**            | Revoga sem aceitar                  |
| **Mudar papel inicial** | Re-emite com novo papel atribuído   |

## Auditoria

Toda operação de membership fica registrada no histórico da org:

| Evento            | O que inclui                               |
| ----------------- | ------------------------------------------ |
| `invite_sent`     | Quem convidou, pra qual e-mail, qual papel |
| `invite_accepted` | Quem aceitou, quando                       |
| `invite_revoked`  | Quem cancelou, quando                      |
| `role_changed`    | De qual papel pra qual, por quem           |
| `member_removed`  | Quem foi removido, por quem                |

Útil em compliance: *"quem deu acesso de Admin pro João, em que data?"*
é respondível em segundos.

## Padrões recomendados

<AccordionGroup>
  <Accordion title="Comece restrito" icon="lock">
    Convide novos membros como **Member**. Promova a **Admin** só
    quando o role justifica (vai mexer em configuração da org,
    integrações, faturamento, ou convidar outros membros).
  </Accordion>

  <Accordion title="Owner é raro" icon="crown">
    Idealmente **1-2 Owners por org** (founders / liderança máxima).
    Owner é quem mexe em plano, deleta a org, controla billing. Não
    precisa ser todo mundo.

    Se você tem só 1 Owner, considere ter um **backup** — caso o
    Owner perca acesso ou saia da empresa, recuperar a org sem outro
    Owner exige escalação ao suporte Apollo Space.
  </Accordion>

  <Accordion title="Viewer pra auditores" icon="eye">
    Use **Viewer** pra stakeholders externos (advogado, contador,
    board member, consultor externo) que precisam acompanhar mas
    não devem operar nem ver dados sensíveis editáveis.
  </Accordion>

  <Accordion title="Revisão periódica" icon="rotate">
    A cada 3-6 meses, revise a lista de membros + roles:

    * Remova quem saiu da empresa
    * Ajuste roles que escalaram demais
    * Confirme que ainda faz sentido alguém ter Owner

    Esse ritual evita acúmulo de privilégio ao longo do tempo.
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Organizações" icon="building" href="/pt/concepts/organizations">
    O modelo de papéis em detalhe + multi-tenant.
  </Card>

  <Card title="Configurar WhatsApp" icon="comments" href="/pt/guides/set-up-whatsapp">
    Próxima coisa que você provavelmente vai querer conectar.
  </Card>

  <Card title="Trust — segurança" icon="shield-check" href="/pt/trust/security">
    Como o Apollo Space protege os dados que cada membro acessa.
  </Card>
</CardGroup>
