Captain

Comece com o Captain AI

Captain é a IA da Chatwoot. Ele pode responder clientes para você, ajudar seus agentes a escrever respostas e aprender com seus artigos de ajuda e conversas passadas. O que o Captain pode fazer Capacidade O que faz Quem usa Página Assistente Responde para clientes nas caixas de entrada que você conectar e transfere para sua equipe quando não pode ajudar Clientes Configurar um assistente Captain e conectar suas caixas de entrada Conhecimento Aprende com páginas de sites, PDFs e FAQs que você adicionar Administradores Adicionar documentos ao conhecimento do Captain Parâmetros, diretrizes e cenários Controla o que o assistente responde, como ele se comunica e o que faz em situações específicas Administradores Configurar parâmetros, diretrizes e cenários do Captain Público e agenda Limita para quais clientes o assistente responde e quando Administradores Controlar para quem e quando o Captain responde Ferramentas personalizadas Permite que o assistente consulte informações nos seus próprios sistemas, como status de pedido Administradores Configurar ferramentas personalizadas para o Captain Copiloto Ajuda agentes a resumir, redigir respostas e buscar informações enquanto trabalham Agentes Trabalhe mais rápido com o Captain Copilot Memórias Salva detalhes importantes do cliente como notas de contato para a próxima vez Assistente Usar as Memórias do Captain Ajuda de IA no editor e caixa de entrada Reformula, resume e sugere resposta no editor, transcrição de áudio, e Sugerir com Captain para etiquetas e prioridade da conversa Agentes; administradores ativam Condições do Captain em automações Uma regra de automação pode pedir ao Captain para avaliar se uma conversa corresponde a uma descrição que você escrever, por exemplo "cliente deseja cancelar" Administradores Plano & acesso Plano Captain Hacker (grátis) Não incluído Startups Incluído, com créditos mensais de IA Business Incluído, com mais créditos mensais de IA. Adiciona ferramentas personalizadas Enterprise Incluído, com a maior quantidade de créditos mensais de IA - As quantidades de créditos por plano e o preço para recarregar estão em Planos e preços > Créditos de IA Captain. Como os créditos são utilizados está em Créditos e uso do Captain AI. - Função: apenas administradores podem criar ou alterar assistentes, documentos, FAQs e ferramentas. Agentes podem visualizar assistentes, testá-los no Playground, revisar sugestões de FAQ e usar o Copilot. - Auto-hospedado: o Captain está incluído nos planos Premium e Enterprise auto-hospedados, com sua própria chave OpenAI. Veja Habilitar Captain no auto-hospedado. - Teste gratuito: Captain não está disponível durante o teste gratuito. Como verificar se você possui Procure por Captain na barra lateral à esquerda. Se você clicar e ver Atualize para usar Captain AI, sua conta está no plano Hacker. Um administrador pode atualizar em Faturamento. Configurar & testar A ordem usual: 1. Configure um assistente Captain e conecte suas caixas de entrada, depois teste no Playground. 2. Adicione documentos ao conhecimento do Captain para que ele entenda seu produto. 3. Opcional: Controle para quem e quando o Captain responde, Defina parâmetros, diretrizes e cenários do Captain, Configure ferramentas personalizadas para o Captain. Administradores de auto-hospedado começam por Habilitar Captain em auto-hospedado. Obtenha valor - Mantenha o conhecimento atualizado: revise as sugestões de FAQ toda semana. Veja Adicionar FAQs e revisar sugestões de FAQ no Captain - Observe o Resumo do assistente para Cobertura de conhecimento e quantas conversas ele atendeu. - Encaminhe manualmente uma conversa para o assistente: selecione-o no menu de responsável da conversa. Veja Configurar um assistente Captain e conectar suas caixas de entrada - Verifique o uso de créditos em Faturamento. Veja Créditos e uso do Captain AI. O que muda em outros recursos quando o Captain está ativo - Chat ao vivo no site: a mensagem "estamos ausentes" não aparece enquanto o assistente está respondendo. - Continuar conversas por e-mail: a solicitação de e-mail não aparece, a menos que o assistente transfira o atendimento. - Saudação da caixa de entrada: a mensagem de saudação da caixa de entrada não é enviada enquanto o assistente está atendendo a conversa. Se o assistente responder para todos (público definido como Todos), clientes em suas caixas de entrada não verão a saudação. - A Lição 5 em "Comece aqui" percorre todo o fluxo com o Captain. Veja Lição 5: ações de IA. Solução de problemas Se o Captain não estiver respondendo, dando respostas erradas ou não estiver aprendendo, vá para Solucionar problemas com o Captain.

Configure um assistente Captain e conecte suas caixas de entrada

Descubra Um assistente responde aos clientes nas caixas de entrada que você conecta e repassa a conversa para sua equipe quando não puder ajudar. Plano & acesso: Startups, Business ou Enterprise Preços & Planos. Administradores criam, editam e excluem assistentes. Agentes podem visualizá-los e usar o Playground. Cada caixa de entrada pode ter um assistente. Configurar & testar Antes de começar - Pelo menos uma caixa de entrada para conectar (chat ao vivo, WhatsApp, Instagram, e-mail e outras). - Algum conhecimento para adicionar logo em seguida: páginas do site, PDFs ou FAQs. Sem conhecimento, o assistente tem pouco com o que responder. - Créditos Captain: cada resposta do assistente a um cliente usa créditos. 1. Crie o assistente 1. Vá em Captain > Assistentes. 2. Inicie um novo assistente: - Nenhum assistente ainda: clique em Criar um novo assistente na página vazia. - Você já tem um assistente: abra o seletor de assistentes ao lado do nome do assistente e clique em Criar Assistente. 3. Preencha: Nome, Descrição e Nome do Produto são obrigatórios. A descrição pode ter até 500 caracteres. - Nome: um nome interno, por exemplo "Assistente de Suporte". - Descrição: para que serve o assistente. Escreva um propósito, não instruções. - Nome do Produto: o produto que ele atende. Ele usa isso ao falar sobre seu produto. O Captain só responde perguntas sobre o produto que você nomear aqui, então use o nome da sua marca ou produto, não um recurso específico. 4. Escolha recursos (todos começam desligados): - Gerar FAQs a partir de conversas resolvidas: Captain sugere novas FAQs a partir de conversas resolvidas. Veja Adicionar FAQs e revisar sugestões de FAQ no Captain. - Capturar detalhes importantes como memórias das interações com clientes. Veja Como usar as Memórias do Captain. - Incluir citações das fontes nas respostas: a resposta mostra qual documento foi usado. 5. Clique em Criar. - Se este for seu primeiro assistente, o Chatwoot abrirá suas FAQs. - Se você usou o seletor, o Chatwoot permanece no assistente que estava visualizando. Selecione o novo assistente no seletor antes do próximo passo. 2. Conecte uma caixa de entrada 1. Selecione o novo assistente no seletor de assistentes e vá para Caixas de entrada. 2. Clique em Conectar uma nova caixa de entrada, escolha a caixa e confirme. Até que uma caixa de entrada seja conectada, a Visão geral do assistente mostra: "Este assistente ainda não está conectado a nenhuma caixa de entrada, então não responderá a conversas." 3. Defina o que ele diz e quando encerra Abra as Configurações do assistente. - Configurações básicas: ative Permitir acesso às informações de contato se o assistente deve usar os dados do contato ao responder. - Configurações de sistema: - Mensagem de repasse: o que o assistente diz ao repassar a conversa para sua equipe. - Quando os clientes param de responder: escolha a Ação quando o cliente para de responder e quanto tempo esperar (5 minutos a 24 horas; padrão de 60 minutos). - Deixe o Captain decidir (recomendado): o Captain decide se resolve ou repassa. Esse é o padrão. - Sempre resolver: o Captain resolve toda conversa após o tempo de espera. - Esperar pelo cliente: o Captain nunca resolve por conta própria. Mas ainda pode repassar se o cliente pedir. - Enviar uma mensagem ao resolver (ativado por padrão) envia a Mensagem de Resolução antes do Captain resolver. Teste 1. Abra o assistente e acesse o Playground. 2. Faça as perguntas que seus clientes mais costumam fazer. Verifique se as respostas são precisas, curtas e no seu tom de voz. 3. Pergunte algo que ele não deveria saber. Verifique se ele informa que não pode ajudar e oferece conectar você à sua equipe. Ele fará o repasse quando você aceitar. 4. A resposta pode levar alguns segundos para aparecer; você pode deixar a página aberta enquanto ele processa. 5. Depois, envie uma mensagem real para a caixa de entrada conectada, por exemplo pelo widget do site, e veja a resposta chegar. As mensagens do Playground usam créditos, assim como as respostas aos clientes. Teste alterações antes de salvar No Playground, abra Testar configuração para experimentar mudanças sem alterar o assistente. As mudanças aplicam-se somente a esta sessão do Playground, a menos que você as salve. - Conhecimento: cole o texto em Texto de referência para testar uma resposta antes de virar um documento. Clique em Adicionar documento permanentemente para mantê-lo. - Cenários, Diretrizes e Guardrails: adicione um item temporário com Adicionar ao teste (↵), ou use Incluir neste teste para ativar ou desativar itens salvos para este teste. Clique em Adicionar cenário permanentemente, Adicionar diretriz permanentemente ou Adicionar guardrail permanentemente para fixar um. - Em cada resposta, Detalhes da execução mostra os cenários e regras usadas, chamadas de ferramentas e repasses. - Redefinir configuração de teste limpa tudo que for temporário. Obtenha valor - Adicione conhecimento em seguida: Adicione documentos ao conhecimento do Captain. - Decida para quem e quando ele responde: Controle para quem e quando o Captain responde. - Ajuste as respostas dele: Defina guardrails, diretrizes e cenários do Captain. - Verifique a Visão geral do assistente para conversas tratadas, Cobertura do conhecimento e um Resumo do Captain. - Repasse uma conversa para o assistente manualmente: no dropdown de atribuição da conversa, escolha o assistente (apenas o assistente conectado àquela caixa aparece). A conversa vai para pendente e o assistente assume, mesmo se as regras de audiência ou agendamento a ignorariam. Para voltar, atribua a uma pessoa. - Use o seletor de assistentes (Alternar entre assistentes) se você gerencia vários, por exemplo um por marca ou idioma. - O assistente lê as mensagens públicas anteriores da conversa, incluindo as enviadas antes de ser conectado. Nunca vê notas privadas. - Para ver como o assistente está indo, use a Visão geral. Veja Visão geral e relatórios do Captain. Solução de problemas Sintoma Provável causa O que fazer O assistente nunca responde Nenhuma caixa conectada Conecte uma em Caixas de entrada Não é possível conectar uma caixa A caixa já tem um assistente Desconecte-a do outro assistente antes Respostas vagas ou erradas Pouco ou nenhum conhecimento Adicione documentos e FAQs, depois teste novamente no Playground Não aparece Criar um novo assistente ou Criar Assistente Você não é administrador Peça a um administrador Mais causas, incluindo causas “silenciosas”: Solucione problemas do Captain.

