InícioDocumentação

Email Assistant

O Assistente de Email conecta uma caixa de correio a um dos seus chatbots. O ChatReact então classifica automaticamente os e-mails recebidos em categorias e — quando seu chatbot tiver as instruções e o conhecimento adequados — prepara rascunhos de resposta diretamente na sua caixa de entrada.

O Assistente de Email nunca envia suas respostas. Ele apenas cria rascunhos. Você sempre revisa e envia cada resposta pessoalmente. Isto é separado dos e-mails de login e de notificação do ChatReact.

Requisitos

  • Plano ChatReact Professional ou superior
  • Um chatbot com uma base de conhecimento preenchida (o chatbot responde aos e-mails, portanto precisa conhecer seu negócio)
  • Uma caixa de correio que esteja hospedada na Microsoft — veja a próxima seção, este é o obstáculo mais comum

O número de caixas de correio que você pode conectar depende do seu plano: Professional permite 1 caixa, Enterprise e Agency Starter permitem 3, Agency Pro permite 10, e Agency Business permite 25. Ao atingir seu limite, o cartão "Connect a mailbox" fica oculto até você fazer um upgrade ou desconectar uma caixa existente.

Quais endereços de e-mail funcionam?

Isto é importante: não basta que um endereço apareça no seu app do Outlook. O app do Outlook pode exibir caixas de correio de vários provedores, mas o ChatReact se conecta à própria caixa — e isso só funciona quando a Microsoft hospeda a caixa de correio.

Estes funcionam:

  • ✅ Caixas Microsoft 365 business (também chamadas Exchange Online) — incluindo endereços com seu próprio domínio, por exemplo [email protected], contanto que seu e-mail rode no Microsoft 365
  • ✅ Contas pessoais Microsoft — endereços terminando em @outlook.com, @hotmail.com ou @live.com

Estes NÃO funcionam:

  • ❌ Endereços que são apenas adicionados ao app do Outlook via IMAP/POP — por exemplo, um Gmail, GMX ou endereço de hospedagem web que você lê no Outlook. O e-mail em si fica armazenado no outro provedor, então a Microsoft não pode conceder ao ChatReact acesso a ele.
  • ❌ Gmail / Google Workspace (suporte está no nosso roadmap)
  • ❌ Servidores Exchange auto-hospedados (on-premises) que não estejam conectados ao Microsoft 365

Não tem certeza? Faça este teste de 30 segundos: abra outlook.office.com no seu navegador e entre com o endereço de e-mail que deseja conectar. Se sua caixa abrir ali, ela está hospedada na Microsoft e funcionará com o ChatReact. Se o login falhar ou seu e-mail não estiver lá, pergunte ao seu parceiro de TI ou provedor de hospedagem onde seu e-mail é hospedado.

Conectando sua caixa de correio, passo a passo

Passo 1: Abra o Assistente de Email

Entre no ChatReact e clique em Assistente de E-mail na barra lateral esquerda. Se a entrada mostrar um ícone de cadeado, seu plano atual ainda não inclui o recurso.

Passo 2: Escolha o chatbot

Se você tiver mais de um chatbot, escolha aquele que deve responder por esta caixa em Chatbot responsável por esta caixa de correio. Sua base de conhecimento, instruções e personalidade (incluindo tratamento formal/informal) serão usadas para os rascunhos de resposta.

Passo 3: Clique em "Connect Outlook"

Você será redirecionado para a página oficial de login da Microsoft (login.microsoftonline.com). O ChatReact nunca vê sua senha — você a digita apenas na Microsoft.

Passo 4: Entre com a conta correta

Este é o erro mais comum: entre com a caixa de correio que deseja conectar — não com sua conta Microsoft privada.

  • Se a Microsoft já mostrar uma lista de contas, escolha a correta.
  • Se a caixa não estiver listada, clique em "Use another account" e digite o endereço (por exemplo [email protected]) e sua senha.

A conta com a qual você entrar será a caixa que será conectada.

Passo 5: Aceite as permissões

A Microsoft mostra quais permissões o ChatReact solicita: ler seus e-mails, criar rascunhos, organizar pastas e categorias. Observe o que não está na lista — envio de e-mail. Clique em Accept.

Passo 6: Se você ver "Approval required"

Em muitas empresas, funcionários não têm permissão para aprovar apps por conta própria. A Microsoft então mostra uma mensagem como "Approval required" ou "This app requires your admin's approval". Isso é uma configuração de segurança da sua empresa, não um erro.

