Integração de E-mail
Configure contas de e-mail IMAP/SMTP para receber e enviar mensagens automaticamente, transformando e-mails em tickets.
Fluxo E-mail → Ticket#
O processo completo de transformar um e-mail em ticket segue este fluxo:
📧 E-mail recebido
na caixa INBOX
🔍 IMAP Poll
a cada 2 minutos
🤖 IA Classifica
extrai dados + fila
📋 Ticket criado
na fila classificada
Lista de Contas de E-mail#
Atendimento Endotech
atendimento@endotech.com.br
Gmail • Fila: Triagem
Faturamento Endotech
faturamento@endotech.com.br
Outlook • Fila: Faturamento
Comercial Endotech
comercial@endotech.com.br
Senha de app expirada
Configurando Conta de E-mail#
Conta de E-mail
Configuração IMAP (Recebimento)
Configuração SMTP (Envio)
Configuração Gmail#
IMAP (Gmail)
- Servidor: imap.gmail.com
- Porta: 993
- TLS: SSL/TLS
SMTP (Gmail)
- Servidor: smtp.gmail.com
- Porta: 587
- TLS: STARTTLS
Como gerar senha de aplicativo no Gmail
- Acesse myaccount.google.com/security
- Ative verificação em 2 etapas (se não estiver)
- Vá em "Senhas de app"
- Gere senha para "E-mail" / "Outro (nome: Endotech)"
- Copie a senha de 16 caracteres e use no sistema
Configuração Outlook#
IMAP (Outlook/Microsoft 365)
- Servidor: outlook.office365.com
- Porta: 993
- TLS: SSL/TLS
SMTP (Outlook/Microsoft 365)
- Servidor: smtp.office365.com
- Porta: 587
- TLS: STARTTLS
Como gerar senha de aplicativo no Outlook
- Acesse account.microsoft.com/security
- Vá em "Opções de segurança avançadas"
- Clique em "Senhas de aplicativo"
- Crie nova senha de app para "Endotech IMAP"
- Use essa senha no sistema
Padrões de Roteamento por E-mail#
Crie regras automáticas para rotear e-mails baseado em remetente, domínio, assunto ou corpo da mensagem:
Regras com prioridade menor são avaliadas primeiro.
Ordem de prioridade
As regras são avaliadas na ordem de prioridade. A primeira regra que corresponder ao e-mail é aplicada. Se nenhuma regra corresponder, o agente de IA faz a classificação.
Ações disponíveis
- Roteamento para fila: E-mail vai direto para a fila, sem passar pela IA
- Definir prioridade: Marca o ticket com prioridade (urgente, alta, normal, baixa)
- Ignorar: E-mail é descartado (não cria ticket) — útil para newsletters e spam
Rastreabilidade de Respostas#
Quando um operador responde a um ticket, o sistema envia um e-mail ao cliente com headers e formato especiais para rastrear a conversa:
Reply-To: ticket@endotech.com.br
Quando o cliente responde, o e-mail vai para a caixa monitorada e é automaticamente vinculado ao ticket existente.
Token [Ticket #NNNNNN] no assunto
Assunto do e-mail inclui o número do ticket (ex: [Ticket #000042] Re: Segunda via de NF). Quando o cliente responde mantendo o assunto, o sistema usa esse token para vincular ao ticket correto.
Headers X-Endotech-*
Headers customizados são adicionados em cada resposta:
X-Endotech-Queue: Faturamento
X-Endotech-Created-At: 2026-05-09T10:30:00Z
Importação de Caixa Postal (Backfill)#
Use a página /admin/inbox-backfill para importar e-mails históricos de uma caixa postal e transformá-los em tickets retroativamente.
Acesse a página de importação
Avatar → Administração → Inbox Backfill
Selecione a conta de e-mail
Escolha entre as contas já configuradas no sistema.
Defina o intervalo de datas
Escolha a partir de qual data importar. Evite importar e-mails muito antigos se não forem relevantes.
Confirme e inicie
O sistema começa a importar e processar cada e-mail. A IA classifica automaticamente, como com e-mails novos.
Importação em andamento
Processando...247 de 412 e-mails processados
60%
198
Classificados
32
Exceções
17
Erros
Webhook para Processamento de Entrada#
O processamento de e-mails pode ser acionado por polling IMAP ou por webhook. O webhook é ideal quando o provedor de e-mail suporta notificações push.
Fluxo com webhook
- Provedor de e-mail recebe nova mensagem
- Provedor envia notificação POST para o webhook do Endotech
- Sistema recebe payload e processa imediatamente (sem esperar polling)
- IA classifica e cria ticket
Erros Comuns de Conexão#
❌ Autenticação falhou
Senha de app incorreta ou verificação em 2 etapas desativada. Gere uma nova senha de aplicativo.
❌ Conexão recusada
Porta ou servidor incorretos. Verifique se o endereço IMAP/SMTP está correto para seu provedor.
❌ SSL error
Use porta 993 (IMAP) com SSL/TLS e porta 587 (SMTP) com STARTTLS. Combinações erradas causam este erro.
❌ Timeout
Firewall bloqueando conexão de saída nas portas 993 ou 587. Verifique com a equipe de infraestrutura.
❌ "Less secure apps" (Gmail)
Gmail pode bloquear acesso. Sempre use senha de aplicativo, não a senha normal da conta.
✅ Resumo
- ✓ Configure IMAP para receber, SMTP para enviar
- ✓ Use senhas de aplicativo, nunca senhas normais
- ✓ Gmail: imap.gmail.com:993 / smtp.gmail.com:587
- ✓ Outlook: outlook.office365.com:993 / smtp.office365.com:587
- ✓ Respostas incluem Reply-To, [Ticket #NNNNNN] e headers X-Endotech-*
- ✓ Padrões de roteamento por domínio, endereço, assunto ou corpo
- ✓ Importe e-mails históricos via Inbox Backfill
- ✓ Teste conexão IMAP e SMTP antes de ativar