Adicione documentos ao conhecimento do Captain

Descubra Documentos ensinam seu assistente sobre o seu produto. Adicione páginas de sites ou arquivos PDF, e o Captain os lê, responde a partir deles e cria perguntas frequentes com base nesses documentos. Plano & acesso: Startups, Business ou Enterprise Preços & Planos. Administradores podem adicionar, atualizar e excluir documentos. Todo plano pago inclui até 2.000 documentos. O limite é compartilhado entre todos os assistentes da conta, e cada PDF ou página web rastreada conta como um documento. Configure & experimente Antes de começar - Um assistente. Veja Como criar um assistente Captain e conectar suas caixas de entrada. - Páginas de sites devem ser públicas. O Captain não consegue ler páginas protegidas por login. - PDFs devem ter até 10MB e conter texto real (imagens digitalizadas podem não ser legíveis). - Se seu site bloqueia rastreadores no robots.txt, permita o Chatwoot primeiro (veja abaixo). Adicione um site ou PDF 1. Acesse Captain > Documentos. 2. Clique em Criar novo documento. 3. Escolha o Tipo de Documento: - URL: insira o endereço da página. O Captain lê essa página e as páginas vinculadas sob o mesmo caminho. Por exemplo, https://example.com/help cobre todas as páginas que começam com esse endereço. - Arquivo PDF: clique em Selecionar arquivo PDF e escolha o arquivo. 4. Opcional: adicione um Nome do Documento (Opcional). 5. Escolha o assistente e clique em Criar. O Captain lê e indexa o conteúdo. As páginas encontradas durante o rastreamento são adicionadas como documentos separados. Permita que o Chatwoot rastreie seu site O Chatwoot usa o Firecrawl para ler sites e segue o seu robots.txt. Se algumas páginas estiverem bloqueadas, adicione isso a https://seudominio.com/robots.txt: User-agent: FirecrawlAgent Allow: / Verifique se o arquivo está ativo nesse endereço, depois adicione ou atualize o documento. Se o seu robots.txt bloquear o rastreador ao adicionar um site, nenhuma página será adicionada e nenhum erro será exibido. O assistente então dará respostas incompletas ou genéricas. Teste 1. Abra o menu do documento e escolha Ver detalhes. 2. Verifique se Conteúdo rastreado (ou Detalhes do PDF) mostra seu texto, e FAQs relacionadas lista perguntas relevantes. 3. Faça uma pergunta dessa página no Playground do assistente. Obtenha valor - Mantenha os documentos atualizados: use Atualizar agora em um documento, ou selecione vários e clique em Atualizar. A lista mostra quando cada um foi atualizado pela última vez. - Documentos de site também são atualizados automaticamente: mensalmente no Startups (dia 1), semanalmente no Business (aos domingos) e diariamente no Enterprise. O processamento pode demorar, então a página pode não ser atualizada exatamente nesse horário. PDFs enviados não são atualizados automaticamente. - Um rastreamento de site adiciona até 500 páginas, e nunca mais que o seu limite restante de documentos. - Prefira fontes focadas, como seu centro de ajuda, em vez de todo o site de marketing. - Usado em conversas mostra quais conversas utilizaram um documento. - Excluir um documento remove tudo que o Captain aprendeu dele. - Artigos do Centro de Ajuda não são lidos automaticamente. Para utilizá-los, adicione o endereço do seu Centro de Ajuda como documento URL. Cada versão de idioma de um artigo é uma página separada, então cada uma conta como um documento. - FAQs criadas a partir de um documento ficam disponíveis imediatamente. Elas aparecem em FAQs e não precisam de aprovação. - As FAQs geradas pelo Captain são sempre no idioma da sua conta. O assistente ainda responde no idioma do cliente. - O Captain não remove informações pessoais ou confidenciais do que você adicionar. Adicione apenas conteúdo que você aceite que seja citado pelo assistente aos clientes. Solução de problemas Sintoma Causa provável O que fazer Status mostra Falha ao sincronizar com Acesso negado A página exige login, ou seu site bloqueou a solicitação (erro 401 ou 403). Torne a página pública, ou permita a solicitação em seu site. Site adicionado mas nenhuma página aparece, ou respostas genéricas Seu robots.txt pode estar bloqueando o rastreador. Permita conforme em Permita que o Chatwoot rastreie seu site , depois adicione o documento novamente. Página não encontrada URL está errada ou a página foi movida Corrija a URL e adicione novamente Página demorou muito para responder Seu site estava lento Use Tentar novamente atualizar mais tarde Página retornou conteúdo vazio Conteúdo carrega apenas com scripts, ou a página está vazia Use uma página com texto simples, ou envie um PDF atualização parada Uma atualização não foi concluída Use Tentar novamente atualizar Detalhes do PDF dizem que não foi possível extrair conteúdo legível PDF digitalizado ou apenas imagem Envie um PDF com texto Banner: Limite de documentos atingido A conta tem 2.000 documentos entre todos os assistentes Exclua documentos que não precisa mais, ou veja Preços & Planos Mais causas: Solução de problemas do Captain.

Adicione perguntas frequentes e revise as sugestões de perguntas frequentes no Captain

Descubra As Perguntas Frequentes (FAQs) são pares de perguntas e respostas que seu assistente usa para responder. Você pode escrevê-las você mesmo, e o Captain sugere novas a partir dos seus documentos e das perguntas que os clientes fazem com frequência. Plano & acesso: Startups, Business ou Enterprise Preços & Planos. Administradores escrevem e editam FAQs. Qualquer pessoa pode revisar sugestões de FAQs; agentes veem apenas sugestões das conversas às quais têm acesso. Configure e experimente Antes de começar - Um assistente com alguns documentos. Veja Adicione documentos ao conhecimento do Captain. - Para sugestões a partir de conversas, ative Gerar FAQs a partir de conversas resolvidas no assistente. Veja Configure um assistente Captain e conecte suas caixas de entrada Escreva uma FAQ 1. Vá para Captain > FAQs. 2. Clique em Criar nova FAQ. 3. Digite a pergunta e a resposta, escolha o assistente e clique em Criar. Revise sugestões de FAQ O Captain agrupa perguntas recorrentes de clientes em sugestões e as classifica pela demanda dos clientes. As sugestões são escritas no idioma da sua conta. Sugestões vêm apenas de conversas resolvidas onde um agente respondeu. Conversas tratadas apenas pelo Captain não geram sugestões. 1. Vá para Captain > FAQs e clique em Revisar sugestões (ou abra Sugestões de FAQ). 2. Abra uma sugestão. Conversas de origem mostra as conversas de onde ela veio. 3. Edite a pergunta ou resposta se necessário e clique em Salvar alterações. 4. Clique em Aprovar para adicionar ao conhecimento do Captain ou Descartar para ignorar. As FAQs que o Captain gera a partir de um documento ficam listadas em FAQs relacionadas desse documento. FAQs criadas a partir dos seus documentos entram no ar imediatamente e não precisam de aprovação. Teste Faça a pergunta aprovada no Playground do assistente e verifique se ele usa sua resposta. Obtenha valor - Revise as sugestões semanalmente. Elas vêm de perguntas reais de clientes, então preenchem as lacunas mais importantes. - Mantenha as respostas curtas e específicas. Uma pergunta por FAQ. - O Visão geral do assistente mostra a Cobertura do conhecimento: FAQs aprovadas em relação às sugestões aguardando revisão. Um banner aparece quando há sugestões prontas. - Busque com Buscar FAQs... e selecione várias para excluir de uma vez só. Solucione problemas Sintoma Causa provável O que fazer Nenhuma sugestão aparece Gerar FAQs a partir de conversas resolvidas está desligado, ou poucas conversas foram resolvidas. Ou nenhum agente respondeu nas conversas resolvidas. Sugestões precisam de ao menos uma resposta de agente. Ative no assistente e aguarde O assistente ainda fornece a resposta antiga A FAQ é uma sugestão, não está aprovada Aprove Não é possível criar ou editar uma FAQ Você não é um administrador Peça a um administrador, ou aprove sugestões Um agente vê menos sugestões do que um admin Agentes veem apenas sugestões de conversas que podem acessar Esperado Nenhuma conversa de origem acessível encontrada. As conversas estão em caixas de entrada que você não pode ver, ou foram excluídas Peça a um administrador com acesso para revisar Mais causas: Solução de problemas do Captain.

