Perguntas Frequentes

Respostas para as dúvidas mais comuns sobre a plataforma Take Sales.

Conta, workspace e plano

Como crio minha conta?

Acesse app.takesales.ai e clique em Criar conta. Você pode se cadastrar com e-mail e senha (com confirmação por e-mail) ou entrar direto com o Google. Em seguida o onboarding cria o seu primeiro workspace e o primeiro agente.

Guia completo em Criar sua conta.

Como funciona o plano e a cobrança?

O plano do workspace e o saldo de créditos são definidos pela equipe Take Sales — não existe autoatendimento de assinatura dentro da plataforma. Para contratar, mudar de plano, aumentar limites ou tirar dúvidas de cobrança, fale com o suporte comercial.

A cobrança separa voz e texto. Voz (chamada de voz no widget e ligações por telefone) consome os minutos do plano, mais eventuais bônus concedidos manualmente. Texto (chat do widget, WhatsApp, Instagram, Telegram, Freshchat e API HTTP) consome uma franquia mensal de conversas e tokens — o que acabar primeiro bloqueia novas conversas de IA por texto até o próximo ciclo. Um agente com voz e chat que fica sem minutos passa a atender só por texto, enquanto a franquia de texto durar.

No Dashboard você acompanha os dois separadamente: minutos de voz usados e restantes, conversas e tokens de texto, e quando o período reinicia.

O que são os limites de uso?

Além dos créditos, o workspace e cada agente podem ter tetos de tokens e conversas por hora, dia, semana e mês (fuso America/São_Paulo, semana começando na segunda). Configure em Configurações → Preferências (workspace) e no formulário do agente.

Os dois valem juntos: o mais restritivo bloqueia. Ao atingir o teto, novas conversas são recusadas até a próxima janela.

Posso ter múltiplos workspaces?

Sim. A mesma conta cria e participa de vários workspaces, e os dados são completamente isolados entre eles — agentes, conversas, base de conhecimento, integrações, canais e membros. Alterne pelo seletor no topo da barra lateral.

Veja Workspace.

Quais são os papéis de usuário?

Admin (controle total, incluindo membros e configurações da organização), Developer (cria e testa agentes, vê dados brutos, gerencia analytics e configurações, sem mexer em membros) e Member (leitura de agentes, testes, histórico filtrado e analytics).

Agentes

Quantos agentes posso criar?

Depende do que foi contratado para o seu workspace. Na prática, o limite que você sente no dia a dia são os minutos de voz, a franquia de conversas/tokens de texto e os limites de uso — não a quantidade de agentes.

Quais idiomas são suportados?

O agente atende no idioma configurado e, com o modo multilíngue ligado, detecta o idioma do visitante e responde nele. A interface do painel está em português, inglês e espanhol.

Qual modelo de IA é usado? Posso usar minha própria chave?

Por padrão o agente usa o provider global da plataforma (Gemini). No formulário do agente você pode escolher outro provider para o pipeline de texto (gemini, openai, anthropic, groq, openrouter).

E sim: com BYOL (Workspace → Provedores LLM) você cadastra a sua própria chave — inclusive de endpoints compatíveis com OpenAI — e define o modelo padrão dela. As chaves são cifradas em repouso e nunca voltam em respostas da API.

Meu agente pode falar por voz?

Sim, de duas formas: voz no widget (o visitante fala pelo navegador) e telefone, conectando um canal de voz (Twilio Voice; Telnyx também suportado). Pelo telefone o agente atende ligações e faz ligações ativas, individuais ou em campanha.

Veja configurações de voz e Voz e SMS.

Posso ter vários agentes trabalhando juntos?

Sim. Há roteamento inicial (regras determinísticas que escolhem quem responde a primeira mensagem), transferência entre agentes (levando resumo e contexto), consulta entre agentes (pergunta a um especialista sem transferir) e políticas de escalação. Veja vários agentes.

Como melhoro as respostas do meu agente?

Quatro alavancas, nesta ordem: base de conhecimento (é onde está a maior parte dos erros), diretrizes claras com limites e fallback, guardrails (correção de afirmações, detector de contradições, verificação de fidelidade) e análise de conversas reais.

