Captain

Comece com o Captain AI

Captain é a IA do Chatwoot. Ele pode responder clientes para você, ajudar seus agentes a escrever respostas e aprender com seus documentos de ajuda e conversas anteriores. O que o Captain pode fazer Capacidade O que faz Quem usa Página Assistente Responde aos clientes nas caixas de entrada que você conectar e encaminha para sua equipe quando não puder ajudar Clientes Configure um assistente Captain e conecte suas caixas de entrada Conhecimento Aprende com páginas de sites, PDFs e FAQs que você adiciona Administradores Adicione documentos ao conhecimento do Captain Diretrizes, orientações e cenários Controla o que o assistente responde, como ele se comunica e o que faz em situações específicas Administradores Defina as diretrizes, orientações e cenários do Captain Público e agenda Limita para quais clientes o assistente responde e quando Administradores Controle para quem e quando o Captain responde Ferramentas personalizadas Permite que o assistente busque informações em seus próprios sistemas, como status de pedido Administradores Configure ferramentas personalizadas para o Captain Copilot Ajuda agentes a resumir, criar rascunhos de 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 Use Captain Memories Ajuda de IA no editor e caixa Reformula, resume e sugere resposta no editor, transcrição de áudio e Sugerir com o Captain para etiquetas e prioridade de conversas Agentes; admins ativam Condições do Captain na automação Uma regra de automação pode perguntar ao Captain se uma conversa corresponde a uma descrição que você escreve, por exemplo "cliente quer cancelar" Administradores Plano & acesso Plano Captain Hacker (gratuito) 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 o maior número de créditos mensais de IA - Quantidade de créditos por plano e preço do adicional estão em Planos e Preços > Créditos Captain AI. Como os créditos são usados está em Créditos Captain AI e uso. - Perfil: 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 Ativar Captain em auto-hospedado. - Teste gratuito: o Captain não está disponível durante o teste gratuito. Como verificar se você tem o Captain Procure por Captain na barra lateral esquerda. Se você clicar e ver Faça upgrade para usar o Captain AI, sua conta está no plano Hacker. Um administrador pode fazer o upgrade em Cobrança. Configuração e teste A ordem recomendada: 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 conheça seu produto. 3. Opcional: Controle para quem e quando o Captain responde, Defina as diretrizes, orientações e cenários do Captain, Configure ferramentas personalizadas para o Captain. Admins de auto-hospedado começam por Ativar 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 - Monitore o Resumo do assistente para cobertura de Conhecimento e quantas conversas ele atendeu. - Entregue uma conversa ao assistente você mesmo: selecione-o no menu de responsável da conversa. Veja Configure um assistente Captain e conecte suas caixas de entrada - Verifique o uso dos créditos em Cobrança. Veja Créditos Captain AI e uso. O que muda em outros recursos quando o Captain está ativado - Chat ao vivo no site: a mensagem “estamos ausentes” não é exibida enquanto o assistente estiver respondendo. - Continuar conversas por e-mail: a solicitação de e-mail não é mostrada, a não ser que o assistente encaminhe. - Saudação da caixa de entrada: a mensagem de saudação da caixa de entrada não é enviada enquanto o assistente estiver atendendo a conversa. Se o assistente responde para todos (público definido como Todos), clientes das suas caixas de entrada não verão a saudação. - A lição 5 em Comece aqui mostra o passo a passo do 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, acesse Solução de problemas do Captain.

Configure um assistente Captain e conecte suas caixas de entrada