Defina os limites, diretrizes e cenários do Capitão

Descubra Três conjuntos de regras moldam seu assistente: Guardrails decidem quais perguntas ele responde, Diretrizes de Resposta decidem como serão as respostas, e Cenários instruem o que fazer em situações específicas. Plano & acesso: Startups, Business ou Enterprise Preços & Planos. Administradores os editam. Eles fazem parte de toda conta Captain, em todo plano pago. Conjunto de regras Use para Exemplo Guardrails Manter o assistente no assunto e longe de perguntas proibidas "Não dê conselhos legais ou médicos." Diretrizes de Resposta Tom, comprimento e estrutura das respostas "Mantenha as respostas abaixo de três frases. Seja amigável, não formal." Cenários Passo-a-passo de como lidar com uma situação, podendo usar ferramenta personalizada "Quando um cliente pedir reembolso, peça o número do pedido, confira usando a ferramenta de busca de pedidos, depois repasse." Configure e teste Antes de começar - Um assistente. Veja Como configurar um assistente Captain e conectar suas caixas de entrada. - Para cenários que usam seus sistemas, uma ferramenta personalizada. Veja Como configurar ferramentas personalizadas para o Captain. Adicione guardrails e diretrizes de resposta 1. Vá em Captain, abra o assistente e acesse Configurações. 2. Abra Guardrails ou Diretrizes de resposta. 3. Clique em Adicionar guardrail ou Adicionar diretriz de resposta, escreva a regra em uma frase curta, e clique em Criar. 4. Para adicionar regras a partir dos exemplos, digite no campo abaixo dos exemplos e clique em Adicionar e salvar (↵), ou pressione Enter. 5. Para alterar uma regra, clique no ícone de lápis, edite o texto e pressione Enter. Adicione um cenário 1. Vá em Captain, abra o assistente e acesse Cenários. 2. Clique em Adicionar cenário e preencha: - Título: um nome curto, por exemplo "Solicitação de reembolso". - Descrição: quando esse cenário se aplica. - Como lidar: o que o assistente deve fazer, em passos simples. Para usar uma ferramenta em um passo, digite @ e escolha na lista, por exemplo Repasse para Humano ou uma das suas ferramentas personalizadas. Se o cenário deve terminar com sua equipe, adicione o repasse como último passo. 3. Clique em Criar. 4. Para alterar um cenário, abra-o, edite os campos e clique em Atualizar alterações. Teste No Playground, faça uma pergunta que cada regra deveria interceptar (por exemplo, uma pergunta fora do tópico e uma solicitação de reembolso). Verifique se a resposta segue a regra. Ganhe valor - Comece com poucas regras: três a cinco guardrails e diretrizes. Adicione mais conforme identificar problemas reais nas conversas. - Escreva as regras como instruções para um novo membro da equipe, não como palavras-chave. - Guardrails são instruções para a IA, não um filtro. Eles reduzem bastante as respostas fora do tema, mas não podem eliminá-las totalmente, então mantenha a mensagem de repasse clara. - Se uma ferramenta usada em um cenário for desativada, aquele cenário pode parar de funcionar. O Chatwoot avisa antes de desabilitá-la. Solucione problemas Sintoma Causa provável O que fazer Assistente ignora uma regra A regra é vaga ou conflita com outra Reescreva em uma frase clara; remova conflitos Cenário nunca executa A descrição da situação não coincide com a forma como os clientes perguntam Descreva a situação com as palavras do cliente Cenário para no meio Ferramenta personalizada está desativada ou com falha Verifique a ferramenta em Ferramentas Sem item Cenários no assistente Conta está no Hacker (grátis), ou, em self-hosted, Captain não ativado na conta Faça upgrade, ou peça ao Super Admin para ativar Mais causas: Soluções de problemas do Captain.

Controle para quem e quando o Capitão responde

Descubra Você pode escolher para quais clientes o assistente responde (Público) e quando (Agenda). Conversas que o assistente não atender permanecem Abertas para sua equipe. Público e Agenda pertencem ao assistente, então se aplicam a todas as caixas de entrada às quais ele está conectado. Plano & acesso: Startups, Business ou Enterprise : Preços & Planos. Administradores alteram essas configurações. Configurar & testar Antes de começar - Um assistente conectado a uma caixa de entrada. Veja Configurar um assistente Captain e conectar suas caixas de entrada. - Para definir uma agenda, o horário comercial ativado para essa caixa de entrada, nas configurações da própria caixa de entrada. Veja Horário comercial e resposta automática. - Para regras de público com seus próprios dados, os atributos personalizados de contato que deseja usar. Veja Entendendo os contatos. Escolher o público 1. Vá em Captain > Assistentes, abra o assistente e vá para Configurações > Público. 2. Escolha: - Todos: o assistente responde em toda conversa nas caixas de entrada dele. Este é o padrão. - Público específico: o assistente responde apenas para clientes que atendem suas condições. 3. Para um público específico, adicione condições. Cada uma possui um atributo, um operador e um valor. - Atributos de contato: Nome, E-mail, Telefone, Identificador, País, Cidade, Empresa, Criado em, Última atividade, Bloqueado, Rótulos. - Atributos da conversa: Usuário autenticado, Idioma do navegador. O idioma do navegador vem apenas do widget no site, então não funciona para WhatsApp, Telegram, SMS ou outros canais. Rótulos se refere aos rótulos de contato, não de conversa. Usuário autenticado significa que o visitante foi verificado com validação de identidade (HMAC) no seu widget do site. - Seus atributos personalizados de contato. - Os operadores disponíveis dependem do atributo. Por exemplo, Nome oferece apenas igual e diferente, E-mail também oferece contém (use para direcionar um domínio como @acme.com), e datas oferecem maior que, menor que e dias antes. 4. Escolha se os clientes devem atender a todas as condições ou a qualquer uma delas. Você pode agrupar condições, por exemplo "Plano é Pro E (País é EUA OU País é Canadá)". Você pode aninhar grupos em um nível: um grupo pode conter subgrupos, mas um subgrupo não pode conter outro grupo. 5. Salve. Escolher a agenda 1. Nas mesmas Configurações, abra Agenda. 2. Escolha A qualquer momento (padrão), Durante o horário comercial ou Fora do horário comercial. 3. Salve. Ambas as regras devem ser atendidas: o assistente só responde quando o cliente está no público e está dentro do horário definido. Teste 1. Inicie uma nova conversa como um cliente que corresponda, dentro do horário definido. O assistente responde. 2. Inicie uma como um cliente que não corresponda. Vai para sua equipe sem resposta do assistente. Obtenha valor - Configurações comuns: assistente somente fora do horário comercial; assistente apenas para usuários autenticados no site; assistente para todos, exceto clientes com rótulo "VIP". - As regras são verificadas quando uma conversa começa ou uma resolvida é reaberta, não a cada mensagem. Uma vez que o assistente está numa conversa, ele permanece até que a conversa seja resolvida ou transferida. Alterações se aplicam apenas para novas conversas e reabertas. - A correspondência de texto ignora maiúsculas/minúsculas. Números de telefone correspondem com ou sem o + inicial. Um atributo de marcação que nunca foi definido conta como desmarcado. - A agenda segue o horário comercial e o fuso horário da caixa de entrada. Se o fuso estiver errado, o assistente pode ficar fora do ar na maior parte do dia dos seus clientes, sem aviso. - Essas regras decidem quando o assistente entra sozinho. Um agente ainda pode transferir qualquer conversa para o assistente pelo menu de responsável, ignorando público e agenda. Veja Configurar um assistente Captain e conectar suas caixas de entrada. Solucionar problemas Sintoma Provável causa O que fazer O assistente responde para alguém excluído Os detalhes do contato mudaram após o início da conversa Esperado. A regra se aplica na próxima conversa nova ou reaberta. Abra o contato e verifique seus atributos na barra lateral. O Captain verifica os valores do contato no início da conversa. O assistente está numa conversa que deveria pular Um agente atribuiu a conversa ao assistente Esperado. Atribuição manual ignora público e agenda Agenda não faz efeito Horário comercial está desligado para essa caixa. Caixas sem horário contam como sempre ativo Ative o horário comercial nas configurações da caixa de entrada Seu atributo não está na lista É um atributo personalizado da conversa. Apenas atributos personalizados de contato funcionam Use um atributo de contato. Crie nas Configurações › Atributos personalizados e escolha Contato . Não é possível salvar o público Uma condição está sem valor (destacada em vermelho), ou Público específico está sem condições Complete ou remova a condição. Está presente e Não está presente (somente atributos de data) não precisam de valor. Assistente está em silêncio para todos Público ou agenda exclui todos Verifique ambas configurações, depois Solucionar Captain

