Configurações da Organização
As Configurações têm uma navegação própria, separada do painel principal. No menu do seu avatar:
- Minha conta abre Configurações → Perfil;
- Configurações, quando disponível para o seu papel, abre a área administrativa.
Você também pode acessar /settings. O proprietário da organização é direcionado primeiro para Assinatura; as outras pessoas começam em Perfil. Use Voltar ao painel para sair das Configurações.
O que aparece para cada pessoa
Section titled “O que aparece para cada pessoa”Perfil e Preferências aparecem para qualquer pessoa autenticada. As outras seções dependem do papel, das permissões da função e dos recursos habilitados para a organização. Uma seção pode aparecer apenas para consulta quando a pessoa tem permissão de leitura, mas não de alteração.
Geral e Assinatura são exclusivas do proprietário. Quando uma rota não existe ou não está disponível para a pessoa, o SquadOS a redireciona para a primeira seção que ela pode acessar; não use a presença de uma URL como prova de permissão.
Categorias sem nenhuma seção disponível são ocultadas por inteiro.
Mapa das seções
Section titled “Mapa das seções”| Categoria | Seção e rota | O que você encontra |
|---|---|---|
| Configurações pessoais | Perfil — /settings/profile | Foto, nome e e-mail; troca de senha; encerramento da própria conta. |
| Configurações pessoais | Preferências — /settings/preferences | Tema claro/escuro, leitura, notificações das Salas, sons, push e reexibição dos guias das telas. |
| Organização | Geral — /settings/organization | Identidade, idioma da organização, fuso horário, retenção de transcrições e encerramento da organização. Só o proprietário acessa. |
| Organização | Usuários — /settings/users | Membros, equipes, funções e permissões de acesso. |
| Organização | Salas — /settings/rooms | Cadastro e administração das Salas do Hub. Aparece somente quando o Hub colaborativo está habilitado e a pessoa tem a permissão correspondente. |
| Atendimento e CRM | Respostas rápidas — /settings/quick-replies | Textos reutilizáveis para o atendimento. Depende do CRM de atendimento e da permissão correspondente. |
| Atendimento e CRM | Modelos do WhatsApp — /settings/whatsapp-templates | Catálogo e gestão dos modelos de mensagem do WhatsApp. Depende do CRM de atendimento e da permissão correspondente. |
| E-mails | Domínios e remetentes — /settings/email | Ativação do envio, domínio e DNS, remetentes e endereço da empresa. Depende do recurso de e-mail e da permissão correspondente. |
| E-mails | Entrega de E-mails — /settings/email-deliverability | Estado e diagnóstico operacional da entrega. Depende do recurso de e-mail e da permissão correspondente. |
| Agentes IA | Provedor de IA — /settings/ai-provider | Escolha entre créditos SquadOS e OpenRouter própria, gestão da chave e exibição de créditos nas conversas. |
| Agentes IA | Modelos de IA — /settings/ai-models | Catálogo pesquisável de modelos, capacidades, limites e custos. |
| Agentes IA | Proteção anti-bots — /settings/ai-behavior | Regras que pausam respostas repetidas ou excessivas para interromper ciclos entre sistemas automáticos. |
| Desenvolvedores | API — /settings/api | Tokens da API e atalho para a documentação técnica. |
| Desenvolvedores | Webhooks — /settings/webhooks | Endpoints, eventos, ativação e histórico de entregas dos webhooks. |
| Cobrança | Assinatura — /settings/subscription | Créditos, plano, renovação, cobrança, faturas e add-on de Calls/Reuniões. Só o proprietário acessa. |
Geral: configurações compartilhadas pela organização
Section titled “Geral: configurações compartilhadas pela organização”Em Geral, o proprietário controla:
- Nome da Plataforma — obrigatório, com até 100 caracteres;
- Logotipo da Plataforma — PNG, JPEG, WebP ou SVG, até 100 KB; 128 × 128 px em PNG ou SVG é a recomendação da tela;
- Esconder Logotipo SquadOS no menu;
- Idioma da organização — Português ou Inglês; define o idioma dos e-mails enviados pela plataforma;
- Fuso horário — identificador IANA, com uma prévia da hora atual;
- Guardar a transcrição por (dias) — de 1 a 3650 dias.
O áudio das reuniões não é armazenado. O prazo de retenção vale para o texto da transcrição; a ata é mantida permanentemente.
O envio e a remoção do logotipo são aplicados imediatamente. Nome, visibilidade da marca, idioma, fuso e retenção são gravados juntos pelo botão Salvar Personalização. O fuso da organização é usado em automações, campanhas, horários das caixas de entrada e faixas de horário da ferramenta Transferir Conversa.
O encerramento da organização também fica nessa tela e é diferente de encerrar apenas a sua conta em Perfil.
Perfil e Preferências são pessoais
Section titled “Perfil e Preferências são pessoais”Em Perfil, a aba Informações reúne foto, nome e e-mail. A aba Senha exige a senha atual, uma nova senha de 6 a 72 caracteres e a confirmação; o SquadOS reautentica a pessoa antes de alterar a senha. Encerrar conta remove a conta da própria pessoa, não a organização.
Em Preferências, cada pessoa escolhe tema, leitura e comportamento das notificações. O padrão de notificação das Salas pode ser Todas as mensagens, Menções e respostas ou Nenhuma; uma preferência definida dentro de uma sala prevalece sobre esse padrão. O botão Reexibir guias restaura os painéis explicativos dispensados.
Não há seletor pessoal de idioma nessa tela. A interface autenticada acompanha o idioma da organização.
Provedor, modelos e proteção anti-bots
Section titled “Provedor, modelos e proteção anti-bots”Essas três telas têm responsabilidades diferentes:
Provedor de IA
Section titled “Provedor de IA”Em Provedor de IA, escolha a rota de cobrança:
- Usar créditos do SquadOS — não exige configuração; o consumo varia conforme o modelo escolhido em cada agente;
- Conectar minha OpenRouter — a OpenRouter cobra a conta vinculada e o SquadOS aplica 1 crédito por mensagem.
Somente o proprietário pode cadastrar, atualizar ou desconectar a chave OpenRouter. Gere a chave em openrouter.ai/keys, cole em Chave de API e salve. A chave é validada antes de ser armazenada. Nessa mesma tela, Mostrar créditos nas conversas controla se o consumo por resposta aparece na tela de conversas.
Modelos de IA
Section titled “Modelos de IA”Modelos de IA é apenas o catálogo. Pesquise por modelo, provedor ou identificador e filtre por texto ou imagem. Ao abrir um modelo, você encontra capacidades, janela de contexto, saída máxima, recursos de raciocínio e custo.
Com OpenRouter própria, o catálogo mostra o preço do provedor; com créditos SquadOS, mostra uma estimativa em créditos. A chave não é configurada nessa tela.
Proteção anti-bots
Section titled “Proteção anti-bots”Proteção anti-bots vale para todos os agentes da organização. Ela pausa a IA quando:
- a mesma mensagem chega várias vezes dentro da janela observada, ignorando mensagens curtas;
- a IA ultrapassa o teto de respostas na mesma conversa em seis horas.
Os padrões são 6 repetições nas últimas 20 mensagens, comprimento mínimo de 20 caracteres, teto de 100 respostas e retomada após 5 minutos sem mensagem nova. Na segunda pausa da mesma conversa, somente uma pessoa pode religar a IA. Voltar ao padrão restaura todos esses valores; Salvar proteção grava a configuração.
Uma conversa pausada continua ativa e disponível para atendimento humano. Veja Intervenção Humana.
API, webhooks e cobrança
Section titled “API, webhooks e cobrança”Em API, a aba Tokens permite gerar, revogar e excluir credenciais conforme as permissões da pessoa. A lista mostra nome, prefixo, estado, criação, último uso e quantidade de chamadas. A aba Documentação abre a referência completa; veja também API REST e Tokens.
Em Webhooks, você cadastra endpoints, escolhe eventos, ativa ou desativa cada integração e consulta o histórico de entregas. As ações disponíveis dependem das permissões de leitura, escrita e exclusão.
Em Assinatura, o proprietário acompanha saldo e renovação de créditos, plano e limites, estado da cobrança e as cinco faturas mais recentes do Stripe. O botão Gerenciar Assinatura abre o portal de cobrança. Detalhes em Plano e Créditos.
Links antigos
Section titled “Links antigos”Links da antiga tela /admin/settings?tab=… continuam válidos:
| Aba antiga | Destino atual |
|---|---|
subscription | /settings/subscription |
customization | /settings/organization |
ai-models | /settings/ai-provider |
api | /settings/api |
quick-replies | /settings/quick-replies |
rooms | /settings/rooms |
Qualquer outro valor de tab tenta abrir Assinatura; se a pessoa não puder acessá-la, a proteção de rota a encaminha para uma seção disponível.
Trocar de organização
Section titled “Trocar de organização”O seletor de organização fica no topo da barra lateral. Ele lista as organizações das quais você é membro, mostra o papel em cada uma e marca a organização ativa. Ao trocar, o SquadOS invalida e recarrega os dados da organização.
O seletor também oferece Criar organização e Ver todas as organizações. Para superadmins, Ver todas as organizações é o caminho para abrir organizações das quais não são membros.