Descubra Um assistente responde aos clientes nas caixas de entrada que você conectar, 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 outros). - Algum conhecimento para adicionar logo em seguida: páginas do site, PDFs ou FAQs. Sem conhecimento, o assistente terá 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 o novo assistente: - Ainda não tem assistente: clique em Criar 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 usará isto ao falar sobre seu produto. O Captain só responde perguntas sobre o produto nomeado aqui, então use o nome da sua marca ou produto, e não de uma funcionalidade específica. 4. Escolha as funcionalidades (todas começam desativadas): - Gerar FAQs a partir de conversas resolvidas: O Captain sugere novas FAQs com base em conversas resolvidas. Veja Adicionar FAQs e revisar sugestões de FAQ no Captain. - Capturar detalhes chave como memórias de interações com clientes. Veja Utilize Memórias do Captain. - Incluir citações de fonte nas respostas: a resposta mostrará em qual documento se baseou. 5. Clique em Criar. - Se este for seu primeiro assistente, o Chatwoot abrirá suas FAQs. - Se você usou o seletor, o Chatwoot permanecerá no assistente que você 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, depois vá em Caixas de Entrada. 2. Clique em Conectar nova caixa de entrada, escolha a caixa e confirme. Enquanto nenhuma caixa de entrada estiver conectada, a Visão geral do assistente exibirá: "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 detalhes do contato nas respostas. - Configurações do sistema: - Mensagem de repasse: o que o assistente diz ao transferir a conversa para sua equipe. - Quando clientes param de responder: escolha a Ação quando o cliente para de responder e quanto tempo esperar (de 5 minutos a 24 horas; o padrão é 60 minutos). - Deixe o Captain decidir (recomendado): o Captain decide se resolve ou repassa. Este é o padrão. - Sempre resolver: o Captain resolve toda conversa depois do tempo de espera. - Aguardar o cliente: o Captain nunca resolve sozinho. Ainda pode repassar, caso o cliente solicite. - Enviar mensagem ao resolver (ativo por padrão) envia a Mensagem de Resolução antes de o Captain encerrar. Teste 1. Abra o assistente e vá em Playground. 2. Faça as perguntas mais comuns dos seus clientes. Verifique se as respostas são precisas, curtas e com o seu tom de voz. 3. Pergunte algo que ele não deveria saber. Confira se ele informa que não pode ajudar e oferece conectar você à equipe. Ele faz o repasse quando você aceita. 4. A resposta pode demorar alguns segundos para aparecer; você pode deixar a página aberta enquanto aguarda. 5. Em seguida, envie uma mensagem real para a caixa de entrada conectada, por exemplo, pelo widget do site, e observe a resposta chegar. Mensagens do Playground usam créditos, assim como respostas a clientes. Teste mudanças antes de salvar No Playground, abra Testar configuração para experimentar alterações sem mexer no assistente. Mudanças são válidas só nesta sessão do playground, a menos que você as salve. - Conhecimento: cole texto em Texto de referência para testar uma resposta antes que seja um documento. Clique em Adicionar documento permanentemente para mantê-lo. - Cenários, Diretrizes e Restrições: adicione um item temporário com Adicionar ao teste (↵), ou use Incluir neste teste para ativar/desativar itens salvos só neste teste. Clique em Adicionar cenário permanentemente, Adicionar diretriz permanentemente ou Adicionar restrição permanentemente para mantê-los. - Em cada resposta, Detalhes da execução mostra os cenários e regras usados, chamadas de ferramentas e repasses. - Redefinir configuração do 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. - Modele as respostas: Defina restrições, diretrizes e cenários do Captain. - Veja a Visão geral do assistente para conversas atendidas, Cobertura de conhecimento e um Resumo do Captain. - Repassar uma conversa para o assistente manualmente: no menu de atribuição da conversa, escolha o assistente (apenas o conectado a essa caixa de entrada será listado). A conversa será movida para pendente e o assistente assumirá, mesmo que regras de público ou agenda pulassem ela. Para retomar, atribua a uma pessoa. - Use o seletor de assistente (Alternar entre assistentes) se você operar 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. Ele nunca vê notas privadas. - Para acompanhar o desempenho do assistente, utilize sua Visão geral. Veja Visão geral e relatórios do Captain. Solucione problemas Sintoma Causa provável O que fazer O assistente nunca responde Nenhuma caixa conectada Conecte uma em Caixas de Entrada Não é possível conectar uma caixa de entrada A caixa já tem um assistente Desconecte da outra antes de seguir Respostas vagas/incorretas Pouco ou nenhum conhecimento Adicione documentos e FAQs, depois teste novamente no Playground Não vê Criar novo assistente ou Criar Assistente Você não é administrador Peça a um administrador Outras causas, incluindo silenciosas: Solucione problemas no Captain.

Adicione documentos ao conhecimento do Captain

Descobrir Os documentos ensinam seu assistente sobre o seu produto. Adicione páginas de sites ou arquivos PDF, e o Captain irá lê-los, responder com base neles e criar FAQs a partir deles. 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 por todos os assistentes da conta, e cada PDF ou página rastreada conta como um documento. Configurar & testar Antes de começar - Um assistente. Veja Configure um assistente Captain e conecte suas caixas de entrada. - As páginas do site devem ser públicas. O Captain não consegue ler páginas protegidas por login. - Os PDFs devem ter até 10MB e conter texto real (imagens escaneadas podem não ser lidas). - Se seu site bloqueia rastreadores no robots.txt, permita o Chatwoot primeiro (abaixo). Adicionar 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 Escolher arquivo PDF e selecione 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 Firecrawl para ler sites e respeita o seu robots.txt. Se algumas páginas estiverem bloqueadas, adicione isto em https://seudominio.com/robots.txt: User-agent: FirecrawlAgent Allow: / Verifique se o arquivo está acessível nesse endereço e 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á mostrado. O assistente poderá 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 se as FAQs relacionadas listam perguntas pertinentes. 3. Envie uma pergunta dessa página no Playground do assistente. Aproveitar ao máximo - 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 sites também são atualizados automaticamente: mensalmente no Startups (dia 1), semanalmente no Business (aos domingos) e diariamente no Enterprise. O processamento pode levar mais tempo, então uma 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 do que o total restante do seu limite de documentos. - Prefira fontes focadas, como o seu centro de ajuda, em vez de todo o site institucional. - Usado em conversas mostra quais conversas usaram um documento. - Excluir um documento remove tudo que o Captain aprendeu com ele. - Artigos do Centro de Ajuda não são lidos automaticamente. Para usá-los, adicione o endereço do seu Centro de Ajuda como um documento de 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 entram no ar imediatamente. Elas aparecem em FAQs e não precisam de aprovação. - FAQs que o Captain gera sempre usam o idioma da sua conta. O assistente ainda irá responder no idioma do cliente. - O Captain não remove detalhes pessoais ou confidenciais do que você adiciona. Só adicione conteúdo que você autoriza o assistente a citar para clientes. Solução de problemas Sintoma Possível causa O que fazer Status exibe Falha ao sincronizar com Acesso negado A página precisa de login, ou seu site bloqueou o pedido (erro 401 ou 403). Torne a página pública, ou permita o acesso no seu site. Adicionou um site mas nenhuma página aparece, ou respostas genéricas Seu robots.txt pode estar bloqueando o rastreador. Permita como mostrado em Permita que o Chatwoot rastreie seu site , então adicione novamente. Página não encontrada URL está incorreta ou a página foi movida Corrija a URL e adicione novamente Página demorou demais para responder Seu site estava lento Use Tentar atualizar depois Página retornou conteúdo vazio Conteúdo só carrega com scripts, ou a página está vazia Use uma página com texto simples ou envie um PDF atualização travada Uma atualização não finalizou Use Tentar atualizar Detalhes do PDF informam que não foi possível extrair conteúdo legível PDF é escaneado ou só imagem Faça upload de um PDF com texto Banner: Limite de documentos atingido A conta possui 2.000 documentos entre todos os assistentes Exclua documentos desnecessários ou veja Preços & Planos Mais motivos: Solução de problemas com o Captain.

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