Configurar ferramentas personalizadas para o Capitão

Descubra Ferramentas personalizadas permitem que o assistente acesse seus próprios sistemas durante uma conversa, por exemplo para verificar um pedido, uma garantia ou uma reserva, em vez de transferir o atendimento. Plano & acesso: Business ou Enterprise (Pricing & Plans). No Startups, Ferramentas normalmente exibe Faça upgrade para usar ferramentas com o Captain. Cada assistente tem sua própria lista de ferramentas. Administradores criam ferramentas, e somente administradores podem ver as credenciais salvas. Na versão self-hosted: o Super Admin ativa Ferramentas Personalizadas para a conta. Configure & teste Antes de começar - Um endpoint HTTPS em um hostname público. O Chatwoot bloqueia HTTP simples, endereços IP, localhost, redes privadas e endereços .local. - O endpoint deve aceitar a conexão em até 2 segundos e responder em até 20 segundos, com uma resposta de 1 MB ou menos. - Suas credenciais, se for necessário. Crie uma ferramenta 1. Vá em Captain > Ferramentas e clique em Criar nova ferramenta. Primeiro use o seletor de assistente no topo para escolher para qual assistente a ferramenta é. O formulário será aberto em um painel lateral. 2. Preencha: - Nome da Ferramenta: curto, por exemplo "Consulta de Pedido" (até 55 caracteres). - Descrição: quando o assistente deve usá-la, escrita como um briefing para um novo agente. Isso decide se o assistente escolhe ou não a ferramenta. - Método: GET para ler dados; POST, PUT ou PATCH para enviar ou alterar dados; DELETE para remover algo. - URL do Endpoint: use {{ parameter_name }} para valores que o assistente irá preencher, por exemplo https://api.example.com/orders/``{{ order_id }}. - Tipo de Autenticação: Nenhum, Bearer Token, Basic Auth, ou API Key (com Header Name e Header Value). Use isso para credenciais. - Cabeçalhos: clique em Adicionar Header para cabeçalhos fixos que sua API exige em todas as chamadas, como uma versão da API ou ID do tenant (até 16). Os valores são enviados exatamente como digitados. O Chatwoot define Authorization, Host, Content-Length, Content-Type e qualquer cabeçalho começando com X-Chatwoot automaticamente, então você não pode adicionar estes. - Parâmetros: clique em Adicionar Parâmetro para cada valor que o assistente deve obter do cliente. Dê um nome, tipo, descrição, e marque Obrigatório se necessário. - Template do Corpo da Solicitação (Opcional): para POST, PUT ou PATCH. Este e o template de resposta ficam em Templates. O template de solicitação é um corpo JSON. Suporta Liquid, por exemplo {{ order_id }} para um parâmetro. - Template da Resposta (Opcional): destaque os campos que o assistente precisa, por exemplo Pedido {{ response.order_id }} status: {{ response.status }}. Leia a resposta da API via response, por exemplo {{ response.status }}. Deixe o template em branco para enviar ao Captain o JSON bruto. 3. Clique em Testar conexão e depois em Criar. Testar conexão funciona apenas para endpoints sem templates ou corpo de requisição. Para outros, teste no Playground. Um resultado verde significa que seu endpoint retornou status 2xx: está acessível e aceitou as credenciais. Teste Faça uma pergunta no Playground que precise da ferramenta, por exemplo "Onde está o pedido 1234?". Verifique se a resposta utiliza dados reais. Ganhe valor - Ferramentas personalizadas funcionam melhor para consultas com entradas claras, como status de pedido, uma reserva ou um registro por ID. - Cada assistente pode ter até 50 ferramentas. Mesmo assim, mantenha a lista curta: com muitas ferramentas, o assistente tem mais chance de escolher a errada. - Adicionar, editar, desativar ou excluir uma ferramenta altera apenas para o assistente que você está visualizando. Ferramentas que já existiam antes de serem individualizadas foram copiadas para todos os assistentes, então confira cada um. - Rodando vários assistentes? Dê a cada só as ferramentas que precisa. - Desative uma ferramenta pela chave seletora em vez de excluir. Se um cenário a usar, o Chatwoot avisa primeiro. Veja Defina as regras de proteção, diretrizes e cenários do Captain. - O Chatwoot envia cabeçalhos em cada chamada para seu sistema saber a conta, conversa, e-mail do contato e telefone, assistente, e se o contato está verificado. Para dados privados, confira o cabeçalho X-Chatwoot-Contact-Inbox-Verified antes de responder. Sem validação de identidade, um visitante pode digitar qualquer e-mail no widget. Ferramentas que retornam só dados públicos não precisam dessa verificação. Veja Como habilitar validação de identidade no Chatwoot?. - Se sua API retorna textos escritos por clientes, retorne apenas os campos estruturados que você precisa. O Captain lê a resposta como está, então textos livres podem conter instruções que ele pode seguir. Solução de problemas Sintoma Causa provável O que fazer Falha na conexão Endpoint inacessível, não é HTTPS ou credenciais erradas Verifique a URL e credenciais; garanta que é HTTPS público Falha na conexão com 401 As credenciais estão erradas Verifique o Tipo de Autenticação e as credenciais Falha na conexão com 403 Sua API rejeitou a solicitação Requisições de teste não enviam os cabeçalhos de contato, então endpoints que precisam deles falham no teste. Teste no Playground Falha na conexão com 404 Caminho da URL errado Verifique o caminho da URL Falha na conexão por timeout Sua API demorou mais de 20 segundos para responder ou 2 segundos para conectar Acelere o endpoint URL rejeitada Endereço IP, localhost ou endereço privado Use um hostname público Um cabeçalho foi rejeitado É um cabeçalho que o Chatwoot já define, duplicado, ou seu valor tem placeholders Remova-o, ou mova credenciais para Tipo de Autenticação Ferramenta ausente em outro assistente Ferramentas são exclusivas de um assistente Troque para aquele assistente e crie a ferramenta lá Não é possível adicionar outra ferramenta O assistente já tem 50 ferramentas Exclua ferramentas que não são usadas Assistente nunca usa a ferramenta Descrição vaga Reescreva a Descrição dizendo exatamente quando usá-la Assistente usa a ferramenta errada Muitas ferramentas ou descrições parecidas Remova ou desative ferramentas; torne descrições distintas Resposta lenta ou não respondida, depois transfere Endpoint demorou mais de 20 segundos ou retornou mais de 1 MB Acelere o endpoint; reduza a resposta com um Template de Resposta Mais causas: Solucione problemas do Captain.

Trabalhe mais rápido com o Captain Copilot

Descubra Copilot é um assistente de IA para agentes, dentro de cada conversa. Peça para resumir, rascunhar uma resposta, revisar o tom, traduzir ou pesquisar algo. Plano e acesso: Startups, Business ou Enterprise Preços & Planos. Qualquer agente pode usar, em qualquer caixa de entrada. Não há necessidade de ativar por caixa de entrada. Cada solicitação ao Copilot utiliza créditos Captain. Configurar & testar Antes de começar - Pelo menos um assistente Captain. O Copilot usa o conhecimento de um assistente ao pesquisar informações. O Copilot também pesquisa artigos da sua central de ajuda se você tiver permissão para gerenciar a base de conhecimento. O assistente não precisa estar conectado a uma caixa de entrada. Para IA que auxilia agentes, mas nunca responde aos clientes, crie um assistente e não conecte a nenhuma caixa de entrada. Veja Configurar um assistente Captain e conectar suas caixas de entrada. Usar o Copilot 1. Abra uma conversa. 2. À direita, abra a aba Copilot. 3. Escolha um inicial em Experimente estes prompts (Resumir esta conversa, Sugerir uma resposta, Avaliar esta conversa), ou digite seu próprio pedido. Fora de uma conversa, Copilot oferece Conversas de alta prioridade e Listar contatos. 4. Se você tiver vários assistentes, use Selecionar Assistente para escolher de qual conhecimento usar. 5. Quando o Copilot rascunhar uma resposta que você goste, clique em Usar esta para colocá-la na caixa de resposta. Edite, então envie. 6. Clique em Redefinir para recomeçar. Teste Abra uma conversa real, escolha Sugerir uma resposta e verifique se o rascunho utiliza seu conhecimento sobre o produto. Obtenha valor - Seja específico: "Escreva uma resposta educada explicando o atraso e oferecendo entrega na sexta-feira" funciona melhor do que "responda". - Sempre leia o rascunho antes de enviar. O Copilot sugere; o agente decide. - Use Mostrar etapas para ver como o Copilot chegou a uma resposta. - Sugerir uma resposta no Copilot usa toda a configuração do assistente selecionado: sua descrição, diretrizes de resposta, proteções e FAQs. Sugerir uma resposta no editor de respostas utiliza apenas FAQs (do assistente conectado à caixa de entrada, ou todas as FAQs aprovadas na conta), não diretrizes ou tom. - Ações do editor como reformular e resumir são recursos de IA separados. - Para obter etiquetas sugeridas ou prioridade para uma conversa, use Sugerir com Captain na barra lateral da conversa. Solução de problemas Sintoma Causa provável O que fazer Guia Copilot não aparece Conta está no Hacker (gratuito), ou Captain não está ativado Veja Primeiros passos com Captain AI "Você ficou sem créditos do Copilot. Você pode comprar mais créditos na seção de faturamento." Sem créditos disponíveis Compre créditos em Faturamento , ou aguarde a renovação "Houve um erro ao gerar a resposta. Por favor, tente novamente." Erro temporário Tente novamente Respostas ignoram seus documentos Assistente errado selecionado, ou sem documentos Use Selecionar Assistente ; adicione documentos Mais causas: Solução de problemas Captain.