Duas maneiras de resolver:

  1. Um administrador conecta primeiro: peça ao administrador do Microsoft 365 da sua organização que execute esses mesmos passos uma vez. Na tela de permissões ele pode marcar "Consent on behalf of your organization" — depois disso, qualquer funcionário pode conectar sua caixa sem aprovação adicional. (Se a própria caixa do admin ficar conectada no processo e isso não for desejado, basta desconectá-la no ChatReact depois — veja abaixo.)
  2. Aprovação no centro de administração: alternativamente, o administrador abre o Microsoft Entra admin center, procura o app ChatReact em Enterprise applications e concede o consentimento de administrador ali.

Em seguida, repita a conexão a partir do Passo 3.

Passo 7: Concluído — verifique o resultado

Você será redirecionado de volta ao ChatReact e verá a mensagem "Mailbox connected successfully". Seu cartão de conexão mostra o endereço da caixa e o status Ativa. O ChatReact também criou um conjunto de categorias iniciais (por exemplo To Respond, FYI, Newsletters & Marketing, Notifications, Suspected Spam) que você pode renomear, excluir ou estender a qualquer momento.

O que acontece depois de conectar

  • Novas conexões de caixa começam com ambas as funcionalidades desligadas: Categorizar & organizar emails e Criar rascunhos de resposta. Uma conexão Ativa por si só não começa a ler ou processar e-mails.
  • Configure suas categorias e instruções, então ative explicitamente a funcionalidade que deseja. O processamento começa com e-mails recebidos após a ativação, não com mensagens que chegaram enquanto ambos os interruptores estavam desligados.
  • Uma vez ativado, novos e-mails são capturados a cada poucos minutos. Categorização, marcação, movimentação e rascunhos dependem das funcionalidades ativadas, das ações das categorias e da confiança da classificação.
  • O que acontece com um e-mail é decidido pelas ações de sua categoria (veja a próxima seção).
  • Um rascunho de resposta é criado apenas quando All destas condições são verdadeiras: a categoria possui a ação Criar rascunho de resposta com seu próprio Instruções, a criação de rascunhos está habilitada para a conexão, o e-mail é uma consulta genuína e a base de conhecimento do seu chatbot realmente cobre a pergunta. Caso contrário, o ChatReact deliberadamente pula o rascunho — a lista Atividade sempre mostra o que foi feito e por quê.

Pausando a organização ou a criação de rascunhos

Cada caixa conectada tem dois interruptores independentes no cartão de conexão:

  • Categorizar & organizar emails — ativa ou desativa a categorização automática e o arquivamento no Outlook
  • Criar rascunhos de resposta — ativa ou desativa a criação de rascunhos de resposta

Desative qualquer um deles para pausar essa parte do Assistente de Email para uma caixa sem desconectá-la.

Use Pausar e Retomar para pausar ou retomar toda a conexão. Reconectar renova a autorização mas não retoma uma caixa que você pausou deliberadamente. Verifique o endereço da caixa, ambos os interruptores, o status da conexão e Last sync ao solucionar problemas.

Não aparecem rascunhos? Verifique a lista de Atividade na página do Assistente de Email. As razões mais frequentes são instruções de rascunho ausentes na categoria (edite a categoria → Criar rascunho de resposta → adicione instruções), uma base de conhecimento vazia, ou ter alcançado a cota mensal de rascunhos do seu plano — quando isso acontece, a lista de Atividade mostra "Draft quota reached" junto com a contagem usado/limite.

Categorias: regras com ações

Cada categoria é uma regra composta por duas partes:

  • Quando — a descrição decide quais e-mails pertencem a essa categoria. O ChatReact classifica cada e-mail recebido em exatamente uma categoria. Quanto mais precisa a descrição, melhor a classificação.
  • O que — os Ações decidem o que acontece com esses e-mails. Podem ser combinados livremente:
ActionWhat it does
Marcar no OutlookAplica o nome da categoria como uma categoria colorida do Outlook.
Mover para pastaMove o e-mail para uma pasta da sua caixa — uma subpasta da caixa de entrada, uma de suas próprias pastas, o arquivo, lixo eletrônico ou a lixeira. Você pode criar uma nova pasta da caixa de entrada diretamente no seletor de pastas.
Criar rascunho de respostaCria um rascunho de resposta no thread — seguindo o Instruções que você definiu para a categoria.

As ações sempre são executadas nesta ordem: marcar → rascunhar → mover.