Descubra As 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 de 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 FAQ; agentes veem apenas sugestões originadas em conversas às quais possuem acesso. Configurar & testar Antes de começar - Um assistente com alguns documentos. Veja Adicione documentos ao conhecimento do Captain. - Para sugestões vindas de conversas, ative Gerar FAQs a partir de conversas resolvidas no assistente. Veja Configurar um assistente Captain e conectar suas caixas de entrada Escrever uma FAQ 1. Vá para Captain > FAQs. 2. Clique em Criar nova FAQ. 3. Insira a pergunta e a resposta, escolha o assistente e clique em Criar. Revisar sugestões de FAQ O Captain agrupa perguntas recorrentes de clientes em sugestões e as classifica por demanda dos clientes. As sugestões são escritas no idioma da sua conta. Elas vêm apenas de conversas resolvidas em que um agente respondeu. Conversas que o Captain resolve sozinho 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 relacionadas. 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 Ignorar para descartá-la. As FAQs que o Captain gera a partir de um documento ficam listadas em FAQs relacionadas daquele documento. FAQs criadas a partir dos seus documentos ficam ativas imediatamente e não precisam de aprovação. Teste Faça a pergunta aprovada no Playground do assistente e verifique se está usando sua resposta. Obtenha valor - Revise as sugestões semanalmente. Elas vêm de perguntas reais de clientes, então ajudam a preencher as lacunas mais importantes. - Mantenha as respostas curtas e específicas. Uma pergunta por FAQ. - O Resumo do assistente mostra a Cobertura de conhecimento: FAQs aprovadas em relação a sugestões aguardando revisão. Um banner aparece quando há sugestões prontas. - Pesquise com Buscar FAQs... e selecione várias para excluir de uma vez só. Solucionar problemas Sintoma Causa provável O que fazer Nenhuma sugestão aparece Gerar FAQs a partir de conversas resolvidas está desativado ou poucas conversas foram resolvidas ainda. Ou nenhum agente respondeu. Sugestões exigem pelo menos uma resposta de agente. Ative no assistente e aguarde O assistente ainda responde com a resposta antiga A FAQ é uma sugestão, não aprovada Aprove Não é possível criar ou editar uma FAQ Você não é um administrador Peça para um administrador, ou aprove sugestões Um agente vê menos sugestões que um administrador Agentes veem apenas sugestões de conversas às quais têm acesso 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 para um administrador com acesso revisar Mais causas: Solucionar problemas do Captain.

Defina as diretrizes, orientações e cenários do Capitão