Use o Capitão Memórias

Descobrir Com as memórias ativadas, o assistente salva detalhes importantes de uma conversa como notas no contato, para que sua equipe, e o Copilot, tenham contexto na próxima vez. O assistente não lê essas notas ao responder aos clientes. Plano & acesso: Startups, Business ou Enterprise (Preços & Planos). Um administrador ativa por assistente. Configurar & testar Antes de começar - Um assistente. Veja Como configurar um assistente Captain e conectar suas caixas de entrada. Ativar as memórias 1. Vá para Captain > Assistentes, abra o assistente e vá para Configurações. 2. Ative Capturar detalhes importantes como memórias das interações com o cliente. 3. Salve. O que é salvo Detalhes que ajudam na próxima vez, como: - Preferências e os produtos ou plano que o cliente utiliza. - Perguntas ou problemas recorrentes. - Necessidades especiais, como uma integração da qual dependem. - Contexto como o tamanho da equipe. Teste Tenha uma conversa onde você mencione uma preferência, por exemplo "Usamos o plano Pro e preferimos email", e resolva. Depois, abra o contato e verifique as Notas. Obtenha valor - As memórias aparecem nas Notas do contato com "Bot" como autor e o horário em que foram salvas. Os agentes as veem na barra lateral da conversa. - As memórias são salvas quando uma conversa em uma caixa de entrada conectada é resolvida, seja pelo assistente ou por um agente, desde que a conta possua créditos. - Os agentes podem excluir uma memória, mas não podem editá-la. - Informe aos clientes o que você armazena, conforme sua política de privacidade. Solução de problemas Sintoma Causa provável O que fazer Nenhuma nota aparece O botão está desligado, a conversa ainda não foi resolvida, ou nada relevante apareceu Verifique a configuração; resolva a conversa As memórias pararam Os créditos acabaram Veja Créditos Captain AI e uso Notas aparecem apenas para alguns contatos Somente conversas resolvidas em caixas conectadas ao assistente criam memórias Esperado Mais causas: Solucionar problemas Captain.

Créditos e uso do Captain AI

Descubra O Captain utiliza créditos de IA. Todos os planos pagos incluem créditos gratuitos todo mês, e você pode comprar mais. Plano & acesso: Startups, Business ou Enterprise. Quantos créditos cada plano inclui, e o preço para adicionar mais, estão em Preços & Planos > Créditos Captain AI. Administradores veem o uso e compram créditos em Faturamento. Configure & experimente O que usa créditos Cada um destes itens utiliza um crédito: - Uma resposta do assistente para um cliente. - Uma mensagem no Playground do assistente. - Uma solicitação ao Copilot. - Uma ação do editor, como reformular, resumir ou sugerir resposta. - Uma transcrição de áudio. Adicionar documentos, aprovar FAQs, sugestões de rótulo e prioridade do Sugira com Captain, e condições do Captain em regras de automação não utilizam créditos. Veja seu uso 1. Vá em Configurações > Faturamento. 2. A seção Captain mostra Créditos e Documentos usados. Clique em Atualizar para atualizar. Compre mais créditos 1. Em Faturamento > Captain, clique em Comprar mais créditos. 2. Escolha um pacote e clique em Comprar Créditos, depois confirme. Seu cartão salvo é cobrado imediatamente. Créditos comprados: - São adicionados imediatamente e usados depois dos créditos do seu plano mensal. - Expiram após 6 meses. - Precisam de uma assinatura ativa para serem usados. - Não são reembolsáveis. Teste Após a compra, verifique o novo saldo em Faturamento > Captain. Aproveite ao máximo - Créditos mensais são renovados na data de renovação do seu plano. Comprar créditos ou mudar de plano não reinicia o uso. - Créditos mensais não utilizados não acumulam para o mês seguinte. Se você usar mais do que seus créditos mensais, o extra será descontado dos créditos comprados. - Ao mudar de plano, seu saldo aumenta ou diminui pela diferença entre os créditos mensais dos dois planos. Seu uso permanece igual. - Alterar o número de assentos não reinicia o uso. - Para fazer seus créditos durarem: conecte o assistente apenas às caixas de entrada onde ele realmente ajuda, use as regras de público e agendamento (Controle para quem e quando o Captain responde), e desative funcionalidades de IA que você não usa, como transcrição. - Um alerta avisa quando você já usou mais de 80% dos seus créditos. Não há alerta por e-mail, e os créditos não são recarregados automaticamente. - O uso é um total único para a conta. Não é dividido por agente, assistente ou funcionalidade. Para ver como cada assistente está indo, use sua Visão geral (Visão geral e relatórios do Captain). Solução de problemas Sintoma Causa provável O que fazer Novas conversas vão direto para a equipe sem resposta do assistente Créditos acabaram Compre créditos ou aguarde a renovação Assistente diz "Transferindo para outro agente para mais assistência." no meio da conversa Créditos acabaram durante a conversa Compre créditos ou aguarde a renovação O Copilot diz que você está sem créditos do Copilot Créditos acabaram Compre créditos ou aguarde a renovação O uso não voltou para 0 após a compra Esperado. O uso só é reiniciado na renovação; a compra adiciona ao saldo Nenhuma ação necessária Créditos são usados mais rápido do que o esperado O assistente está em caixas de entrada movimentadas ou IA usada demais Reduza o público ou agendamento; desative recursos que não precisa Não é possível comprar créditos Você não é administrador ou não há uma assinatura ativa Peça para um administrador; confira a assinatura Mais causas: Solução de problemas do Captain.

Ativar o Captain em hospedagem própria

Descobrir Você pode rodar o Captain na sua própria instalação do Chatwoot com sua própria chave da OpenAI. Plano e acesso: incluído nos planos Premium e Enterprise auto-hospedados. Veja Enterprise Edition. Você precisa de acesso ao console de Super Admin. A edição Community não inclui o Captain. Premium e Enterprise têm os mesmos recursos e configurações do Captain. Configurar e testar Antes de começar - Uma chave de API da OpenAI. - Opcional: um endpoint compatível com OpenAI, caso você hospede seu próprio modelo. - Opcional: uma chave de API da Firecrawl para uma melhor varredura de sites. Sem ela, o Chatwoot usa um rastreador incorporado mais simples. 1. Configure o Captain para a instalação 1. Abra o console de Super Admin e vá para Configurações. 2. No cartão do Captain, clique no ícone de configurações (engrenagem). 3. Preencha: - Chave de API da OpenAI. - Modelo OpenAI define o modelo para Copilot e recursos do editor. Deixe em branco para usar gpt-4.1-mini. O assistente usa gpt-5.2 por padrão. Para alterar, vá em Super Admin › Contas, edite a conta e abra a guia Modelos do Captain. Se você usar um endpoint personalizado, certifique-se de que ele sirva os modelos escolhidos aqui. - Endpoint da API OpenAI (opcional), para um modelo auto-hospedado compatível. - Modelo de Embedding (opcional). - Chave de API FireCrawl (opcional). 4. Clique em Enviar. 2. Ative o Captain em uma conta Contas criadas enquanto sua instalação está no Premium ou Enterprise já vêm com o Captain ativado. Para contas criadas antes disso: 1. No console de Super Admin, vá para Contas. 2. Abra a conta e clique em Editar. 3. Nos recursos premium, ative o Captain. Guardrails, diretrizes de resposta e cenários já vêm inclusos. Para ferramentas personalizadas, ative também Ferramentas Personalizadas (Configure ferramentas personalizadas para o Captain). 4. Salve. Teste Faça login nessa conta. O Captain aparecerá na barra lateral. Crie um assistente e envie uma mensagem no Playground. Veja Configure um assistente Captain e conecte suas caixas de entrada. Obtenha valor - A OpenAI cobra pelo uso na sua própria chave. O Chatwoot não conta créditos do Captain em instalações auto-hospedadas. - Atualizando de uma versão antiga, onde assistentes usavam o campo Instruções? Instruções não são mais usadas. Transfira-as para guardrails e diretrizes de resposta antes de atualizar (Configure guardrails, diretrizes e cenários do Captain). - Todo o resto funciona igual ao Cloud. Continue em Adicionar documentos ao conhecimento do Captain. Solução de problemas Sintoma Possível causa O que fazer Captain não aparece na barra lateral Não está ativado para a conta, ou não está em uma licença Premium ou Enterprise Verifique ambos os passos; cheque sua licença Sem ferramentas Ferramentas Personalizadas desativadas para a conta Ative-as em Super Admin > Contas Assistente não responde Chave da OpenAI inválida/inativa, ou nome de modelo não suportado Verifique a chave. Verifique se o endpoint serve o modelo do assistente ( gpt-5.2 por padrão, ou o definido na guia Modelos do Captain da conta). Documentos do site faltando páginas Sem chave Firecrawl, então o rastreador simples foi usado Adicione uma chave de API FireCrawl Falha na sincronização de documentos do site Chave de API Firecrawl inválida Verifique se a chave Firecrawl está válida. Se uma chave estiver definida, o Chatwoot sempre usa a Firecrawl, então uma chave inválida faz os documentos do site falharem. Remova a chave para usar o rastreador embutido. Continua com erro Um erro no servidor Verifique os logs do web e worker

