Perguntas Frequentes
Encontre respostas para perguntas comuns sobre nossa plataforma, recursos e serviços.
Primeiros Passos
Você pode se cadastrar usando Google, Microsoft ou e-mail (link mágico sem senha). Nenhuma senha é necessária — basta escolher seu método de login preferido e seguir as instruções.
Comece criando sua organização, depois envie documentos para sua biblioteca de conteúdo, crie um agente de IA, teste-o no Playground e implante-o nos seus canais de mensagens preferidos.
Não. O plano Trial oferece acesso completo aos recursos com créditos limitados para testes — sem necessidade de cartão de crédito.
A contagem regressiva do seu período de teste é exibida na página de Faturamento. Você pode fazer upgrade para um plano pago a qualquer momento para continuar usando a plataforma com limites mais altos.
Use a Saba, nossa assistente de IA integrada — use Cmd+K (Mac) ou Ctrl+K (Windows/Linux) para abrir, ou clique no ícone flutuante no canto inferior direito. Você também pode visitar nossa documentação em docs.cuneiform.chat ou enviar um e-mail para [email protected].
Conta e Organização
Após fazer login, clique em "Criar Organização" e preencha o nome da organização (obrigatório), setor e tamanho da empresa. Opcionalmente, você pode adicionar uma descrição e detalhes de contato de suporte.
Nome da organização (obrigatório), setor (obrigatório) e tamanho da empresa (obrigatório). Opcionalmente: descrição e detalhes de contato de suporte (e-mail, telefone, site, endereço) — os agentes compartilham esses dados quando os usuários precisam de ajuda humana.
Atualmente, cada usuário pode criar e gerenciar uma organização. Entre em contato com nossa equipe de suporte se você precisar de múltiplas organizações para uso empresarial.
Sim. Abra o Gerenciamento de Conta no menu do seu perfil para atualizar o nome, descrição, setor, tamanho da empresa, idioma de resposta padrão e detalhes de contato de suporte da sua organização a qualquer momento.
Quando os usuários pedem assistência humana ao seu agente de IA, o agente compartilha seus detalhes de contato de suporte (e-mail, telefone, site) para que eles possam entrar em contato com sua equipe diretamente.
Gerenciamento de Equipe
Vá para a página de Equipe e clique em "Convidar Membro". Digite o endereço de e-mail e atribua uma função (Admin ou Membro). Eles receberão um e-mail de convite para entrar na sua organização.
Admins têm acesso completo a todos os recursos, incluindo gerenciamento de equipe, configurações da organização e faturamento. Membros podem visualizar agentes, conteúdo e análises, mas não podem modificar configurações, gerenciar membros da equipe ou acessar o faturamento.
O tamanho da equipe depende do seu plano. O Trial tem vagas limitadas, Starter e Plus suportam múltiplas vagas, e Enterprise oferece membros de equipe ilimitados.
Sim. Admins podem atualizar a função de qualquer membro da equipe na página de Equipe.
Criando e Configurando Agentes
Vá para Agentes e clique em "Criar Agente". Preencha o nome do agente (máximo 100 caracteres), descrição opcional, configure sua persona, defina as configurações de LLM e escolha o acesso ao conhecimento. Seu progresso é salvo automaticamente como rascunho.
Uma persona é um prompt de sistema que define a personalidade, comportamento e limites do seu agente. Você pode escrever uma manualmente ou usar o botão Gerar para abrir o Construtor de Persona com IA, que guia você por cinco categorias de características.
Uma ferramenta com IA com cinco categorias de características: Papel e Identidade, Estilo de Comunicação, Comportamento de Resposta, Limites Operacionais e Integração de Conhecimento. Configure cada categoria e depois gere sua persona. Você pode salvá-la como um preset reutilizável para sua organização.
Proteções de segurança obrigatórias aplicadas a todos os agentes. Elas impedem a fabricação de fatos, exigem que o agente diga "Não sei" quando a informação não está disponível, bloqueiam a personificação de profissionais, corrigem premissas falsas e recusam conteúdo prejudicial. As Regras da Plataforma não podem ser desativadas.
Teste: Playground habilitado, integrações desabilitadas (padrão para novos agentes). Ativo: Playground e integrações habilitados. Inativo: Tudo desabilitado temporariamente. Arquivado: Oculto da lista principal, tudo desabilitado.
Sim. Ative o modo Avançado na seção de Configuração de LLM para escolher um modelo específico e ajustar a temperatura (0.0-1.0). O modo Padrão usa as configurações do plano da sua organização. Para perguntas e respostas factuais, recomenda-se uma temperatura de 0.3-0.5.
Quando habilitado, seu agente inclui referências de documentos fonte em suas respostas. Isso é útil para casos de uso jurídico, conformidade ou compartilhamento de conhecimento onde os usuários precisam saber de onde vem a informação.
Depende do seu plano. O Trial oferece um número limitado, Starter e Plus suportam múltiplos agentes, e Enterprise fornece agentes ilimitados. Verifique a página de Agentes para seu limite atual.
Sim. O Cuneiform Chat suporta 24 idiomas incluindo árabe, francês, alemão, espanhol, turco, chinês, japonês, entre outros. Defina um idioma de resposta padrão no nível da organização em Configurações, ou substitua por agente. O agente responde no idioma configurado enquanto suas regras de precisão e segurança permanecem em inglês.
Conteúdo
Formatos suportados incluem PDF (baseado em texto e digitalizado), Word (DOCX, DOC), Texto Simples (TXT), Markdown (MD), Rich Text (RTF), PowerPoint (PPTX, PPT), HTML, JSON e XML. Imagens, áudio, vídeo, arquivos compactados e executáveis não são suportados.
Na página de Conteúdo, arraste e solte arquivos ou clique na área de upload para navegar. Você também pode importar do Google Drive, Dropbox, OneDrive ou Box, ou mudar para a aba Site para rastrear sites públicos. Você pode atribuir tags antes do envio, e o envio em lote é suportado.
A maioria dos documentos é concluída em poucos minutos. Arquivos maiores ou mais complexos podem levar mais tempo. Você pode acompanhar o progresso na página de Conteúdo — cada documento mostra seu status de processamento atual.
Enviando: O arquivo está sendo enviado. Na Fila: Aguardando processamento. Processando: Sendo analisado e indexado. Pronto: Disponível para uso pelos agentes. Tentando Novamente: O processamento está sendo repetido. Falhou: Ocorreu um erro — você pode tentar reprocessar pelo menu do documento.
Pastas fornecem organização hierárquica — cada documento pertence a uma pasta. Tags permitem categorização transversal — cada documento pode ter tags ilimitadas. Use pastas para categorias amplas (departamentos, projetos) e tags para tópicos ou temas.
Sim, através do Controle de Acesso ao Conhecimento. Modo Excluir (padrão) dá ao agente acesso a todos os documentos exceto os que você selecionar. Modo Incluir restringe o agente apenas às pastas, tags ou documentos individuais que você selecionar. As alterações entram em vigor imediatamente.
Exclua a versão antiga e envie o arquivo atualizado. O sistema detecta conteúdo duplicado automaticamente. Você também pode reprocessar um documento existente pelo menu se o arquivo original não foi alterado.
Clique no menu do documento e selecione "Reprocessar". Se continuar falhando, verifique se o formato do arquivo é suportado, se o arquivo não está corrompido e se está dentro dos limites de tamanho. PDFs digitalizados podem ter extração de menor qualidade devido a limitações de OCR.
Sim. Mude para a aba Site na página de Conteúdo, insira uma URL e clique em Rastrear. O rastreador visita páginas até 2 níveis de profundidade e extrai conteúdo como Markdown. Você pode revisar e editar cada página antes de processá-la na sua biblioteca de conteúdo.
O número máximo de páginas por rastreamento depende do seu plano. Você pode rastrear um site por vez. Apenas páginas acessíveis publicamente são suportadas — conteúdo protegido por login não pode ser rastreado.
Armazenamento em Nuvem
Google Drive, Dropbox, OneDrive e Box. Cada provedor tem um seletor de arquivos dedicado acessível pela página de Conteúdo.
Na página de Conteúdo, clique no ícone do seu provedor, faça login para autorizar acesso de leitura e selecione os arquivos que deseja importar. Os arquivos selecionados são copiados para sua biblioteca de conteúdo automaticamente.
Não. As importações de nuvem são cópias únicas. Se o arquivo original mudar no seu armazenamento em nuvem, você precisará reimportá-lo para atualizar o conteúdo na sua biblioteca.
Não. Solicitamos apenas acesso de leitura aos arquivos que você seleciona explicitamente. Seus arquivos originais na nuvem permanecem inalterados. Você pode revogar o acesso a qualquer momento pelas configurações do seu provedor de nuvem.
Sim. Arquivos do Google Workspace (Docs, Slides, Sheets) são automaticamente convertidos em texto durante a importação. Note que formatação, imagens e gráficos não são preservados — apenas o conteúdo de texto é extraído.
Testes e Playground
Clique em "Testar" no card do agente ou no botão "Testar Agente" durante a edição. O Playground abre como um painel lateral onde você pode conversar com seu agente usando seu conteúdo real. Novos agentes começam no status de Teste com o Playground habilitado.
Teste a precisão de perguntas e respostas básicas com seus documentos, casos extremos (tópicos sem resposta, perguntas ambíguas), conversas com várias trocas, mudanças de tópico e consistência de tom. Avalie cada resposta quanto à precisão, relevância, completude e comprimento adequado.
Não. O Playground só está disponível para agentes com status de Teste ou Ativo. Altere o status do seu agente para Teste para reativar o acesso ao Playground.
Seu agente está pronto quando responde perguntas comuns com precisão, lida com casos extremos de forma elegante, mantém o tom adequado, respeita os limites definidos e conversas com várias trocas fluem naturalmente. Então altere seu status para Ativo para habilitar integrações de canais.
Integrações de Canais
Telegram, Discord, Slack, WhatsApp, Google Chat, Meta (Facebook Messenger) e seu próprio site via widget de chat incorporável. Todos os canais estão disponíveis em todos os planos. Telegram, Slack e Google Chat têm cada um sua própria categoria dedicada de perguntas frequentes abaixo.
Sim. Implante um único agente em múltiplos canais simultaneamente. Ele usa o mesmo conteúdo, fornece respostas consistentes, e todas as conversas são rastreadas em análises unificadas com histórico centralizado.
Pelo menos um agente criado, documentos enviados para sua biblioteca de conteúdo e o agente testado no Playground. Cada canal também tem requisitos específicos — por exemplo, Telegram precisa de um token do BotFather, Discord precisa de credenciais do app e Google Chat requer um domínio verificado.
Crie um aplicativo no Portal de Desenvolvedores do Discord, adicione um bot, obtenha as credenciais (ID do Aplicativo, Chave Pública, Token do Bot). Insira esses dados na aba de Integrações do seu agente, configure a URL do webhook e adicione o bot ao seu servidor.
Vá para a aba de Integrações do seu agente e selecione WhatsApp. Use o fluxo de cadastro incorporado para conectar sua Conta Comercial do WhatsApp, verifique seu número de celular via SMS ou chamada de voz e configure a Verificação em Duas Etapas com um PIN. As mensagens estão sujeitas à janela de mensagens de 24 horas do WhatsApp.
Vá para a aba de Integrações do seu agente e selecione Meta. Clique em Conectar com Facebook, autorize sua Página do Facebook e conceda as permissões necessárias. Seu agente responderá com indicadores de digitação e dividirá automaticamente mensagens longas (limite de 2.000 caracteres por mensagem). Nota: um agente por Página, e apenas Messenger (não comentários da Página).
Vá para a página de Integrações e encontre a seção Widget de Site. Clique em "Criar Widget" para configurar a aparência do seu widget, selecione o agente que responderá e opcionalmente restrinja quais domínios podem incorporá-lo. Uma vez criado, copie o código de incorporação (uma única tag script) e cole no HTML do seu site antes da tag de fechamento '<'/body'>'.
Sim. As integrações de canais só são habilitadas quando o status do agente é Ativo. Agentes com status de Teste, Inativo ou Arquivado não podem receber mensagens de canais externos. O widget de site também requer que o agente atribuído esteja Ativo.
Cada canal tem um guia passo a passo na nossa documentação em docs.cuneiform.chat/integrations, incluindo capturas de tela, dicas de solução de problemas e melhores práticas de segurança.
Telegram
Crie um bot via @BotFather no Telegram para obter um token. Depois vá para a aba de Integrações do seu agente, selecione Telegram, cole o token e conecte. Você pode personalizar o nome, descrição e avatar do bot pelo BotFather. Uma vez conectado, o bot começa a responder mensagens diretas imediatamente.
Respostas ao vivo em streaming que chegam em milissegundos e crescem no lugar enquanto o agente pensa, notas de voz transcritas automaticamente com detecção automática de idioma, formatação markdown rica (negrito, itálico, código, listas, links), reações por emoji classificadas como feedback positivo/negativo/neutro, e comandos de barra /start, /help, /reset, /new instantâneos tratados sem custo de IA.
Sim. As notas de voz são transcritas com precisão de qualidade de estúdio e o idioma é detectado automaticamente a partir da conversa, então clipes curtos em qualquer idioma permanecem precisos. Disponível em todos os planos, incluindo o trial gratuito.
Cada link t.me/seu-bot?start=seu-código pode carregar uma mensagem de boas-vindas personalizada e até três respostas sugeridas. Cliques, usuários únicos e conversões de conversa são rastreados por código, então você pode executar campanhas diferentes a partir do mesmo bot e medir cada uma.
Um catálogo multipágina dentro do app que abre dentro do Telegram quando os clientes tocam no botão do menu de chat ao lado do compositor de mensagens — sem redirecionamento para site, sem troca de app, sem dança de autenticação. Cada bot do Telegram que você conecta vem com uma Loja. O botão do menu de chat é conectado automaticamente, então não é necessária configuração no BotFather.
12 tipos de bloco — cards de produto, galerias, vídeos, páginas temáticas, depoimentos, cards de contato, FAQs e mais. Seis temas, compositor de arrastar e soltar com preview ao vivo. As páginas são organizadas em um menu que os clientes podem navegar dentro da Mini App.
Sim. Anexe documentos da base de conhecimento a um bloco de produto e os clientes podem tocar e perguntar "vem no tamanho M?" com respostas restritas apenas aos documentos daquele produto. A superfície de chat é integrada à página do produto na Mini App.
Sim. Cada bloco de produto pode carregar uma CTA de pedido no modo consulta ou carrinho com campos de formulário configuráveis. Os pedidos chegam à sua caixa de entrada como um handoff estruturado e o cliente recebe uma mensagem direta instantânea "recebemos seu pedido" do bot.
Sim — incluindo o trial gratuito. O botão do menu de chat é conectado automaticamente no momento em que você conecta um bot do Telegram, e uma Central de Ajuda integrada fica fixada ao final do menu de páginas para FAQs ad-hoc, mesmo antes de você publicar qualquer página de produto.
Telegram Business é um recurso do Telegram Premium que permite a um bot responder mensagens diretas a partir da conta pessoal de um usuário. Fundadores, criadores e equipes pequenas que recebem mensagens diretas em seu Telegram pessoal o dia todo podem ter um agente respondendo na voz deles — o mesmo agente, a mesma memória que seus clientes conhecem. Disponível em todos os planos pagos, incluindo o trial gratuito.
No celular do usuário Premium: abra Ajustes → Telegram Business → ChatBots e cole o link do seu bot. Depois envie uma mensagem direta /start seu-código para vincular a conta. O bot responde mensagens diretas em seu nome até você responder manualmente — uma vez que você responde, o bot pausa naquele chat e só retoma depois que a conversa esfria. Um interruptor de desligamento no nível da conexão no painel de administração desativa a resposta automática em toda a conta Premium.
Um bot do Telegram dedicado para administradores, separado do seu bot voltado para o cliente. Vincule sua conta de administrador com um código de uso único, depois envie mensagens diretas para o Saba para respostas rápidas em texto, ou abra a Mini App no Telegram para uma superfície de chat mais rica — lista de conversas, detalhes de chamadas de ferramenta, entrada de voz, exportação em markdown. As respostas do Saba vêm com botões tocáveis que pulam direto para a página correta do painel, então uma pergunta vira ação em um toque.
Slack
Vá para a aba de Integrações do seu agente e clique em Conectar para Slack. Complete o fluxo OAuth para autorizar seu workspace — sem configuração de webhook, sem arquivos de setup. Uma vez autorizado, o bot está pronto para responder em segundos.
Sim. Quando você marca o bot com @ em um thread de canal, ele lê todo o histórico da conversa antes de responder. Sem copiar e colar contexto — o bot já sabe o que a equipe discutiu.
Sim. Cada canal pode ser atribuído ao seu próprio agente de IA. Vendas fica com o especialista em produto, Suporte fica com o solucionador de problemas — um aplicativo do Slack, vários especialistas. Use /set-agent dentro de um canal para atribuir um.
/ask para perguntas rápidas, /help para ver o que está disponível, /set-agent para atribuir um agente ao canal atual, /current-agent para inspecionar a atribuição e /reset-agent para reverter. Controle total sem sair do Slack.
Sim. O bot responde em canais, threads, mensagens diretas e mensagens diretas em grupo — onde quer que sua equipe trabalhe. Mesmo agente, mesma memória, em cada superfície do Slack.
Não. O OAuth cuida de tudo — sem URL de webhook, sem segredos de assinatura, sem variáveis de ambiente para gerenciar. A configuração é um único clique a partir da aba de Integrações do seu agente.
Google Chat
Instale-o a partir do Google Workspace Marketplace como qualquer outro aplicativo do Workspace — implantação padrão de administrador, sem webhooks personalizados, sem código. A página de configuração da integração no seu painel de administração linka diretamente para o item no Marketplace.
A verificação de domínio comprova que você é proprietário do domínio da sua organização. É uma configuração única — adicione o registro DNS TXT fornecido durante a integração às configurações de DNS do seu domínio. Uma vez verificado, apenas membros do seu domínio verificado podem interagir com seu bot.
A maioria dos provedores propaga em algumas horas, mas o Google permite até 48 horas. Uma vez que o registro TXT é verificado, ele se aplica a todas as futuras integrações do Google Chat para sua organização — você só faz isso uma vez por domínio.
Um gerente de Espaço executa /connect uma vez no Espaço. Depois disso, o bot ganha acesso completo ao histórico de conversa daquele Espaço e lê o que a equipe discutiu antes de responder — sem repetir contexto.
Sim. Espaços diferentes podem ser atribuídos a agentes de IA diferentes — RH fica com o especialista em políticas, TI fica com o solucionador de problemas, Vendas fica com o especialista em produto. Use /set-agent dentro de um Espaço para atribuir um.
/help para ver o que está disponível, /connect para autorizar acesso ao histórico do thread em um Espaço, /set-agent para atribuir um agente, /current-agent para inspecionar a atribuição e /reset-agent para reverter. Controle total sem sair do Espaço.
Não. A verificação de domínio garante que apenas membros do seu domínio verificado possam acessar seu bot — isolamento de nível empresarial, sem acesso externo não autorizado.
Análises e Monitoramento
O painel mostra total de consultas, conversas, usuários únicos e créditos usados. Inclui gráficos de volume de consultas ao longo do tempo, distribuições por canal e agente, e rankings dos seus principais agentes e canais por uso.
Sim. Filtre por agente específico, canal (Telegram, Discord, Slack, WhatsApp, Google Chat, Meta, Widget, Playground) e período de tempo. Principais agentes e canais são classificados por consultas, conversas e créditos consumidos.
Ciclo de faturamento atual, últimos 7 dias, últimos 14 dias, últimos 30 dias ou últimos 90 dias. Os dados podem ser agrupados por hora, dia, semana ou mês.
Identifique quais agentes lidam com mais consultas, encontre períodos de alto volume, revise transcrições de conversas para identificar lacunas no seu conteúdo e use insights com IA para entender intenções dos usuários e tópicos comuns.
Sim. A seção de Conversas mostra sessões de chat individuais com histórico completo de mensagens, timestamps, canal, agente, créditos gastos e uso de tokens. Você pode gerar insights com IA (pontos-chave, intenções do usuário, ações sugeridas) e exportar conversas como JSON.
Faturamento, Planos e Créditos
Trial (gratuito, créditos limitados, sem cartão de crédito), Starter (recursos essenciais, créditos padrão), Plus (créditos generosos, suporte prioritário, múltiplas vagas) e Enterprise (créditos personalizados, agentes e vagas ilimitados, suporte dedicado). Todos os planos incluem todas as integrações de canais, widget de site e análises completas.
Créditos da Plataforma são consumidos por consultas de IA (quando os agentes respondem), processamento de documentos (quando arquivos são enviados e indexados) e geração de embeddings. Sua alocação mensal depende do seu plano e é renovada a cada período de faturamento.
Sim. Upgrades entram em vigor imediatamente com cobranças proporcionais. Downgrades são agendados para o final do seu período de faturamento atual. Uma vez agendado um downgrade, nenhuma outra alteração de plano pode ser feita até o início do novo período de faturamento. Verifique se seu uso atual se encaixa nos limites do novo plano antes de fazer downgrade.
Você verá um aviso em aproximadamente 80% de uso. Em 100%, um banner de "Limite Atingido" aparece. O serviço é pausado até seu próximo período de faturamento, a menos que você habilite o Uso Extra ou faça upgrade do seu plano.
Uma opção de pagamento por uso para planos pagos (Starter, Plus, Enterprise) que permite continuar usando a plataforma após sua cota mensal ser esgotada. Habilite-o na página de Faturamento com uma recarga mínima de $10 e defina um limite de gasto entre $10-$500 por mês.
Não. Sua alocação mensal de créditos é renovada no início de cada período de faturamento. O saldo de Uso Extra, no entanto, é mantido entre os períodos.
Vá para Faturamento e clique em "Cancelar Assinatura". O acesso continua até o final do seu período de faturamento atual. Seus agentes deixarão de responder após isso, mas os documentos são mantidos por tempo limitado para que você possa reativar depois.
Vá para Faturamento e procure na seção de Histórico. Você pode visualizar ou baixar faturas em PDF mostrando o período de faturamento, cobranças do plano, cobranças adicionais e status do pagamento.
Assistente da Plataforma (Saba)
Saba é nossa assistente de IA integrada à plataforma, nomeada em homenagem a Nisaba — a deusa suméria da escrita e das artes escribais. Saba ajuda você a navegar na plataforma, responde perguntas sobre recursos e pode acessar os dados da sua organização para fornecer informações específicas sobre seus agentes, documentos e uso.
Clique no ícone flutuante da Saba no canto inferior direito, ou use Cmd+K (Mac) / Ctrl+K (Windows/Linux). Pressione Cmd+N / Ctrl+N para iniciar uma nova conversa, e Escape para fechar.
Orientação sobre recursos da plataforma, dados da sua organização (contagem de agentes, lista de documentos, status de integrações, informações de faturamento) e fluxos de trabalho passo a passo. Use comandos rápidos como /agents, /usage, /docs, /help, /new e /conversations para acesso rápido a tarefas comuns.
Sim. O modo Rápido dá respostas rápidas para perguntas simples. O modo Raciocínio fornece análises mais completas para tópicos complexos. Alterne entre eles no painel da Saba — sua preferência é salva entre sessões.
Sim. Clique no ícone de Globo no cabeçalho da Saba para escolher entre 24 idiomas suportados. A Saba usa por padrão o idioma configurado da sua organização (definido nas Configurações da Organização), mas você pode substituir em cada sessão. Sua seleção é salva no navegador e lembrada entre sessões.
Segurança e Privacidade
Sim. Todos os dados são criptografados em trânsito via HTTPS. Usamos isolamento estrito entre organizações (os dados de cada organização são completamente separados), controle de acesso baseado em funções e armazenamento criptografado de credenciais. Seus documentos e conversas nunca são compartilhados com terceiros ou usados para treinar modelos de IA.
Modelos da OpenAI, Anthropic e Google Gemini. Os modelos disponíveis dependem do seu plano. Você pode escolher o modelo que melhor se adapta ao seu caso de uso, orçamento e requisitos de desempenho na configuração avançada de LLM de cada agente.
Sim. Implante agentes em sete canais de mensagens (Telegram, Discord, Slack, WhatsApp, Google Chat, Meta e Widget de Site). Importe documentos de quatro provedores de armazenamento em nuvem (Google Drive, Dropbox, OneDrive, Box). Clientes Enterprise podem acessar suporte adicional de integração.
Seus agentes param de responder, mas documentos e dados de conversas são mantidos por tempo limitado. Se você reativar sua assinatura, seus dados existentes ficam disponíveis novamente. Entre em contato com o suporte para perguntas específicas sobre retenção de dados.
Ainda precisa de ajuda?
Não encontrou a resposta que procura? Experimente perguntar à Saba (Cmd+K / Ctrl+K) para ajuda instantânea, navegue pela nossa documentação ou entre em contato com nossa equipe de suporte.