Descubra Três conjuntos de regras moldam o seu assistente: Restrições decidem quais perguntas ele responde, Diretrizes de Resposta definem como soam suas respostas, e Cenários dizem o que fazer em situações específicas. Plano & acesso: Startups, Business ou Enterprise Preços & Planos. Administradores as editam. Elas fazem parte de todas as contas Captain, em todos os planos pagos. Conjunto de regras Use para Exemplo Restrições Manter o assistente no assunto e longe de perguntas proibidas "Não forneça conselhos legais ou médicos." Diretrizes de Resposta Tom, comprimento e estrutura das respostas "Mantenha as respostas com menos de três frases. Seja amigável, não formal." Cenários Passo a passo para lidar com uma situação, podendo usar uma ferramenta personalizada "Quando um cliente pedir reembolso, solicite o número do pedido, verifique na ferramenta de consulta de pedidos e encaminhe." Configurar & testar Antes de começar - Um assistente. Veja Como configurar um assistente Captain e conectar suas caixas de entrada. - Para cenários que acessam seus sistemas, uma ferramenta personalizada. Veja Como configurar ferramentas personalizadas para o Captain. Adicionar restrições e diretrizes de resposta 1. Vá em Captain, abra o assistente e acesse Configurações. 2. Abra Restrições ou Diretrizes de resposta. 3. Clique em Adicionar restrição ou Adicionar diretriz de resposta, digite a regra como uma frase curta e clique em Criar. 4. Para adicionar regras dos exemplos, digite na caixa abaixo dos exemplos e clique em Adicionar e salvar (↵), ou pressione Enter. 5. Para editar uma regra, clique no ícone do lápis, edite o texto e pressione Enter. Adicionar 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 etapas claras. Para usar uma ferramenta em um passo, digite @ e escolha da lista, por exemplo Encaminhar para Humano ou uma de suas ferramentas personalizadas. Se o cenário deve terminar com sua equipe, adicione o encaminhamento como último passo. 3. Clique em Criar. 4. Para editar 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 capturar (por exemplo, uma pergunta fora de assunto e uma solicitação de reembolso). Verifique se a resposta segue a regra. Obtenha valor - Comece pequeno: três a cinco restrições e diretrizes. Adicione mais quando identificar um problema real nas conversas. - Escreva as regras como instruções para um novo membro da equipe, não como palavras-chave. - Restrições são instruções para a IA, não um filtro. Elas reduzem bastante as respostas fora de tema, mas não podem descartá-las completamente, então mantenha a Mensagem de Encaminhamento clara. - Se uma ferramenta usada em um cenário for desabilitada, aquele cenário pode parar de funcionar. O Chatwoot avisa antes de você desabilitar. Solução de problemas Sintoma Causa provável O que fazer Assistente ignora uma regra A regra é vaga ou conflita com outra Reescreva como uma frase clara; remova conflitos Cenário nunca é executado A descrição da situação não bate com como os clientes perguntam Descreva a situação com as palavras dos clientes Cenário para no meio Sua ferramenta personalizada está desativada ou com falha Verifique a ferramenta em Ferramentas Não aparece item Cenários para o assistente Conta é Hacker (gratuita), ou, no auto-hospedado, Captain não está ativado para a conta Faça upgrade ou peça ao Super Admin para ativar o Captain Mais causas: Solução de problemas do Captain.

Controle para quem o Capitão responde e quando