Capitão de Suporte Técnico

Descobrir Use esta página quando o Captain estiver silencioso, der respostas erradas ou não estiver aprendendo. A maioria dos problemas vem de uma configuração, não de uma falha. Plano & acesso: O Captain precisa dos planos Startups, Business ou Enterprise Preços & Planos . A maioria das correções exige um administrador. Configurar & testar: verificação rápida Quando o assistente está silencioso, verifique o seguinte na ordem: 1. Plano: Captain aparece na barra lateral? Se você vê Atualize para usar o Captain AI, a conta está no Hacker (gratuito). O Captain não está disponível durante o teste gratuito. 2. Créditos: Configurações > Faturamento > Captain. Sem créditos disponíveis, o Captain não funciona. 3. Caixa de entrada: a caixa de entrada está listada em Caixas de entrada do assistente? 4. Público: está definido para Público específico e o cliente corresponde? 5. Horário: está em Durante o horário comercial ou Fora do horário comercial e o horário confere? 6. Momento: as regras são verificadas quando uma conversa começa ou é reaberta. Uma conversa em andamento mantém sua primeira decisão. 7. Status: O Captain responde somente quando a conversa está Pendente. Se estiver Aberta, o Captain permanece em silêncio. Isso ocorre quando um agente respondeu, o assistente transferiu, ou uma automação atribuiu a conversa a alguém. O Captain não retorna para uma conversa aberta, a menos que seja reatribuída ao assistente. Teste Inicie uma nova conversa, como um cliente que corresponde ao público, dentro do horário estabelecido, em uma caixa de entrada conectada. Obtenha valor: silêncio versus falha - Silencioso: nenhuma resposta normalmente significa que uma das verificações acima parou o Captain antes de iniciar. - Silencioso em determinados horários do dia: o horário segue o horário comercial da caixa de entrada e seu fuso horário. Verifique o fuso horário nas configurações da caixa de entrada. - Transferido: quando o Captain não pode responder, ele envia sua Mensagem de transferência e passa a conversa para sua equipe. - Sem créditos: uma nova conversa vai direto para sua equipe sem resposta. Em uma conversa que o Captain já está atendendo, ele envia "Transferindo para outro agente para mais assistência." e faz a transferência. Solução de problemas Respostas Sintoma Causa provável O que fazer O assistente nunca responde Uma das verificações rápidas Siga as verificações rápidas acima Responde para pessoas que você excluiu Os dados delas mudaram após a conversa começar Esperado; se aplica a partir da próxima conversa. Veja Controle para quem e quando o Captain responde Responde fora do horário Horário comercial está desativado na caixa de entrada Ative o horário comercial nas configurações da caixa de entrada Respostas erradas ou inventadas Conhecimento ausente ou desatualizado Adicione ou atualize documentos; aprove sugestões de FAQ. Use Reportar mensagem do Captain na resposta para informar o Chatwoot do erro Assistente está numa conversa que público ou horário deveriam pular Um agente atribuiu ao assistente pelo menu Esperado. Atribua a conversa a uma pessoa para retomar Responde perguntas fora do contexto Sem guardrails Adicione guardrails. Veja Defina guardrails, diretrizes e cenários do Captain Transfere com muita frequência Falta de conhecimento, ou ferramenta personalizada falhando Reveja as sugestões de FAQ; verifique Ferramentas Conversas são resolvidas muito cedo Sempre resolver está ativado com tempo de espera curto Escolha Deixar o Captain revisar (recomendado) ou aumente o tempo de espera Conhecimento Sintoma Causa provável O que fazer Documento mostra Falha ao sincronizar A página requer login ou seu site bloqueou o pedido (erro 401 ou 403). A página também pode estar ausente ou lenta. Veja Adicionar documentos ao conhecimento do Captain Site adicionado mas nenhuma página aparece, ou respostas genéricas Seu robots.txt pode estar bloqueando o crawler. Permita o crawler em seu robots.txt, então adicione o documento novamente. Veja Adicionar documentos ao conhecimento do Captain Sem sugestões de FAQ Gerar FAQs de conversas resolvidas está desativado. Ou nenhum agente respondeu nas conversas resolvidas. Sugestões precisam de ao menos uma resposta de agente. Ative-o. Veja Adicionar FAQs e revisar sugestões de FAQ no Captain Limite de documentos atingido A conta tem 2.000 documentos em todos os assistentes Exclua documentos não usados; veja Preços & Planos Ferramentas, Copilot e créditos Sintoma Causa provável O que fazer Ferramenta personalizada nunca usada Descrição vaga ou muitas ferramentas Veja Configurar ferramentas personalizadas para Captain Mensagem de erro do Copilot Erro temporário ou sem créditos Tente novamente; verifique os créditos Créditos usados rapidamente Caixas de entrada movimentadas ou muitos recursos de IA utilizados Veja Créditos e uso do Captain AI Quando entrar em contato com o suporte Entre em contato com o suporte caso todas as verificações rápidas estejam corretas e o Captain ainda esteja silencioso em uma nova conversa. Envie: - Seu ID de conta (Configurações > Configurações da conta). - O nome do assistente e a caixa de entrada. - Um link para uma conversa afetada e o horário em que ocorreu. - Se o assistente respondeu no Playground.

Visão geral e relatórios do Capitão

Voltar para Comece a usar o Captain AI. Descobrir Cada assistente tem uma Visão geral que mostra como ele está se saindo: quantas conversas ele atendeu, quantas resolveu sozinho, por que transferiu e como os clientes o avaliaram. Plano & acesso: Startups, Business ou Enterprise Preços e Planos. Qualquer pessoa que possa abrir o Captain vê a Visão Geral. Somente administradores podem clicar em um número para ver as conversas por trás dele. Configuração e teste Antes de começar - Um assistente conectado a uma caixa de entrada que já atendeu algumas conversas. Veja Configurar um assistente Captain e conectar suas caixas de entrada. Até que uma caixa de entrada seja conectada, a Visão Geral mostra "Este assistente ainda não está conectado a nenhuma caixa de entrada, então não responderá a conversas." Abrir a Visão Geral 1. Vá para Captain e escolha o assistente no seletor de assistentes. 2. Abra Visão geral. 3. Escolha o período no topo: um número de dias, Esta semana, Semana passada, Este mês ou Mês passado. O padrão é Este mês. O que cada número significa Número O que significa Conversas atendidas Conversas em que o Captain respondeu ao cliente ou transferiu a conversa para sua equipe Taxa de auto-resolução A porcentagem de conversas atendidas que o Captain resolveu sem ajuda da sua equipe. Quanto maior, melhor Taxa de transferência A porcentagem de conversas atendidas que o Captain passou para sua equipe Taxa de reabertura A porcentagem de conversas resolvidas pelo Captain que os clientes retornaram depois. Quanto menor, melhor Resoluções do Captain permaneceram fechadas A porcentagem de conversas resolvidas pelo Captain que continuam fechadas sete dias depois. Apenas resoluções de pelo menos sete dias são contadas Tempo médio de resolução O tempo típico desde que uma conversa chegou ao Captain até ser resolvida Mensagens por conversa O número médio de respostas que o Captain enviou em cada conversa que atendeu Economia de esforço e tempo do agente Uma estimativa, baseada em dois minutos salvos para cada resposta pública do Captain Os outros cards - Resumo do Captain: um breve resumo escrito de como o assistente está se saindo. Aparece quando há atividade suficiente. - O fluxograma: como as conversas atendidas se dividem em Resolvido pelo Captain, Transferido e Fechado com equipe, e quantas resoluções do Captain foram Reabertas em 7d ou Permaneceram fechadas. - Motivos de transferência: por que o Captain passou conversas para sua equipe: Solicitação do cliente, Conhecimento ausente, Solicitação não suportada, Restrição de política, Falha de ferramenta, Esclarecimento pendente do cliente, Limite de uso ou Não classificado. - Tendência de resolução: conversas atendidas e resolvidas pelo Captain durante o período, comparadas com o período anterior nos mesmos dias da semana. - CSAT do Captain: a avaliação média dos clientes para Conversas resolvidas pelo Captain e Conversas assistidas pelo Captain, comparadas com as conversas que sua equipe atendeu sozinha. - Cobertura de conhecimento: FAQs aprovadas contra FAQs sugeridas aguardando revisão. Clique em Revisar FAQs para ir para a fila. - Uso: Créditos e Documentos usados na conta. Clique em Atualizar uso para atualizar, ou Comprar mais créditos. Ver as conversas por trás de um número Administradores podem clicar em um número, ou em um motivo de transferência, para ver as conversas por trás dele. Clique em Carregar mais para ver mais. A lista conta "episódios". Uma conversa pode aparecer mais de uma vez se o Captain a atendeu em momentos diferentes, por exemplo, após ter sido reaberta. Teste Escolha Este mês, clique em Taxa de transferência e abra algumas conversas. Verifique se os motivos da transferência coincidem com o que aconteceu. Obtenha valor Use os motivos de transferência para decidir o que corrigir primeiro: Se este for alto Tente isto Conhecimento ausente Adicione documentos e aprove sugestões de FAQ. Veja Adicionar documentos ao conhecimento do Captain e Adicionar FAQs e revisar sugestões de FAQ no Captain Falha de ferramenta Verifique suas ferramentas. Veja Configurar ferramentas personalizadas para o Captain Restrição de política ou Solicitação não suportada Verifique se suas regras de segurança e cenários não estão muito restritos. Veja Configurar regras de segurança, diretrizes e cenários do Captain Limite de uso A conta ficou sem créditos. Veja Créditos e uso do Captain AI Solicitação do cliente Muitas vezes é esperado. Se estiver muito alto, verifique as respostas do assistente no Playground - Se a Taxa de reabertura aumentar, as respostas podem parecer corretas, mas não resolverem o problema. Leia algumas conversas reabertas. - Economia de esforço e tempo do agente é uma estimativa, não uma medição. - Para relatórios de todos os bots na conta. Solução de problemas Sintoma Causa provável O que fazer "Nenhum dado disponível para este período." Nenhuma caixa de entrada conectada, ou o Captain não atendeu conversas nesse período Conecte uma caixa de entrada ou escolha outro período Um período mostra "Histórico de relatórios insuficiente" O assistente não tem dados desse período Escolha um período mais curto Resoluções do Captain permaneceram fechadas sem valor Nenhuma resolução nesse período tem sete dias ainda Esperado. Verifique novamente depois Clicar em um número não faz nada Você não é um administrador Peça a um administrador Uma conversa aparece duas vezes em uma lista O Captain a atendeu em dois episódios diferentes Esperado Números de uso parecem antigos O card não foi atualizado Clique em Atualizar uso Mais causas: Solução de problemas do Captain.

