Integracao de Email

Configure a integracao de email para converter mensagens recebidas em tickets automaticamente.

Visao Geral

O Defender360 suporta tres metodos de integracao de email:

Email para Ticket

Fluxo de Conversao

1. Email recebido em suporte@empresa.com
        │
        ▼
2. Defender360 processa o email
        │
        ├── Novo remetente? → Cria ticket novo
        │
        └── Resposta a ticket? → Adiciona comentario
        │
        ▼
3. Ticket criado/atualizado
        │
        ▼
4. Notificacao enviada ao cliente

Identificacao de Respostas

O sistema identifica respostas atraves de:

• Tag no assunto: [TKT-0042]
• Reference-ID no header do email
• Codigo no corpo do email

Configuracao IMAP

Pre-requisitos

• Servidor IMAP acessivel
• Conta de email dedicada (ex: suporte@empresa.com)
• Credenciais de acesso
• Porta IMAP (993 para SSL, 143 para STARTTLS)

Configurar Conexao

1. Acesse Configuracoes > Integracoes > Email
2. Clique em Configurar IMAP
3. Preencha os campos:

4. Clique em Testar Conexao
5. Se bem sucedido, clique em Salvar

Intervalo de Verificacao

Configure a frequencia de polling:

Configuracao Microsoft Graph

Pre-requisitos

• Tenant Microsoft 365
• Acesso ao Azure AD
• Permissoes de administrador

Registrar Aplicacao no Azure

1. Acesse Azure Portal 
2. Navegue para Azure Active Directory > App registrations
3. Clique em New registration
4. Configure:
   • Nome: Defender360 Email Integration
   • Supported account types: Single tenant
   • Redirect URI: https://app.defender360.com/oauth/callback
5. Anote o Application (client) ID
6. Crie um Client Secret

Configurar Permissoes

Adicione as permissoes necessarias:

Conectar ao Defender360

1. Acesse Configuracoes > Integracoes > Email
2. Clique em Configurar Microsoft 365
3. Preencha:

4. Clique em Autorizar
5. Faca login com conta admin
6. Aceite as permissoes
7. Clique em Salvar

Configuracao Gmail API

Pre-requisitos

• Google Workspace (nao funciona com Gmail pessoal)
• Acesso ao Google Cloud Console
• Permissoes de administrador do Workspace

Criar Projeto no Google Cloud

1. Acesse Google Cloud Console 
2. Crie um novo projeto
3. Ative a Gmail API
4. Configure a tela de consentimento OAuth
5. Crie credenciais OAuth 2.0

Configurar Credenciais

1. Em APIs & Services > Credentials
2. Clique em Create Credentials > OAuth client ID
3. Tipo: Web application
4. Redirect URI: https://app.defender360.com/oauth/callback
5. Baixe o arquivo JSON

Conectar ao Defender360

1. Acesse Configuracoes > Integracoes > Email
2. Clique em Configurar Gmail
3. Faca upload do arquivo de credenciais
4. Clique em Autorizar
5. Faca login com conta do Workspace
6. Aceite as permissoes
7. Clique em Salvar

Regras de Processamento

Mapeamento de Campos

Configure como campos do email mapeiam para o ticket:

Prioridade Automatica

Defina palavras-chave para priorizar:

Categoria por Assunto

Mapeie palavras do assunto para categorias:

"senha" → Categoria: Acesso
"impressora" → Categoria: Hardware
"lento" → Categoria: Performance
"erro" → Categoria: Software

Configurar Regras

1. Acesse Integracoes > Email > Regras
2. Clique em Nova Regra
3. Defina condicao (assunto contem, remetente e, etc.)
4. Defina acao (categoria, prioridade, atribuir)
5. Clique em Salvar

Emails de Saida

Configurar SMTP

Para enviar respostas e notificacoes:

1. Acesse Integracoes > Email > SMTP
2. Configure:

3. Teste enviando email de teste
4. Salve a configuracao

Templates de Email

Personalize os emails enviados:

Editar Templates

1. Acesse Integracoes > Email > Templates
2. Selecione o template
3. Edite o conteudo usando variaveis:

Olá {{customer_name}},
 
Seu chamado #{{ticket_number}} foi atualizado.
 
Status: {{ticket_status}}
Prioridade: {{ticket_priority}}
 
Última atualização:
{{last_comment}}
 
Acompanhe em: {{ticket_url}}
 
Atenciosamente,
{{agent_name}}
Equipe de Suporte

Anexos

Limites

Tipos de Arquivo

Configure quais extensoes sao aceitas:

# Imagens
.png, .jpg, .jpeg, .gif

# Documentos
.pdf, .doc, .docx, .xls, .xlsx

# Compactados
.zip, .rar

# Bloquear
.exe, .bat, .cmd, .scr

Anti-Spam

Filtros Automaticos

O sistema filtra:

• Emails de enderecos bloqueados
• Mensagens automaticas (auto-reply)
• Spam detectado (se habilitado)
• Loops de email

Configurar Blacklist

Bloqueie remetentes ou dominios:

1. Acesse Integracoes > Email > Blacklist
2. Adicione enderecos:

# Email especifico
spam@exemplo.com

# Dominio inteiro
@spammer.com

# Padrao wildcard
*@*.spam.com

Evitar Loops

O sistema previne loops de email:

• Nao responde a auto-replies
• Limita respostas por ticket/hora
• Detecta ciclos de resposta

Monitoramento

Dashboard de Email

Visualize metricas:

Logs

Acesse logs detalhados:

1. Integracoes > Email > Logs
2. Filtre por data, status, remetente
3. Visualize detalhes de cada email

Troubleshooting

Boas Praticas

Proximos Passos