Descobrir Você pode escolher para quais clientes o assistente irá responder (Público) e quando (Agenda). As conversas que o assistente não atender ficam Abertas para a 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 e 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 uma agenda, horário comercial ativado para aquela caixa de entrada, nas próprias configurações da caixa. Veja Horário Comercial e Resposta Automática. - Para regras de público baseadas nos seus próprios dados, os atributos personalizados de contato que você deseja usar. Veja Entendendo Contatos. Escolher o público 1. Vá em Captain > Assistentes, abra o assistente e acesse Configurações > Público. 2. Escolha: - Todos: o assistente responde em todas as conversas nas suas caixas de entrada. Este é o padrão. - Público específico: o assistente responde apenas para os clientes que correspondem às suas condições. 3. Para um público específico, adicione condições. Cada uma tem um atributo, um operador e um valor. - Atributos do contato: Nome, E-mail, Telefone, Identificador, País, Cidade, Empresa, Criado em, Última atividade, Bloqueado, Rótulos. - Atributos da conversa: Usuário logado, Idioma do navegador. Idioma do navegador vem apenas do widget no site, então não funciona para WhatsApp, Telegram, SMS ou outros canais. Rótulos significa rótulos de contato, não de conversa. Usuário logado significa que o visitante foi verificado com validação de identidade (HMAC) no seu widget do site. - Seus atributos personalizados de contato. - Os operadores que você pode escolher dependem do atributo. Por exemplo, Nome oferece apenas igual e diferente, E-mail oferece também contém (use para segmentar um domínio como @acme.com), e datas oferecem maior que, menor que e dias antes. 4. Escolha se os clientes devem corresponder 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 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 Qualquer momento (padrão), Durante o horário comercial ou Fora do horário comercial. 3. Salve. Ambas as regras devem ser satisfeitas: o assistente responde somente quando o cliente está no público e está dentro do horário definido. Teste 1. Inicie uma nova conversa como um cliente que corresponde, dentro do horário definido. O assistente responde. 2. Inicie como um cliente que não corresponde. Vai para sua equipe sem resposta do assistente. Obtenha valor - Configurações comuns: assistente apenas fora do horário comercial; assistente apenas para usuários logados no site; assistente para todos exceto clientes com o 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é a conversa ser resolvida ou encaminhada. Mudanças se aplicam apenas em conversas novas e reabertas. - Correspondência de texto ignora maiúsculas/minúsculas. Números de telefone correspondem com ou sem o + inicial. Um atributo de caixa de seleção que nunca foi marcado conta como desmarcado. - A agenda segue o horário comercial da caixa de entrada e o seu fuso horário. Se o fuso horário estiver errado, o assistente pode ficar fora do ar para a maioria dos seus clientes, sem aviso. - Essas regras decidem quando o assistente entra sozinho. Um agente ainda pode encaminhar qualquer conversa para o assistente pelo menu suspenso de responsável, e isso ignora público e agenda. Veja Configurar um assistente Captain e conectar suas caixas de entrada. Solução de problemas Sintoma Causa provável O que fazer Assistente responde para alguém excluído Os dados de contato mudaram após o início da conversa Esperado. A regra se aplica a partir da próxima conversa nova ou reaberta. Abra o contato e verifique seus atributos na barra lateral. Captain verifica os valores do contato no início da conversa. Assistente está em uma conversa que deveria ter pulado Um agente atribuiu manualmente a conversa ao assistente Esperado. Atribuição manual ignora público e agenda Agenda não tem efeito Horário comercial está desativado para aquela caixa de entrada. Caixas sem horário são sempre cobertas Ative o horário comercial nas configurações da caixa de entrada Seu atributo não aparece na lista É um atributo personalizado de conversa. Só atributos personalizados de contato funcionam Use um atributo de contato. Crie em 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 sem condições Complete ou remova a condição. Está presente e Não está presente (somente para atributos de data) não precisam de valor. Assistente está silencioso para todos Público ou agenda os exclui Verifique ambas as configurações e depois Solução de problemas 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 encaminhar o atendimento. Plano & acesso: Business ou Enterprise (Pricing & Plans). No Startups, Ferramentas geralmente mostra Atualize para usar ferramentas com o Captain. Cada assistente tem sua própria lista de ferramentas. Administradores criam ferramentas, e apenas administradores podem ver as credenciais salvas. Self-hosted: o Super Admin ativa as Ferramentas Personalizadas para a conta. Configure e 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 no máximo 1 MB. - Suas credenciais, caso precise de alguma. Crie uma ferramenta 1. Vá para Captain > Ferramentas e clique em Criar uma nova ferramenta. Primeiro, use o seletor de assistente no topo para escolher para qual assistente a ferramenta será criada. O formulário abre 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, escrito como um briefing para um novo agente. Isso define se o assistente escolhe a ferramenta. - Método: GET para ler dados; POST, PUT ou PATCH para enviar ou alterar dados; DELETE para remover algo. - Endpoint URL: 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 para inserir credenciais. - Cabeçalhos: clique em Adicionar Cabeçalho para cabeçalhos fixos necessários em todas as requisições da sua API, como versão da API ou ID do locatário (até 16). Os valores são enviados exatamente como digitados. O Chatwoot define Authorization, Host, Content-Length, Content-Type e qualquer cabeçalho que comece com X-Chatwoot, então você não pode adicionar esses. - Parâmetros: clique em Adicionar Parâmetro para cada valor que o assistente deve obter do cliente. Informe um nome, tipo, descrição e marque Obrigatório se necessário. - Modelo do Corpo da Requisição (Opcional): para POST, PUT ou PATCH. Esse e o modelo de resposta ficam em Modelos. O modelo da requisição é um corpo JSON. Suporta Liquid, por exemplo {{ order_id }} para um parâmetro. - Modelo de Resposta (Opcional): selecione os campos que o assistente precisa, por exemplo Pedido {{ response.order_id }} status: {{ response.status }}. Leia a resposta da API através de response, por exemplo {{ response.status }}. Deixe o modelo em branco para enviar o JSON bruto ao Captain. 3. Clique em Testar conexão, depois em Criar. Testar conexão funciona apenas para endpoints sem modelos ou corpo de requisição. Para os demais, teste no Playground. Um resultado verde significa que seu endpoint retornou um status 2xx: está acessível e aceitou as credenciais. Teste Faça uma pergunta no Playground que precisa da ferramenta, por exemplo "Onde está o pedido 1234?". Verifique se a resposta utiliza dados reais. Obtenha valor - As ferramentas personalizadas funcionam melhor para consultas com entradas claras, como status de pedidos, reservas ou registros por ID. - Cada assistente pode ter até 50 ferramentas. Mantenha a lista curta: com muitas ferramentas, o assistente tende a escolher a errada. - Adicionar, editar, desativar ou excluir uma ferramenta afeta apenas o assistente que você está visualizando. Ferramentas existentes antes do modelo por assistente foram copiadas para todos, então revise cada uma. - Gerenciando vários assistentes? Dê a cada um apenas as ferramentas necessárias. - Desative uma ferramenta com seu botão ao invés de excluir. Se um cenário a usar, o Chatwoot avisa. Veja Defina os guardrails, diretrizes e cenários do Captain. - O Chatwoot envia cabeçalhos com cada chamada para seu sistema saber a conta, conversa, e-mail e telefone de contato, assistente e se o contato é verificado. Para dados privados, cheque 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 apenas dados públicos não precisam dessa checagem. Veja Como ativar a validação de identidade no Chatwoot?. - Se sua API retorna textos escritos por clientes, retorne apenas os campos estruturados necessários. O Captain lê a resposta como está, então textos livres podem conter instruções que podem ser seguidas. Solucione problemas Sintoma Causa provável O que fazer Conexão falhou Endpoint indisponível, não é HTTPS ou credenciais erradas Verifique a URL e as credenciais; garanta que é HTTPS público Conexão falhou com 401 As credenciais estão erradas Verifique o Tipo de Autenticação e as credenciais Conexão falhou com 403 Sua API rejeitou a requisição Testes não enviam cabeçalhos de contato, então endpoints que exigem isso falham. Teste no Playground Conexão falhou com 404 Caminho da URL errado Verifique o caminho da URL Conexão falhou com 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 é rejeitado É um cabeçalho que o Chatwoot já define, duplicado, ou seu valor tem placeholders Remova, ou coloque as credenciais em Tipo de Autenticação Ferramenta ausente em outro assistente Ferramentas pertencem a apenas um assistente Troque para esse assistente e crie a ferramenta lá Não é possível adicionar nova ferramenta O assistente já possui 50 ferramentas Exclua ferramentas que não utiliza Assistente nunca usa a ferramenta Descrição está vaga Reescreva a Descrição detalhando quando usá-la Assistente usa a ferramenta errada Muitas ferramentas ou descrições sobrepostas Remova ou desative ferramentas; torne as descrições distintas Resposta lenta ou nenhuma e depois handoff Endpoint levou mais de 20 segundos ou retornou mais de 1 MB Melhore a velocidade do endpoint; reduza a resposta com um Modelo de Resposta Mais causas: Solucione problemas no 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, redigir uma resposta, revisar o tom, traduzir ou pesquisar algo. Plano & acesso: Startups, Business ou Enterprise Preços & Planos. Qualquer agente pode usá-lo, em qualquer caixa de entrada. Não é necessário ativar nada por caixa de entrada. Cada solicitação ao Copilot usa créditos Captain. Configurar & experimentar Antes de começar - Pelo menos um assistente Captain. O Copilot utiliza o conhecimento de um assistente ao pesquisar informações. O Copilot também pesquisa artigos do seu centro 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 uma IA que auxilia agentes mas nunca responde a clientes, crie um assistente e não o conecte a nenhuma caixa de entrada. Veja Configure um assistente Captain e conecte suas caixas de entrada. Usar o Copilot 1. Abra uma conversa. 2. À direita, abra a aba Copilot. 3. Escolha um atalho em Experimente estes prompts (Resumir esta conversa, Sugerir uma resposta, Avaliar esta conversa) ou digite sua própria solicitação. Fora de uma conversa, o 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 redigir uma resposta que você goste, clique em Usar esta para colocá-la na caixa de resposta. Edite, depois envie. 6. Clique em Redefinir para começar novamente. Teste Abra uma conversa real, escolha Sugerir uma resposta e verifique se o rascunho utiliza o conhecimento do seu produto. Obtenha valor - Seja específico: "Escreva uma resposta educada explicando o atraso e oferecendo entrega na sexta-feira" funciona melhor do que "responder". - Sempre leia um 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, orientações de resposta, proteções e FAQs. Sugerir uma resposta no editor de respostas utiliza apenas as FAQs (do assistente conectado à caixa de entrada ou todas as FAQs aprovadas na conta), não utiliza orientações ou tom. - Ações do editor como reformular e resumir são recursos de IA separados. - Para obter rótulos sugeridos ou uma prioridade para uma conversa, use Sugerir com Captain na barra lateral da conversa. Solucionar problemas Sintoma Causa provável O que fazer Sem aba Copilot Conta está no Hacker (gratuito), ou Captain não habilitado Veja Introdução ao Captain AI "Você está sem créditos do Copilot. Você pode comprar mais créditos na seção de cobrança." Sem créditos disponíveis Compre créditos em Cobrança 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: Solucionar problemas com o 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 a função por assistente. Configurar e experimentar Antes de começar - Um assistente. Veja Como configurar um assistente Captain e conectar suas caixas de entrada. Ativar memórias 1. Vá em Captain > Assistentes, abra o assistente e acesse 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. - Contextos como tamanho da equipe. Teste Tenha uma conversa onde você mencione uma preferência, por exemplo "Usamos o plano Pro e preferimos e-mail", e resolva a conversa. Depois, abra o contato e confira em Notas. Aproveite - As memórias aparecem nas Notas do contato com "Bot" como autor e o horário em que foram salvas. 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 tenha créditos. - Agentes podem excluir uma memória, mas não podem editá-la. - Informe aos clientes o que você armazena, de acordo com sua política de privacidade. Solução de problemas Sintoma Causa provável O que fazer Nenhuma nota aparece A opção está desativada, a conversa ainda não foi resolvida ou nada relevante surgiu Verifique a configuração; resolva a conversa Memórias pararam Créditos acabaram Veja Créditos de IA do Captain e uso Notas aparecem só para alguns contatos Apenas conversas resolvidas em caixas de entrada conectadas ao assistente criam memórias Esperado Mais causas: Solução de problemas do Captain.

