Assistente de Email
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 o seu chatbot tem as instruções e o conhecimento adequados — prepara rascunhos de resposta diretamente na sua caixa de entrada.
O ChatReact nunca envia e-mails. Ele apenas cria rascunhos. Você sempre revisa e envia cada resposta pessoalmente. Tecnicamente, o ChatReact nem sequer solicita permissão para enviar e-mail.
Requisitos
- Plano ChatReact Professional ou superior
- Um chatbot com uma base de conhecimento preenchida (o chatbot responde aos e-mails, portanto precisa conhecer o seu negócio)
- Uma caixa de correio que seja hospedada pela Microsoft — veja a seção seguinte, este é o obstáculo mais comum
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 muitos provedores diferentes, mas o ChatReact conecta-se à própria caixa de correio — e isso só funciona quando a Microsoft hospeda a caixa de correio.
Estes funcionam:
- ✅ Caixas de correio Microsoft 365 business (também chamadas Exchange Online) — incluindo endereços com seu próprio domínio, ex.:
[email protected], desde que seu e-mail esteja no Microsoft 365 - ✅ Contas pessoais Microsoft — endereços terminados em
@outlook.com,@hotmail.comou@live.com
Estes NÃO funcionam:
- ❌ Endereços que são apenas adicionados ao app Outlook via IMAP/POP — ex.: um Gmail, GMX ou um endereço de hospedagem web que você lê no Outlook. O e-mail em si está armazenado no outro provedor, então a Microsoft não pode conceder acesso ao ChatReact.
- ❌ Gmail / Google Workspace (o suporte está no nosso roadmap)
- ❌ Servidores Exchange self-hosted (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 a sua caixa de correio abrir lá, 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 ao provedor de hospedagem onde seu e-mail está hospedado.
Conectando sua caixa de correio, passo a passo
Passo 1: Abra o Assistente de Email
Entre no ChatReact e clique em Assistente de Email na barra lateral esquerda. Se a entrada mostrar um ícone de cadeado, o 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 a esta caixa de correio em Chatbot that powers this mailbox. A base de conhecimento, as instruções e a personalidade dele (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 insere somente na Microsoft.
Passo 4: Faça login com a conta correta
Este é o erro mais comum: faça login com a caixa de correio que deseja conectar — não com sua conta Microsoft pessoal.
- Se a Microsoft já mostrar uma lista de contas, escolha a correta.
- Se a caixa de correio não estiver listada, clique em "Use another account" e insira o endereço (ex.:
[email protected]) e sua senha.
A conta com a qual você fizer login será a caixa de correio que será conectada.
Passo 5: Aceite as permissões
A Microsoft mostra quais permissões o ChatReact solicita: leitura dos seus e-mails, criação de rascunhos, organização de pastas e categorias. Observe o que não está na lista — envio de e-mails. Clique em Accept.
Passo 6: Se você vir "Approval required"
Em muitas empresas, os funcionários não podem aprovar aplicativos 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 formas de resolver:
- Um administrador conecta primeiro: peça ao administrador do Microsoft 365 que siga estes mesmos passos uma vez. Na tela de permissões ele pode marcar "Consent on behalf of your organization" — depois disso, todo funcionário poderá conectar sua caixa de correio sem aprovação adicional. (Se a própria caixa de correio do administrador for conectada no processo e isso não for desejado, basta desconectá-la no ChatReact depois — veja abaixo.)
- Aprovação no centro de administração: alternativamente, o administrador abre o Microsoft Entra admin center, procura pelo app ChatReact em Enterprise applications e concede o consentimento de administrador lá.
Depois, 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". O cartão de conexão mostrará o endereço da caixa de correio e o status Active. O ChatReact também criou um conjunto de categorias iniciais (ex.: To Respond, FYI, Newsletters) que você pode renomear, excluir ou ampliar a qualquer momento.
O que acontece após a conexão
- O ChatReact processa apenas os e-mails que chegam após a conexão ser realizada. Seu histórico de caixa de entrada existente nunca é tocado.
- Novos e-mails são coletados automaticamente a cada poucos minutos, categorizados e marcados ou arquivados no Outlook.
- Um rascunho de resposta é criado somente quando todas estas condições são verdadeiras: a categoria permite rascunhos, a criação de rascunhos está ativada para a conexão, o e-mail é uma consulta genuína, seu chatbot tem pelo menos uma instrução ativa para o canal de email, e sua base de conhecimento cobre de fato a pergunta. Caso contrário, o ChatReact propositalmente pula a criação do rascunho — a lista de Activity sempre mostra o que foi feito e por quê.
Nenhum rascunho aparecendo? Verifique a lista de Activity na página do Assistente de Email. As razões mais frequentes são a falta de uma instrução para e-mail (adicione uma em Knowledge Base → Instructions com o canal "Email") ou uma base de conhecimento vazia.
Resolvendo problemas comuns
| Problem | Solution |
|---|---|
| Connected the wrong mailbox | Clique em Disconnect no cartão de conexão, depois conecte novamente e escolha "Use another account" na página de login da Microsoft. |
| Status shows Reconnect required | A Microsoft invalidou o acesso salvo (ex.: após uma mudança de senha). Clique em Reconnect e faça login novamente. Suas categorias e histórico são mantidos. |
| "Approval required" during sign-in | Veja o Passo 6 acima — o administrador do seu Microsoft 365 precisa aprovar o app uma vez. |
| Emails are not being processed | Apenas o correio recebido após a conexão é processado, com um atraso de alguns minutos. Verifique também se o status da conexão está Active e não Paused. |
| Sign-in fails entirely | Verifique se a caixa de correio 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; o conteúdo dos e-mails é processado de forma transitória e não é armazenado permanentemente pelo ChatReact. Apenas remetente, assunto e o resultado da categorização aparecem no registro de atividade.
- Desconectar uma caixa de correio exclui o acesso armazenado imediatamente. Seus e-mails no Outlook nunca são afetados.