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

# Painel — configurações

> Tour pelas configurações da organização — membros, integrações, agentes, faturamento.

## O que mora em Settings

Settings é o **painel de configuração** da sua organização. Cinco
áreas principais, cada uma com restrição de papel apropriada:

<CardGroup cols={2}>
  <Card title="Geral" icon="circle-info">
    Nome da org, descrição, slug. Quem edita: **Owner / Admin**.
  </Card>

  <Card title="Membros" icon="users">
    Adicionar / remover / mudar papel. Quem edita: **Owner / Admin**.
    Veja [Convidar o time](/guides/invite-team).
  </Card>

  <Card title="Integrações" icon="plug">
    Conectar Twilio, Composio, Tavily, Apify. Quem edita: **Owner /
    Admin**. Member vê o status (conectado / não), mas não muda
    credencial.
  </Card>

  <Card title="Agentes" icon="robot">
    Habilitar personas, configurar caps por agente, editar
    `voice_md`. Quem edita: **Owner / Admin**.
  </Card>

  <Card title="Faturamento" icon="credit-card">
    Saldo, planos, packs, caps de gasto, portal Stripe. Quem vê:
    **Owner / Admin**. Quem muda plano / compra pack: só **Owner**.
  </Card>

  <Card title="Confiança" icon="shield-check">
    Audit log, sessões ativas, dados pessoais (LGPD). Owner +
    Admin podem inspecionar; users veem só seu próprio audit
    pessoal.
  </Card>
</CardGroup>

## Geral — o que dá pra mudar (e o que não dá)

| Campo                | Pode trocar?                                                        |
| -------------------- | ------------------------------------------------------------------- |
| **Nome de exibição** | Sim. Aparece no chat, no e-mail, no portal.                         |
| **Descrição**        | Sim. Texto livre — vai pro contexto que os agentes leem.            |
| **Logo** (upload)    | Sim. Mostrado no chat + assinatura de e-mail.                       |
| **Slug**             | Não. Vira parte da URL — trocar quebraria links externos.           |
| **País / fuso**      | Sim. Afeta defaults de cadência outbound + tipo de número WhatsApp. |
| **Idioma default**   | Sim. Default da voz da org (pt-BR / es / en).                       |

<Warning>
  **Trocar o slug exigiria migração de URLs** — todas as integrações
  externas (webhooks Twilio, Resend, links de proposta gerados pelo
  Marcus) apontam pra URL com o slug atual. Por enquanto não é uma
  operação suportada via UI. Se você precisa muito, abra ticket
  com suporte.
</Warning>

## Membros — fluxo rápido

<Steps>
  <Step title="Settings → Membros → Convidar">
    Diálogo abre com 2 campos: e-mail + papel inicial.
  </Step>

  <Step title="Defina o papel inicial">
    Owner / Admin / Member / Viewer. Veja [Organizações](/concepts/organizations)
    pro que cada um pode fazer.
  </Step>

  <Step title="Apollo Space envia o link">
    Single-use, expira em 7 dias. O convidado clica + cria conta +
    cai dentro da sua org.
  </Step>
</Steps>

Detalhe completo: [Convidar o time](/guides/invite-team).

## Integrações — o que dá pra conectar

| Integração          | Pra que serve                             | Modelo                                         |
| ------------------- | ----------------------------------------- | ---------------------------------------------- |
| **Twilio WhatsApp** | Marcus dispara WhatsApp                   | BYO key                                        |
| **Resend / Gmail**  | Marcus dispara e-mail                     | BYO key (Resend) ou OAuth (Gmail via Composio) |
| **Composio**        | 400+ apps SaaS (Notion, Slack, Linear...) | OAuth gerenciado pela Composio                 |
| **Tavily**          | Scout faz busca web                       | BYO key                                        |
| **Apify**           | Maps lead search + enrichment             | BYO key                                        |

<Info>
  **Todas as integrações são opt-in.** Org nova começa sem nenhuma
  conectada. Conecte só as que você for usar — credenciais não
  configuradas significam que a feature relacionada não aparece pros
  agentes (em vez de mostrar tool que dá erro).
</Info>

Guias detalhados por integração:

<CardGroup cols={2}>
  <Card title="WhatsApp via Twilio" icon="comments" href="/guides/set-up-whatsapp">
    Setup end-to-end (45 min a 7 dias com aprovação Meta).
  </Card>

  <Card title="Composio" icon="puzzle-piece" href="/integrations/composio">
    OAuth + 400+ apps.
  </Card>

  <Card title="Tavily" icon="magnifying-glass" href="/integrations/tavily">
    Motor de busca pública do Scout.
  </Card>

  <Card title="Apify" icon="map-pin" href="/integrations/apify">
    Maps + enrichment de contato.
  </Card>
</CardGroup>

## Agentes — onde configurar persona

Por agente (Scout / Marcus / Athena / Twin / customizado), Settings
expõe:

<AccordionGroup>
  <Accordion title="Habilitar / desabilitar" icon="toggle-on">
    Liga ou desliga a persona pra sua org. Desabilitar **não apaga**
    histórico — só esconde da interface e bloqueia novas chamadas.
  </Accordion>

  <Accordion title="Voice_md" icon="comment">
    Markdown que descreve a voz da org / persona — tom, vocabulário,
    cumprimento, assinatura. Editável pelo time, versionado, audited.
    Agentes relêem a cada conversa.
  </Accordion>

  <Accordion title="Caps de gasto por agente" icon="gauge-high">
    Teto diário e mensal por agente. Veja [Caps](/billing/caps) pro
    detalhe dos 4 níveis de proteção.
  </Accordion>

  <Accordion title="Tools habilitadas" icon="screwdriver-wrench">
    Quais ferramentas o agente pode acionar. Default razoável por
    persona — você pode restringir (ex.: tirar `web_search` do
    Marcus se quiser que ele dependa do Scout pra pesquisa).
  </Accordion>

  <Accordion title="Memória + Brain" icon="brain">
    Quais documentos do Brain o agente consulta. Default: tudo o
    que é público da org. Restrição: só docs com tag específica.
  </Accordion>
</AccordionGroup>

## Faturamento — atalhos comuns

<CardGroup cols={2}>
  <Card title="Mudar plano" icon="circle-arrow-up" href="/billing/plans-and-packs">
    Upgrade / downgrade via Stripe portal.
  </Card>

  <Card title="Comprar pack avulso" icon="box" href="/billing/plans-and-packs">
    Top-up de Stars que não expira.
  </Card>

  <Card title="Configurar caps" icon="gauge-high" href="/billing/caps">
    Tetos por org / agente / usuário.
  </Card>

  <Card title="Histórico da carteira" icon="receipt" href="/billing/stars">
    Ledger append-only — todo movimento auditável.
  </Card>
</CardGroup>

## Auditoria — o que fica registrado

Toda operação em Settings gera entrada no audit log da org. Quem,
quando, o quê. Owner + Admin podem inspecionar; auditores externos
podem ser provisionados como Viewer + permissão de leitura do
audit.

Veja [Segurança](/trust/security) pro modelo completo de audit.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Painel — visão geral" icon="house" href="/dashboard/overview">
    O que aparece quando você loga.
  </Card>

  <Card title="Trust — multi-tenant" icon="shield-check" href="/trust/multi-tenant">
    Como cada org fica isolada das outras no banco.
  </Card>
</CardGroup>