Use a aba Logs da conversa para ver exatamente quais trechos o agente recuperou antes de responder — isso separa "problema de conteúdo" de "problema de prompt".

Posso usar o mesmo agente em vários canais?

Sim. Um agente pode atender no widget, WhatsApp, Instagram, Telegram, Freshchat e telefone ao mesmo tempo, com as mesmas diretrizes e bases. As conversas ficam registradas separadamente por canal.

Base de conhecimento

Quais formatos são suportados?

O limite é de 50 MB por arquivo.

Qual a diferença entre "injetar como prompt" e "busca semântica"?

Injetar como prompt coloca o conteúdo inteiro no contexto em toda conversa — bom para textos curtos e sempre relevantes, mas consome tokens sempre. Busca semântica (RAG) indexa o conteúdo e recupera apenas os trechos relevantes de cada pergunta — obrigatório para arquivos e recomendado para tudo que for grande.

Como o RAG funciona por alto?

1. Indexação — O conteúdo é dividido em trechos e cada trecho vira um vetor (embedding)
2. Busca — A pergunta do visitante também vira vetor e o sistema encontra os trechos mais próximos
3. Geração — O modelo responde com a pergunta + os trechos recuperados

Tudo isso acontece em milissegundos, a cada mensagem.

Como sei se o RAG está funcionando?

A Auditoria da RAG, na aba Logs de cada conversa, mostra a query original, a reescrita, as sub-queries e os trechos usados, com link para a fonte.

Taxa de acerto baixa quase sempre significa falta de conteúdo, não falha do modelo.

Posso atualizar a base sem pausar o agente?

Sim. O conteúdo é reprocessado em segundo plano enquanto o agente continua atendendo com a versão anterior. Itens de website ainda podem se atualizar sozinhos (diário, semanal ou mensal).

Posso publicar parte da base como central de ajuda?

Sim. Um item pode ser publicado na central de ajuda do agente, acessível a qualquer visitante sem login. Revise o conteúdo antes: publicado é público.

Canais

Quais canais são suportados?

Preciso de conta Twilio para o WhatsApp?

Não. O canal WhatsApp usa a API oficial da Meta (Cloud API), sem intermediário: você conecta o app do WhatsApp Business no Meta for Developers, informa Phone Number ID, token permanente e verify token, e cola a Callback URL no painel da Meta.

O Twilio entra em outro contexto: o canal de voz (telefonia) e o envio de SMS como integração.

Passo a passo em WhatsApp.

O widget funciona em celular?

Sim, o widget é responsivo e funciona em smartphones e tablets, inclusive no modo de voz — desde que o navegador tenha permissão de microfone e a página esteja em HTTPS.

Posso personalizar a aparência do widget?

Sim: cores, ícone, posição, avatar, tela inicial, mensagem de pré-abertura, abas estilo messenger, respostas rápidas e a exibição (ou não) da marca Take Sales. Veja configurar o widget.

Como faço o widget saber quem é o usuário logado no meu site?

Use a identidade assinada: o seu servidor calcula HMAC-SHA256(userId, segredo do workspace) e passa userId + userHash no TakeSalesConfig. Assim a conversa é vinculada àquela pessoa em vez de confiar no navegador. O segredo é gerado em Workspace → Verificação de identidade e nunca pode ir para o browser.

Integrações e ferramentas

Quais integrações existem?

CRMs (HubSpot, Salesforce, Pipedrive, Zoho, RD Station, Ploomes, Agendor, PipeRun, Bitrix24), Google Calendar, Slack, Trello, Typeform, SendGrid, Twilio SMS, Postgres externo, Webhook, servidores MCP e API personalizada. A lista que vale é a que aparece em Integrações no seu workspace.

Posso conectar qualquer API?

Sim, de duas formas: custom tools (você define URL, método, headers, parâmetros e body — ou cola um cURL e a plataforma preenche) e MCP, conectando um servidor Model Context Protocol cujas ferramentas são descobertas automaticamente.

Veja Ferramentas e Custom Tools.

O que são Client Variables?

São dados lidos do navegador do visitante (localStorage, sessionStorage, cookie, window, um elemento da página ou uma meta tag) e usados como parâmetros nas ferramentas — sem o agente precisar perguntar. Exemplo: enviar o ID do usuário logado ou a página atual para a sua API.