Créditos e uso do Captain AI

Descubra O Captain utiliza créditos de IA. Todo plano pago inclui 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 recarga, estão em Preços & Planos > Créditos do Captain AI. Administradores visualizam o uso e compram créditos em Faturamento. Configuração & teste O que consome créditos Cada um desses itens consome um crédito: - Uma resposta do assistente para um cliente. - Uma mensagem no Playground do assistente. - Uma solicitação do Copilot. - Uma ação do editor, como reescrever, resumir ou sugerir resposta. - Uma transcrição de áudio. Adicionar documentos, aprovar FAQs, sugestões de rótulo e prioridade pelo Sugerir com o Captain, e condições do Captain em regras de automação não consomem créditos. Veja seu uso 1. Acesse Configurações > Faturamento. 2. Na seção Captain, veja os Créditos e Documentos utilizados. 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 será cobrado imediatamente. Créditos comprados: - São adicionados imediatamente e usados após os créditos mensais do seu plano. - Expiram após 6 meses. - Necessitam de uma assinatura ativa para serem usados. - Não são reembolsáveis. Teste Após a compra, confira 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 zera o uso. - Créditos mensais não utilizados não acumulam. Se você usar mais do que seus créditos mensais, o excedente 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 o mesmo. - Alterar o número de assentos não zera o uso. - Para fazer os créditos durarem mais: 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 desligue recursos de IA que você não utiliza, como transcrição. - Um banner avisa ao usar 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 é total para a conta. Não é separado por agente, assistente ou recurso. Para ver o desempenho de cada assistente, use o Visão Geral (Visão Geral e relatórios do Captain). Solução de problemas Sintoma Possível causa O que fazer Novas conversas vão direto para o time sem resposta do assistente Créditos acabaram Compre créditos ou aguarde a renovação 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 Copilot informa que você está sem créditos do Copilot Créditos acabaram Compre créditos ou aguarde a renovação O uso não foi para 0 após a compra Esperado. O uso só zera na renovação; a compra adiciona ao saldo Nenhuma ação necessária Créditos são consumidos mais rápido que o esperado O assistente está em caixas ocupadas, ou os recursos de IA são muito usados Restrinja o público ou o agendamento; desligue recursos desnecessários Não é possível comprar créditos Você não é administrador, ou não há assinatura ativa Peça para um administrador; verifique a assinatura Mais causas: Solução de problemas do Captain.

