Configuração de E-mail

A Configuração de E-mail do Sincroniza permite personalizar como endereços de e-mail são gerados quando licenças do Exchange são provisionadas para usuários no Entra ID.

O que é?

Quando uma licença do Exchange é atribuída a um usuário no Entra ID, a Microsoft define automaticamente o endereço de e-mail como sendo igual ao UPN (User Principal Name). Embora isso funcione para muitas organizações, empresas que precisam de um padrão de e-mail diferente — como nome.sobrenome@empresa.com — precisam de controle sobre a geração desses endereços.

A Configuração de E-mail permite:

• Definir uma estratégia de padrão para gerar a parte local do e-mail (antes do @)
• Configurar o domínio principal e um domínio de alias opcional
• Excluir partículas comuns de nomes brasileiros (da, de, dos, etc.)
• Resolver conflitos automaticamente quando o endereço gerado já existe
• Controlar o comportamento na remoção de licença do Exchange

Recurso Premium

A Configuração de E-mail está disponível apenas com a licença Premium do Sincroniza. Além disso, é necessário ter o Entra ID configurado como provedor de identidade.

Quando é Utilizado?

O recurso é acionado automaticamente quando:

1. Uma licença do Exchange é atribuída a um usuário via Pacotes de Atribuição
2. O sistema precisa definir o endereço de e-mail antes ou após o provisionamento da licença
3. A estratégia configurada é diferente de UseUPN (padrão Microsoft)

Se a estratégia for UseUPN, nenhuma ação adicional é necessária — a Microsoft define o e-mail automaticamente.

Estratégias de Padrão

A estratégia define como a parte local do e-mail (antes do @) é gerada:

Estratégia	Exemplo	Descrição
UseUPN (padrão)	joao.silva@empresa.com	Microsoft define automaticamente (e-mail = UPN)
FirstNameDotLastName	joao.silva@empresa.com	Nome ponto sobrenome
FirstInitialLastName	jsilva@empresa.com	Inicial do nome + sobrenome
LastNameFirstInitial	silvaj@empresa.com	Sobrenome + inicial do nome
FirstNameLastInitial	joaos@empresa.com	Nome + inicial do sobrenome
EmployeeNumber	12345@empresa.com	Número de matrícula do funcionário
CustomPattern	Configurável	Padrão personalizado com placeholders

Placeholders para CustomPattern

Ao usar a estratégia CustomPattern, os seguintes placeholders estão disponíveis:

Placeholder	Descrição	Exemplo
{firstName}	Primeiro nome	joao
{lastName}	Último sobrenome	silva
{firstInitial}	Inicial do primeiro nome	j
{lastInitial}	Inicial do sobrenome	s
{employeeNumber}	Matrícula do funcionário	12345

Exemplo de padrão personalizado: {firstName}.{lastName}.{employeeNumber} → joao.silva.12345@empresa.com

Domínio e Alias

Domínio Principal

O domínio principal é utilizado para gerar o endereço de e-mail primário (SMTP:):

joao.silva@empresa.com  ← Domínio principal

Domínio de Alias

Opcionalmente, um domínio de alias pode ser configurado para criar um endereço secundário (smtp:):

SMTP: joao.silva@empresa.com       ← Endereço principal
smtp: joao.silva@subsidiaria.com   ← Alias (opcional)

O alias é útil para organizações com múltiplos domínios, permitindo que funcionários recebam e-mails em ambos.

Exclusão de Partículas

Nomes brasileiros frequentemente contêm partículas que não devem fazer parte do endereço de e-mail. O sistema exclui por padrão:

da, de, do, dos, das, e, filho, junior, neto, sobrinho

Exemplo:

Nome completo: João da Silva Neto
Após exclusão:  João Silva
E-mail gerado:  joao.silva@empresa.com  (não joao.da.silva.neto@empresa.com)

Partículas podem ser adicionadas ou removidas conforme necessário na configuração.

Resolução de Conflitos

Quando o endereço de e-mail gerado já existe no Entra ID, o sistema utiliza uma das três estratégias de resolução:

NumericSuffixThenApproval (Padrão)

Tenta adicionar sufixos numéricos até o limite configurado. Se esgotar as tentativas, a ação de e-mail falha e fica visível na página de Ações para resolução manual.

flowchart TD
    GERADO["joao.silva@empresa.com<br>Endereço gerado"] --> CONFLITO["Conflito detectado!"]
    CONFLITO --> TENT1["joao.silva1@empresa.com<br>Tentativa 1"]
    TENT1 --> TENT2["joao.silva2@empresa.com<br>Tentativa 2"]
    TENT2 --> MAIS["..."]
    MAIS -->|se esgotar tentativas| FALHA["Ação de e-mail falha<br>Resolução manual necessária"]

    classDef startEnd fill:#e1f5fe,stroke:#01579b,stroke-width:2px,color:#1a1a1a
    classDef process fill:#f3e5f5,stroke:#4a148c,stroke-width:2px,color:#1a1a1a
    classDef result fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px,color:#1a1a1a
    class GERADO startEnd
    class CONFLITO,TENT1,TENT2,MAIS process
    class FALHA result

O número máximo de tentativas é configurável (padrão: 10).

AlwaysApproval

Qualquer conflito faz a ação de e-mail falhar imediatamente para resolução manual, sem tentativas de sufixo numérico.

SkipAndNotify

O provisionamento do e-mail é pulado e o administrador é notificado para resolver manualmente.

Modos de Aprovação

O modo de aprovação controla quando a intervenção humana é necessária:

Modo	Descrição
Automatic	Nenhuma aprovação necessária. E-mail é provisionado automaticamente.
OnConflictOnly (padrão)	Aprovação apenas quando há conflito de endereço e a resolução automática falha.
AlwaysRequireApproval	Toda atribuição de e-mail requer aprovação antes da execução.

Remoção de Licença

Quando uma licença do Exchange é removida de um usuário, o sistema pode se comportar de diferentes formas:

Comportamento	Descrição
RetainEmail (padrão)	Mantém o endereço de e-mail mesmo após remoção da licença.
ClearPrimary	Remove o atributo mail principal, mas mantém proxyAddresses.
RequireApproval	Qualquer remoção requer aprovação de um administrador.

Boas Práticas

Recomendações

1. Use FirstNameDotLastName para empresas brasileiras: É o padrão mais comum e intuitivo para o público brasileiro.

2. Mantenha as partículas padrão: A lista padrão cobre os casos mais comuns da língua portuguesa.

3. Configure o modo OnConflictOnly: Oferece o equilíbrio ideal entre automação e controle manual.

4. Teste com nomes reais: Antes de ativar em produção, valide a geração de e-mails com nomes reais da sua organização.

5. Configure domínio de alias se necessário: Se sua organização possui múltiplos domínios, configure o alias para garantir recebimento em ambos.

Próximos Passos

• Configurar E-mail - Guia passo a passo para administradores
• Provisionamento Automático - Como licenças são atribuídas
• Notificações - Receba alertas sobre conflitos e provisionamentos