Qual a diferença entre auto e confirm?

Ações de alto risco marcadas na integração vão para a Fila de Aprovação, onde alguém do seu time aprova ou rejeita antes da execução.

O agente pode guardar dados entre conversas?

Pode. Ferramentas podem salvar valores da resposta em variáveis da conversa (inclusive persistentes) e vincular a pessoa do contato. Esses dados ficam em Pessoas e voltam nas próximas conversas da mesma pessoa.

Analytics e dados

Quais métricas posso acompanhar?

• Visão geral — Conversas, contatos, taxa de automação, resolvidas pela IA, transferências e satisfação
• Atendimento — Pedidos, aceitos, espera e atendimento médios, quem pediu e por tema
• Temas — Ranking dos assuntos mais falados nas conversas
• Consumo e custos — Minutos de voz, conversas e tokens no período, mais custo em USD por finalidade, modelo, agente e canal (ADMIN)
• Qualidade do agente — Chamadas de ferramenta e motivos de encerramento

Tudo filtrável por canal, agente e período (24h, 7, 30, 90 dias ou intervalo personalizado). Veja Analytics.

Como o custo em USD é calculado?

Tokens × preço de lista do modelo, calculado no momento da leitura. Por isso, cadastrar o preço de um modelo corrige retroativamente os períodos anteriores. Modelos sem preço cadastrado aparecem como "—" e seus tokens são contados à parte, como "tokens sem preço" — nunca como custo zero.

Posso exportar dados?

Sim. A página Histórico exporta em CSV tudo que corresponde aos filtros ativos. Para integração contínua, use webhooks ou automações.

Por quanto tempo os dados ficam guardados?

Cada agente tem uma configuração de retenção de dados: depois do prazo, o histórico privado da conversa (transcrição, áudio e variáveis coletadas) é anonimizado, e as métricas agregadas são preservadas. Registros de execução de ferramenta expiram em 30 dias.

API e desenvolvimento

Existe uma API pública?

Existe a API HTTP do agente: POST https://api-agent.takesales.ai/api/agent/{agentId}/messages, autenticada com a chave daquele agente, para conversar a partir do seu backend.

Não existe hoje uma API REST pública de administração (criar agentes, listar conversas por token). A API que o painel consome usa o JWT da sessão do usuário e não é publicada como produto. Veja visão geral da API.

Como funciona a autenticação da API?

Por chave do agente, enviada como Authorization: Bearer <chave>. A chave é gerada por agente, exibida uma única vez (a plataforma guarda apenas o hash) e pode ser rotacionada ou revogada. Hoje a habilitação é feita pela API de administração ou pelo suporte.

Limite: 30 requisições por minuto por agente. Veja Autenticação.

Que eventos os webhooks enviam?

conversation.started, conversation.ended, lead.captured, visit.scheduled, sentiment.negative e visitor.identified — além dos eventos de tracking (tracking.*). O payload é assinado com HMAC-SHA256 quando há segredo, e falhas são reenviadas até 3 vezes com backoff. Veja Webhooks.

Segurança e privacidade

Os dados dos visitantes são seguros?

Os dados trafegam por TLS, ficam isolados por workspace e a infraestrutura roda em nuvem (AWS). Credenciais de integração e chaves de LLM são armazenadas cifradas e nunca retornam em respostas da API. Cada agente pode ainda mascarar PII (CPF, CNPJ, telefone, e-mail, cartões) nas respostas.

A plataforma atende a LGPD?

A plataforma oferece os controles necessários: consentimento explícito antes de qualquer coleta (bloqueia IP, user-agent e fingerprint até o visitante consentir), retenção configurável com anonimização depois do prazo, mascaramento de PII e isolamento por workspace.

Quem pode embutir o meu agente?

Apenas os domínios listados em Origens permitidas. Com a lista vazia, qualquer site pode — o que também significa consumir os seus créditos. Em produção, preencha a lista.

Ainda tem dúvidas?

• E-mail: suporte@takesales.ai
• Chat: Widget no canto inferior direito do site
• Documentação: Explore as outras seções ou veja a solução de problemas