Ativar o Captain em hospedagem própria

Descubra Você pode executar 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 ter acesso ao console de Super Admin. A Community Edition 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 se você hospedar seu próprio modelo. - Opcional: uma chave de API do Firecrawl para uma melhor varredura de sites. Sem ela, o Chatwoot utiliza um crawler interno mais simples. 1. Configure o Captain para a instalação 1. Abra o console de Super Admin e vá em 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 o Copilot e recursos do editor. Deixe em branco para usar gpt-4.1-mini. O assistente utiliza gpt-5.2 por padrão. Para alterá-lo, 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 oferece 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. Ativar o Captain para uma conta Contas criadas enquanto sua instalação está nos planos Premium ou Enterprise já têm o Captain ativado. Para contas criadas antes disso: 1. No console de Super Admin, vá em Contas. 2. Abra a conta e clique em Editar. 3. Nos recursos premium, ative o Captain. Guardrails, diretrizes de resposta e cenários vêm junto. Para ferramentas personalizadas, ative também Ferramentas Personalizadas (Configurar ferramentas personalizadas para o Captain). 4. Salve. Teste Acesse essa conta. Captain aparece na barra lateral. Crie um assistente e envie uma mensagem no Playground. Veja Configure um assistente do Captain e conecte suas caixas de entrada. Aproveite - A OpenAI cobra pelo uso com a sua própria chave. O Chatwoot não contabiliza créditos do Captain em instalações auto-hospedadas. - Atualizando de uma versão antiga onde assistentes usavam o campo Instruções? Ele não é mais utilizado. Transfira as instruções para guardrails e diretrizes de resposta antes de atualizar (Defina guardrails, diretrizes e cenários do Captain). - Todo o resto funciona como na nuvem. Continue com Adicione documentos ao conhecimento do Captain. Solução de problemas Sintoma Causa provável O que fazer Capitão não aparece na barra lateral Não está ativado para a conta ou não é um plano Premium ou Enterprise Verifique ambos os passos; confira sua licença Sem Ferramentas Ferramentas Personalizadas desativadas para a conta Ative em Super Admin > Contas Assistente não responde Chave da OpenAI inválida ou inativa, ou nome de modelo não suportado Verifique a chave. Certifique-se de que o endpoint oferece 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 do Firecrawl, então o crawler simples é usado Adicione uma chave de API do FireCrawl Documentos do site não sincronizam Chave de API do Firecrawl inválida Verifique se a chave está válida. Se estiver configurada, o Chatwoot sempre usa o Firecrawl; uma chave inválida faz os documentos do site falharem. Remova a chave para usar o crawler interno. Ainda falhando Erro no servidor Verifique os logs web e dos workers

Solucionar Problemas, Capitão