Lixeira: e-mails só são movidos para a lixeira quando a IA tem alta confiança na categoria. Confiança menor também pode impedir marcação, movimentação ou rascunho; Atividade explica ações retidas. Nada é excluído permanentemente. Lixeira e rascunhos de resposta não podem ser combinados.

Instruções para rascunhos de resposta

Os fatos de um rascunho vêm sempre da base de conhecimento do seu chatbot. As instruções de uma categoria descrevem como e-mails desse tipo devem ser respondidos: tom, estrutura, próximo passo — e o que a IA não deve fazer (por exemplo "nunca citar preços" ou "nunca confirmar um compromisso").

  • Sem instruções, sem rascunho. A categoria então mostra "Draft instructions missing".
  • Insert template oferece instruções comprovadas, por exemplo para consultas de serviço, pedidos de orçamento, solicitações de agendamento, pedidos de suporte ou candidaturas — adapte-as às suas necessidades.
  • Opcionalmente adicione uma resposta de exemplo. Ela é usada apenas como modelo de tom, comprimento e estrutura; fatos nunca são retirados dela.

Regras gerais para todos os rascunhos

Regras que devem ser aplicadas a todo rascunho — e normalmente ao chat também — são criadas em Base de Conhecimento → Instruções com Applies to: Chat + Email. O cartão Regras gerais para todos os rascunhos na página do Assistente de Email as lista. Se uma regra geral e uma instrução de categoria entrarem em conflito, a instrução da categoria prevalece.

Instruções costumavam ter um canal "Email only". Elas foram movidas automaticamente para suas categorias com rascunhos de resposta habilitados (por exemplo "To Respond") e agora aparecem ali como instruções de rascunho.

Configurando uma assinatura

O cartão Assinatura permite que você projete o bloco anexado abaixo de cada rascunho de resposta — com logotipo, links e formatação. Ao conectar uma caixa, o ChatReact gera automaticamente uma assinatura padrão a partir dos dados da sua empresa (nome da empresa, site vinculado e logotipo).

  • O modo Visual permite editar a assinatura diretamente; o botão Imagem insere uma imagem via URL ou upload (imagens carregadas são automaticamente cortadas, redimensionadas e comprimidas).
  • O modo HTML permite colar uma assinatura existente em HTML — incluindo layouts em tabela — com uma pré-visualização ao vivo mostrada abaixo do editor.
  • Uma vez definida a assinatura, a IA encerra seu rascunho com uma linha de fechamento e deixa a assinatura final para o bloco definido.

Contatos: o que o assistente lembra

O ChatReact constrói automaticamente um perfil para cada remetente: nome, empresa, status de cliente (Customer, Prospect, Supplier, etc.), se é tratado formal ou informalmente, e fatos individuais relevantes. Essas informações alimentam todos os futuros rascunhos de resposta — incluindo a escolha da forma de tratamento correta para esse contato.

Abra Contatos para visualizar e editar todos os perfis. Suas edições manuais têm sempre prioridade e nunca são sobrescritas pela IA. Você também pode adicionar notas internas, que são usadas como contexto para rascunhos, mas nunca são citadas diretamente.

Solucionando problemas comuns

ProblemSolution
Connected the wrong mailboxClique em Desconectar no cartão de conexão, então conecte novamente e escolha "Use another account" na página de login da Microsoft.
Status shows Reconexão necessáriaA Microsoft invalidou o acesso salvo (por exemplo, após alteração de senha). Clique em Reconectar e entre novamente. Suas categorias e histórico são mantidos.
"Approval required" during sign-inVeja o Passo 6 acima — o administrador do Microsoft 365 da sua organização precisa aprovar o app uma vez.
Emails are not being processedSomente o correio recebido após a conexão é processado, com um atraso de alguns minutos. Verifique também se o status da conexão é Ativa e não Em pausa.
Sign-in fails entirelyVerifique se a caixa está realmente hospedada na Microsoft (veja "Quais endereços de e-mail funcionam?" acima).

Privacidade

  • O ChatReact cria apenas rascunhos e não pode enviar e-mails — a permissão de envio nunca é solicitada.
  • Tokens de acesso são armazenados criptografados; conteúdos de e-mail são processados de forma transitória e não são armazenados permanentemente pelo ChatReact. Apenas remetente, assunto e o resultado da categorização aparecem no registro de atividade.
  • Desconectar uma caixa exclui imediatamente o acesso armazenado junto com as categorias e o registro de atividade dessa conexão. Seus e-mails no Outlook nunca são afetados.
  • Entradas do registro de atividade são excluídas automaticamente 30 dias após a chegada do e-mail.