Atualizando o robots.txt para Permitir que o Chatwoot Assistant Faça a Varredura do Seu Site

O Chatwoot utiliza o Firecrawl internamente para buscar e indexar o conteúdo do seu site. Isso permite que o Assistente do Chatwoot responda perguntas usando as informações do seu site. No entanto, se o arquivo robots.txt do seu site possuir regras Disallow, o Firecrawl irá respeitá-las e pular o rastreamento dessas páginas. Quando isso acontece: - Nenhum documento do seu site será adicionado ao Chatwoot - O Assistente não receberá contexto adicional - As respostas podem se tornar incompletas ou genéricas Para garantir que o Assistente funcione corretamente, é necessário permitir que o Firecrawl rastreie o seu site. Passo 1: Verifique Seu robots.txt Acesse: https://seudominio.com/robots.txt Procure por entradas Disallow: que possam bloquear agentes de usuário. Passo 2: Adicione uma Regra Allow para o Firecrawl Peça para o administrador ou desenvolvedor do seu site adicionar as seguintes linhas ao arquivo robots.txt: User-agent: FirecrawlAgent Allow: / Isso indica ao Firecrawl que ele tem permissão para rastrear todo o seu site, mesmo que outros bots estejam restritos. Passo 3: Salve e Publique Após atualizar o robots.txt, certifique-se de que o arquivo foi publicado e está acessível publicamente. Você pode verificar acessando: https://seudominio.com/robots.txt e conferindo se as novas regras aparecem.

O Capitão decide resolver automaticamente ou repassar as conversas

Quando o Captain lida com uma conversa com o cliente, ela não permanece no estado "pendente" para sempre. Após um período de inatividade, o Captain avalia a conversa e decide por um de dois desfechos: resolver (se as necessidades do cliente foram atendidas) ou transferir para um agente humano (se algo ainda está pendente). Este artigo explica como essa decisão funciona e o que você pode esperar. O fluxo de auto-resolução Veja o que acontece depois que o Captain responde a um cliente: 1. A conversa permanece com status Pendente enquanto o Captain está cuidando dela. 2. Se não houver nova atividade por 1 hora, o Captain avalia a conversa. 3. Com base na avaliação, o Captain irá: - Resolver a conversa — envia uma mensagem de resolução e a encerra. - Transferir para um agente humano — reabre a conversa para que sua equipe possa assumi-la. Em ambos os casos, o Captain adiciona uma nota privada explicando por que tomou a decisão. Como o Captain avalia uma conversa O Captain lê toda a conversa e verifica se as necessidades do cliente foram atendidas. A avaliação é intencionalmente conservadora — em caso de dúvida, o Captain mantém a conversa aberta e transfere para um humano. É melhor que um agente encontre uma conversa que talvez não precisasse de atenção do que um cliente tenha sua conversa encerrada enquanto ainda precisa de ajuda. Quando o Captain resolve O Captain resolve uma conversa quando tem confiança de que a dúvida do cliente foi completamente respondida e não resta nada para acompanhar. O cliente não precisa dizer explicitamente "obrigado" ou confirmar — se o Captain deu uma resposta completa e o cliente não fez outra pergunta, isso já é suficiente. Por exemplo, se um cliente perguntar "Quais são o horário de funcionamento?" e o Captain responder com os horários, e o cliente não responder por uma hora — o Captain irá resolver. A resposta era autoexplicativa e completa. O Captain também resolve quando o cliente envia um texto sem sentido ou só palavras soltas sem nenhuma pergunta clara, e o Captain pediu esclarecimento mas não teve resposta. Quando o Captain transfere O Captain transfere para um humano sempre que houver uma chance de que o cliente ainda precise de ajuda. Alguns exemplos comuns: - O Captain sugeriu que o cliente tente algo (como limpar o cache ou atualizar uma configuração) — o cliente pode ainda estar tentando isso. - O Captain apontou o cliente para um link externo ou recurso — ele pode ainda estar consultando. - O cliente pediu algo que o Captain não pôde fazer — mesmo se o Captain explicou o motivo, a necessidade está pendente. - O cliente levantou vários pontos e nem todos foram respondidos. O princípio orientador: se houver qualquer dúvida sobre o cliente ter terminado, o Captain vai preferir manter a conversa aberta para sua equipe. O que o cliente vê Quando o Captain resolve: O cliente recebe uma mensagem de resolução. Você pode personalizar essa mensagem nas configurações do seu assistente Captain — se não configurar, uma mensagem padrão será utilizada. Quando o Captain transfere: Se você definiu uma mensagem de transferência nas configurações do assistente Captain, o cliente verá essa mensagem. O status da conversa muda para Aberta, e sua equipe pode visualizá-la na fila. Se sua equipe estiver fora do horário comercial, o cliente também recebe automaticamente sua mensagem de ausência. Perguntas frequentes O auto-resolve funciona em todos os idiomas? Sim. O Captain avalia as conversas com base no significado e na intenção, independentemente do idioma utilizado. Onde posso ver por que o Captain resolveu ou transferiu uma conversa? Verifique a conversa para uma nota privada do Captain. Ele adiciona uma nota com sua justificativa antes de cada decisão de resolução ou transferência. Não quero que o Captain auto-resolva conversas na minha conta. Entre em contato com nossa equipe de suporte e podemos desativar o auto-resolve para sua conta.

Como Configurar Ferramentas Personalizadas para o Captain