Descobrir Use esta página quando o Captain estiver em silêncio, 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 requer Startups, Business ou Enterprise Preços e Planos. A maioria das correções precisa de um administrador. Configurar & testar: a verificação rápida Quando o assistente estiver em silêncio, verifique estes itens na ordem: 1. Plano: o Captain aparece na barra lateral? Se você ver Faça upgrade 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 nas Caixas de entrada do assistente? 4. Público: está definido como 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 é iniciada ou reaberta. Uma conversa em andamento mantém sua primeira decisão. 7. Status: o Captain responde apenas enquanto uma conversa está Pendente. Se estiver Aberta, o Captain fica em silêncio. Isso ocorre quando um agente respondeu, o assistente repassou, ou uma regra de automação atribuiu a conversa a alguém. O Captain não volta para uma conversa aberta, a menos que seja atribuída novamente ao assistente. Testar Inicie uma conversa totalmente nova, como um cliente que corresponda ao público, dentro do horário, em uma caixa de entrada conectada. Valor: silencioso versus falha - Silencioso: ausência total de resposta geralmente significa que uma das verificações acima impediu o Captain antes de ele começar. - Silencioso em certos 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 Tranferê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 repassa. Solucionar problemas Respostas Sintoma Causa provável O que fazer O assistente nunca responde Uma das verificações rápidas Siga a verificação rápida acima Responde para pessoas que você excluiu Os dados delas mudaram depois que a conversa começou Esperado; vale a partir da próxima conversa. Veja Controlar para quem e quando o Captain responde Responde fora do horário Horário comercial está desativado para a 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 à Chatwoot o que houve O assistente está em conversa que o público ou horário deveria pular Um agente atribuiu ao assistente pelo seletor de responsáveis Esperado. Atribua a uma pessoa para recuperar Responde perguntas fora do assunto Sem limites (guardrails) Adicione limites. Veja Definir limites, diretrizes e cenários do Captain Transfere com muita frequência Lacunas de conhecimento, ou ferramenta personalizada falhando Revise sugestões de FAQ; verifique Ferramentas Conversas resolvidas cedo demais Resolver sempre está configurado com espera curta Escolha Deixar o Captain revisar (recomendado) ou um tempo de espera maior Conhecimento Sintoma Causa provável O que fazer Documento mostra Falha ao sincronizar A página precisa de 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 Adicionou um site, mas nenhuma página aparece, ou respostas genéricas Seu robots.txt pode bloquear o rastreador. Libere o rastreador no 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 na conversa resolvida. É preciso ao menos uma resposta de agente. Ative. Veja Adicionar e revisar sugestões de FAQ no Captain Limite de documentos atingido A conta tem 2.000 documentos somando todos os assistentes Apague documentos não usados; veja Preços e Planos Ferramentas, Copilot e créditos Sintoma Causa provável O que fazer Ferramenta personalizada nunca usada Descrição vaga, ou ferramentas demais Veja Configurar ferramentas personalizadas para o Captain Mensagem de erro do Copilot Erro temporário, ou sem créditos Tente novamente; verifique créditos Créditos usados rapidamente Caixas de entrada movimentadas ou uso intenso de IA Veja Créditos e uso de IA do Captain Quando contatar o suporte Contate o suporte se a verificação rápida passar e o Captain ainda estiver em silêncio 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 a hora que aconteceu. - Se o assistente respondeu no Playground.

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

Voltar para Comece com o Captain AI. Descubra Cada assistente tem uma Visão Geral que mostra como está indo: quantas conversas lidou, quantas resolveu sozinho, por que transferiu e como os clientes o avaliaram. Plano & acesso: Startups, Business ou Enterprise Planos e Preços. Qualquer pessoa que pode abrir o Captain vê a Visão Geral. Somente administradores podem clicar em um número para ver as conversas por trás dele. Configurar & testar Antes de começar - Um assistente conectado a uma caixa de entrada que já tenha lidado com 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 nas quais o Captain respondeu ao cliente ou transferiu a conversa para sua equipe Taxa de auto-resolução A porcentagem das conversas atendidas que o Captain resolveu sem a ajuda da sua equipe. Quanto maior, melhor Taxa de transferência A porcentagem das conversas atendidas que o Captain passou para sua equipe Taxa de reabertura A porcentagem das conversas resolvidas pelo Captain que os clientes voltaram posteriormente. Quanto menor, melhor Resoluções do Captain permaneceram fechadas A porcentagem das conversas resolvidas pelo Captain que permanecem fechadas sete dias depois. Apenas resoluções com pelo menos sete dias são contadas Tempo mediano 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 em esforço e tempo do agente Uma estimativa, baseada em dois minutos economizados para cada resposta pública do Captain Os outros cartões - Resumo do Captain: um breve resumo escrito sobre como o assistente está indo. Aparece quando há atividade suficiente. - O fluxograma: como as conversas atendidas se dividem em Resolvidas pelo Captain, Transferidas e Fechadas com a equipe, e quantas dessas resoluções do Captain foram Reabertas em 7 dias ou Permaneceram fechadas. - Motivos da transferência: por que o Captain passou conversas para sua equipe: Solicitação do cliente, Conhecimento insuficiente, Solicitação não suportada, Restrição de política, Falha de ferramenta, Aguardando esclarecimento 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 média de avaliação dos clientes para Conversas resolvidas pelo Captain e Conversas assistidas pelo Captain, em comparação com conversas atendidas somente pela sua equipe. - Cobertura do conhecimento: FAQs aprovadas versus Sugestões de FAQs aguardando revisão. Clique em Revisar FAQs para ir à fila. - Uso: Créditos e Documentos utilizados pela 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 de transferência correspondem ao que aconteceu. Obtenha valor Use os motivos de transferência para decidir o que corrigir primeiro: Se este índice estiver alto Tente isto Conhecimento insuficiente 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 seus controles e cenários não estão muito rígidos. Veja Definir controles, 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 Frequentemente 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 resolvem o problema. Leia algumas conversas reabertas. - Economia em esforço e tempo do agente é uma estimativa, não uma medição. - Para relatórios de todos os bots da conta. Solucione problemas Sintoma Causa provável O que fazer "Não há dados disponíveis 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 "Ainda não há histórico suficiente" O assistente não tem dados tão antigos Escolha um período mais curto Resoluções do Captain permaneceram fechadas sem valor Nenhuma resolução no período tem sete dias ainda Esperado. Verifique novamente mais tarde Clicar em um número não faz nada Você não é um administrador Peça a um administrador Uma conversa aparece duas vezes na lista O Captain a atendeu em dois episódios separados Esperado Os números de uso parecem antigos O cartão não foi atualizado Clique em Atualizar uso Mais causas: Soluções 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.