Gerenciamento do Workspace
Configure o workspace, membros, atendentes, provedores de LLM, destinos de transferência, identidade e whitelabel.
Visão geral
Workspace é o espaço compartilhado onde sua equipe gerencia agentes, conhecimento, integrações e dados. A tela tem seis seções no menu lateral — Geral, Usuários, Atendentes, Labels, Provedores LLM e Destinos de transferência — além do Whitelabel, acessado por URL direta.
Geral
Informações do workspace
Card com nome, plano, data de criação, última atualização e o ID do workspace (com botão de copiar — é ele que você informa ao suporte).
Nome
Edite o nome e clique em Salvar alterações. O novo nome aparece em toda a plataforma, inclusive no seletor de workspace.
Verificação de identidade
Faça o seu site assinar quem é o usuário logado. Com isso, o widget vincula a conversa a essa identidade em vez de confiar apenas no navegador — é o que permite responder com segurança sobre dados da conta do visitante.
- Clique em Gerar segredo (ele fica revelável para admins do workspace)
- No seu servidor, calcule o HMAC do id do usuário:
// Node.js — no SEU servidor, nunca no navegador
const crypto = require('crypto');
const userHash = crypto
.createHmac('sha256', process.env.TAKESALES_IDENTITY_SECRET)
.update(String(user.id))
.digest('hex');
// e renderize no config do widget
window.TakeSalesConfig = { agentId: '...', userId: String(user.id), userHash };- Publique e pronto: conversas com
userId+userHashválidos passam a ser identificadas
O segredo nunca pode ir para o navegador — quem tem o segredo consegue se passar por qualquer usuário seu. Rotacionar invalida o segredo atual na hora: todos os usuários voltam a ser anônimos até você publicar o novo.
Zona de perigo
Excluir workspace remove tudo permanentemente. O workspace precisa estar sem agentes para poder ser excluído.
A exclusão é irreversível e todos os membros perdem acesso imediatamente.
Usuários
Membros
Tabela com nome, e-mail e função. Você pode alterar a função, remover o membro e ver quem é você na lista.
Convites
Convidar membro aceita vários e-mails de uma vez (vírgula, ponto-e-vírgula ou quebra de linha) e uma função. A seção Convites pendentes mostra quem ainda não aceitou, quando o convite expira, e permite reenviar ou copiar o link para mandar por outro canal.
Funções
| Função | O que pode fazer |
|---|---|
| Admin | Controle total sobre recursos e membros, incluindo configurações da organização e exclusão do workspace |
| Developer | Cria e testa agentes, vê dados brutos, gerencia analytics e configurações — sem gerenciar membros |
| Member | Leitura de agentes, testes, histórico filtrado e analytics; não altera nada nem vê dados sensíveis |
Grupos de atendimento
Agrupe operadores (ex.: "Suporte técnico", "Financeiro") para transferir conversas para um time inteiro: a conversa fica pendente na fila do grupo e só os membros dele — e os admins — a veem e podem aceitar. Veja Atendimento (Inbox).
Atendentes
Define quando cada pessoa do time está disponível para atender e quantas conversas ela segura ao mesmo tempo. Todos os membros veem a tabela; só admins editam.
| Coluna | O que mostra |
|---|---|
| Atendente | Nome e e-mail |
| Agora | Disponível ou Fora do horário, calculado neste momento |
| Horário | Sempre disponível ou Horário definido, com o fuso |
| Conversas ativas | Atendimentos em andamento com a pessoa / limite (ou "sem limite") |
Horário de atendimento
Em Editar horário:
- Sempre disponível — Ligado, o atendente não tem restrição de horário (é o padrão)
- Fuso horário — O fuso do atendente; o horário e os feriados são avaliados nele
- Faixas por dia — De segunda a domingo, até 4 faixas por dia (ex.: 09:00–12:00 e 13:00–18:00); dia sem faixa fica Fechado
- Atende em feriados — Desligado, o atendente fica indisponível nos feriados do workspace
- Limite de conversas simultâneas — De 1 a 100; em branco, sem limite
Feriados
O card Feriados lista os feriados do ano, com navegação entre anos:
- Feriados nacionais — Ligado (padrão), inclui automaticamente os feriados nacionais do Brasil, além de Carnaval e Corpus Christi, marcados como nacional. Eles não podem ser removidos um a um: para não usá-los, desligue a opção
- Feriados próprios — Admins adicionam datas do workspace (ex.: "Aniversário da cidade") com data e nome, e podem removê-las
Por enquanto, horário, feriados e limite são informativos: a tabela mostra quem está disponível e a carga de cada um, mas a fila da inbox e as transferências ainda não levam essas regras em conta — uma conversa pode ser transferida para alguém fora do horário ou acima do limite. Use a tabela para decidir para quem transferir.
Provedores LLM (BYOL)
Cadastre suas próprias chaves de LLM e use seus modelos nos agentes. Provedores suportados: Google Gemini, OpenAI, Anthropic, Groq, OpenRouter e qualquer endpoint compatível com OpenAI.
| Campo | Observação |
|---|---|
| Nome | Identificação da credencial (ex.: "OpenAI produção") |
| Provider | Um dos suportados |
| Base URL | Obrigatória em provedores compatíveis com OpenAI |
| Modelo padrão | Opcional (ex.: gpt-4o-mini) |
| API key | Armazenada cifrada; na edição, deixe em branco para manter a atual |
| Ativa | Desativada, os agentes caem no provider global |
A lista mostra o fingerprint da chave e a última validação. Testar conexão valida a credencial e informa a latência.
Depois de cadastrar, escolha a credencial no agente em Fonte de LLM.
As chaves são cifradas em repouso (AES-256-GCM) e nunca voltam em respostas da API. URLs com IP privado ou endpoint de metadados são bloqueadas.
Remover uma credencial em uso faz soft-delete (desativa); sem agentes vinculados, ela é apagada. Em ambos os casos, os agentes voltam ao provider global. A voz usa o Gemini Live por padrão — BYOL atua no pipeline de texto.
Destinos de transferência (voz)
Allowlist dos números E.164 para os quais o agente pode transferir uma ligação. Nenhum número fora desta lista pode ser discado pelo LLM.
| Campo | Descrição |
|---|---|
| Rótulo | O que o agente vê (ex.: "Plantão de Vendas") |
| Número (E.164) | +5511999999999 |
| Tipo | Interno (SDR/atendente) ou externo (terceiro) |
| País | ISO-3166 |
| Ativo | Destinos desativados não podem ser usados |
O LLM enxerga apenas o rótulo, nunca o número. Isso impede que um número seja "inventado" ou extraído do prompt.
Whitelabel
Personaliza a plataforma com a sua marca — feito para agências e revendedores.
O item de menu do whitelabel fica oculto: a página é acessada por URL direta (/workspace/whitelabel). Se você revende a plataforma e quer usar o recurso, fale com o suporte.
O que dá para configurar:
- Ativar whitelabel — Liga a identidade personalizada do workspace
- Nome do app — Substitui "TakeSales" no título da página e nos metadados
- Logo (tema claro e escuro) e favicon
- Cores da marca — Primária e secundária, com substituições avançadas por tema (fundos, textos e bordas, claro e escuro)
- Domínio personalizado — O domínio onde a plataforma whitelabel responde; aponte o DNS para a plataforma
- Restaurar padrões — Volta tudo para a identidade Take Sales
Além da plataforma, o widget pode esconder a marca: desligue Exibir marca Take Sales nas configurações do agente para remover o "Powered by Take Sales" do rodapé do chat.