Custom Tools permitem que o Captain chame suas APIs externas durante conversas — assim ele pode verificar o status do sistema, consultar horários ou buscar dados dos seus próprios serviços sem encaminhar para um agente humano. Quando um cliente faz uma pergunta, o Captain extrai os valores relevantes da conversa, insere-os na requisição à sua API e usa a resposta para formar a sua resposta. Custom Tools está disponível no plano Business e superiores. Criando uma ferramenta Navegue até Captain -> Ferramentas e clique em Criar uma nova ferramenta. Preencha os seguintes campos: Nome da Ferramenta — Um nome curto como "Status do Sistema" ou "Consulta de Horários" (máx. 55 caracteres). Descrição — Indique ao Captain quando usar esta ferramenta. Este é o campo mais importante. Escreva como se estivesse instruindo um agente de suporte: "Verifica o status atual do sistema, incluindo quaisquer incidentes em andamento ou manutenção." Descrições vagas como "API de Status" farão o Captain perder oportunidades de usar a ferramenta. Método — Escolha GET (para buscar dados) ou POST (para enviar dados). URL do Endpoint — A URL da sua API. Use {{ parameter_name }} para inserir valores extraídos da conversa: https://api.yourcompany.com/v1/showtimes?q={{ query }} A URL deve usar HTTPS, ser um hostname (não um endereço IP), e não pode apontar para localhost ou redes privadas. Autenticação — Escolha como sua API autentica as requisições: Tipo O que você fornece Nenhum Sem autenticação Bearer Token Uma string de token Basic Auth Nome de usuário e senha API Key Um nome de cabeçalho personalizado e valor As credenciais de autenticação são visíveis apenas para administradores da conta. Parâmetros — Defina o que o Captain deve extrair da mensagem do cliente. Cada parâmetro precisa de um nome, tipo e descrição. Por exemplo: query (String) — "O título do filme ou data que o cliente está perguntando." Template de Requisição (apenas POST) — Um template de corpo JSON usando sintaxe Liquid: { "query": "{{ query }}", "source": "captain" } Template de Resposta — Controla o que o Captain vê da resposta da sua API. Se ficar em branco, o Captain recebe o JSON bruto. Use Liquid para extrair campos relevantes: Status do sistema: {{ response.status }}. {{ response.message }} Use response para acessar o corpo JSON analisado. Templates de resposta ajudam o Captain a focar apenas nos dados relevantes e evitar campos internos como IDs de banco de dados ou informações de debug. Testando sua ferramenta Clique em Testar conexão antes de salvar para verificar se seu endpoint está acessível. O teste mostra o código de status HTTP. Um resultado verde (HTTP 200–299) significa que a conexão e a autenticação estão funcionando. Note que o teste envia a URL sem preencher os valores de parâmetro, então ele apenas verifica se seu endpoint está acessível e se suas credenciais foram aceitas. Se o teste falhar, verifique o seguinte: - 401 Não autorizado — Suas credenciais de autenticação estão incorretas. Verifique o bearer token, chave API ou nome de usuário/senha. - 403 Proibido — Sua API está rejeitando a requisição. Se você exigir verificação de identidade, observe que requisições de teste não incluem cabeçalhos de contato. - 404 Não encontrado — A URL do endpoint está errada. Verifique o caminho e confirme se sua API está em execução. - Timeout — Sua API demorou muito para responder. As ferramentas customizadas têm um timeout de 30 segundos; certifique-se de que seu endpoint responda dentro desse prazo. Contexto enviado em cada chamada de ferramenta Quando o Captain chama sua API, ele inclui cabeçalhos de metadados para que seu backend saiba o contexto: Cabeçalho Descrição X-Chatwoot-Account-Id O ID da sua conta X-Chatwoot-Conversation-Id O ID da conversa X-Chatwoot-Contact-Email O e-mail do cliente (se disponível) X-Chatwoot-Contact-Inbox-Verified Se a identidade do cliente está verificada por HMAC Cabeçalhos adicionais incluem X-Chatwoot-Assistant-Id, X-Chatwoot-Tool-Slug, X-Chatwoot-Contact-Id, X-Chatwoot-Contact-Phone e X-Chatwoot-Conversation-Display-Id. Você pode usar esses cabeçalhos para buscar o cliente em seu próprio sistema, registrar quais conversas acionaram chamadas à API e verificar a autenticidade da requisição. Segurança Proteções nativas: - Todos os endpoints devem usar HTTPS - Requisições para faixas de IP privadas, localhost e domínios .local são bloqueadas - Redirecionamentos HTTP não são seguidos - Respostas são limitadas a 1 MB - Credenciais de autenticação são visíveis apenas para administradores Verificação de identidade: Se sua ferramenta retornar dados específicos do cliente (pedidos, faturamento, detalhes de conta), sua API deve verificar o cabeçalho X-Chatwoot-Contact-Inbox-Verified. Sem verificação HMAC ativada no seu inbox, um visitante pode definir qualquer endereço de e-mail no widget de chat. Só retorne dados sensíveis quando este cabeçalho for true. Para ferramentas que retornam dados públicos (horários, status do sistema), essa checagem não é necessária. Prompt injection: Se sua API retornar conteúdo gerado por usuários (avaliações, postagens de fórum), textos maliciosos podem influenciar o comportamento do Captain. Use templates de resposta para extrair apenas campos estruturados, e sanitize conteúdos em sua API. Limites Limite Valor Máximo de ferramentas por conta 15 Recomendado 10 ou menos (um aviso aparece acima de 10) Tamanho do nome da ferramenta 55 caracteres Tamanho da resposta 1 MB máx. Timeout da requisição 30 segundos Quando usar ferramentas customizadas Ferramentas customizadas são mais indicadas para consultas estruturadas com entradas previsíveis — verificar status do sistema, buscar horários ou consultar registros por ID. Se você já possui uma integração dedicada do Chatwoot para seu caso de uso (ex.: Shopify para e-commerce), use-a em vez disso — integrações dedicadas lidam com buscas, correspondência difusa e sincronização de dados de forma mais confiável do que uma única chamada de API. Exemplos Verificação de Status do Sistema Uma ferramenta simples sem parâmetros — o Captain a aciona quando um cliente pergunta se algo está fora do ar. | Campo | Valor | |-------|-------| | Nome da Ferramenta | Status do Sistema | | Descrição | Verifica o status operacional atual do sistema, incluindo qualquer incidente em andamento ou manutenção programada. Use quando um cliente relatar problemas ou perguntar se o sistema está fora do ar. | | Método | GET | | URL do Endpoint | https://status.yourcompany.com/api/v1/status | | Autenticação | Nenhuma | | Parâmetros | (nenhum) | | Template de Resposta | Status do sistema: {{ response.status }}. {{ response.message }} | Consulta de Sessões / Horários Para empresas que têm horários, tabelas ou listas de eventos — os clientes perguntam o que está disponível e o Captain busca a agenda atual. | Campo | Valor | |-------|-------| | Nome da Ferramenta | Consulta de Horários | | Descrição | Consulta horários de filmes e exibições em cartaz. Use quando um cliente perguntar quais filmes estão passando ou quando um filme específico será exibido. | | Método | GET | | URL do Endpoint | https://api.yourcinema.com/v1/showtimes?q={{ query }} | | Autenticação | Bearer Token | | Parâmetros | query (String, obrigatório) — "O título do filme ou data da sessão que o cliente está perguntando" | | Template de Resposta | {% for show in response.showtimes %}{{ show.title }} — {{ show.date }} às {{ show.time }}{% endfor %} | Ferramentas customizadas funcionam melhor quando as entradas são diretas e a resposta da API é previsível — verificações de status, consultas e outras buscas estruturadas são opções ideais.

Traduzir automaticamente mensagens em conversas

Auto-tradução permite que sua equipe atenda clientes em qualquer idioma. As mensagens dos clientes aparecem no seu idioma, e suas respostas chegam ao cliente no idioma deles, automaticamente. Este artigo mostra como ativar e como trabalhar com conversas traduzidas. Antes de começar - A auto-tradução está disponível em todos os planos pagos, tanto na versão auto-hospedada quanto na Chatwoot Cloud. - Você precisa ser um administrador para ativá-la. - As mensagens são traduzidas para o idioma que o seu painel do Chatwoot está configurado. Cada agente pode alterar isso em Configurações de Perfil → Idioma Preferido. Se um agente não escolher um, será usado o idioma padrão da conta. Passo 1: Ative a Auto-tradução 1. Vá em Configurações → Fluxos de Trabalho da Conversa. 2. Na seção Tradução, escolha um serviço de tradução: - Captain: Traduções de IA que soam naturais e mantêm seu tom. - Google Translate: traduções rápidas e confiáveis do Google. Se aparecer Não conectado, clique em Conectar e siga as instruções primeiro. 3. Ative a opção Auto-traduzir conversas. Configurações → Fluxos de Trabalho da Conversa → Tradução Pronto. A auto-tradução agora funciona em todas as conversas da sua conta. Os agentes não precisam configurar nada. Passo 2: Leia as mensagens dos clientes no seu idioma Abra qualquer conversa. Quando um cliente escrever em outro idioma, a mensagem dele já aparecerá traduzida, com um link Ver original abaixo que indica o idioma em que foi escrita. No exemplo abaixo, Sophie escreve em francês e o agente lê as mensagens dela em inglês. As mensagens em francês da Sophie aparecem em inglês. A resposta do agente em inglês é enviada para ela em francês. Passo 3: Responda no seu próprio idioma Digite sua resposta no seu idioma normalmente e envie. O Chatwoot traduz para o idioma do cliente antes da mensagem chegar até ele. Um link Ver traduzido aparece abaixo da sua resposta. Passo 4: Confira o texto original ou traduzido Você sempre pode ver exatamente o que foi escrito ou enviado: - Em uma mensagem do cliente, clique em Ver original para ver as palavras exatas do cliente. - Em sua resposta, clique em Ver traduzido para ver a versão que o cliente recebeu. - Clique novamente no link para voltar. Mensagem original em francês da Sophie e a versão em francês da resposta do agente O que você verá nas mensagens O que você vê O que significa Texto roxo cintilante com Traduzindo... Uma mensagem do cliente está sendo traduzida para seu idioma. Isso normalmente leva um ou dois segundos. Texto roxo cintilante com Traduzindo para Francês... Sua resposta está sendo traduzida para o idioma do cliente antes de ser entregue. Ver original (Francês) A mensagem do cliente foi traduzida. Clique para ver o que ele escreveu. Ver traduzido (Francês) Sua resposta foi traduzida. Clique para ver o que o cliente recebeu. Não foi possível traduzir A mensagem do cliente não pôde ser traduzida e está mostrando como ele escreveu. Não foi possível traduzir, enviada como digitada Sua resposta não pôde ser traduzida, então o cliente recebeu o texto original. Uma nova mensagem do cliente está sendo traduzida para inglês A mensagem em inglês da Sophie não mostra linha de tradução. A última resposta do agente está sendo traduzida para francês. Perguntas frequentes Como o Chatwoot sabe em qual idioma responder? O Chatwoot detecta o idioma em que o cliente está escrevendo e traduz suas respostas para esse idioma. O que acontece se o cliente mudar para o meu idioma? As mensagens dele aparecem exatamente como foram escritas, sem nada extra abaixo. Suas respostas seguem o idioma que o cliente está usando na conversa. As notas privadas são traduzidas? Não. Somente as mensagens visíveis para o cliente são traduzidas. Notas privadas permanecem exatamente como você escreveu. Ainda preciso da opção Traduzir no menu da mensagem? Não. Com a Auto-tradução ativada, as mensagens já são traduzidas para você, então a opção manual Traduzir fica oculta nessas mensagens. Posso alternar entre Captain e Google Translate? Sim. Volte em Configurações → Fluxos de Trabalho da Conversa e escolha o outro serviço. As novas mensagens usarão o serviço que você selecionou.