Assistente de configuração

Passo 1 - Configuração SMTP

Nesta etapa se configura a conta de e-mail (SMTP) que será utilizada pela Central XML® para enviar os alertas gerados em diversas situações e eventos configuráveis (rejeições, divergências, erros de processamento etc.).

Na primeira execução os campos vêm preenchidos com os dados de e-mail do Workflow do Protheus (MV_RELSERV, MV_WFMAIL e MV_WFPASSW), quando existirem.

image.png

image.png

Campos da tela

Campo Parâmetro Tipo Padrão Orientação
Servidor SMTP ‣ Caractere MV_RELSERV Endereço do servidor de envio (ex.: smtp.office365.com, smtp.gmail.com). Informe somente o host; a porta vai no campo seguinte.
Porta ‣ Numérico 25 Porta do servidor SMTP. Usualmente 25 (sem criptografia), 587 (TLS) ou 465 (SSL).
Login Email ‣ Caractere MV_WFMAIL Usuário usado na autenticação no servidor SMTP (normalmente o próprio e-mail).
Senha ‣ Caractere MV_WFPASSW Senha da conta. Provedores com autenticação em dois fatores podem exigir uma “senha de app”.
Conta de Email ‣ Caractere MV_WFMAIL ou Central XML<seuemail@seudominio> Remetente (From) dos e-mails. Aceita o formato Nome<email>. O e-mail de teste desta etapa é enviado para este mesmo endereço.
Usa SSL (Conexão Segura) ‣ Lógico Não Marque quando o servidor exigir SSL (ex.: porta 465).
Usa TLS (Conexão Segura) ‣ Lógico Não Marque quando o servidor exigir TLS/STARTTLS (ex.: porta 587).
Autenticação (Requerida) ‣ Lógico Sim Quando marcado, a rotina autentica no servidor com o Login e a Senha informados.
Email Administrador ‣ Caractere [email protected] E-mail do administrador da rotina, que recebe os avisos de erros. Recomenda-se informar o e-mail do responsável interno pela Central XML®.
Time-Out ‣ Numérico 30 Tempo máximo de espera (segundos) pela resposta do servidor. Também é usado como time-out da conexão POP3.
Telemetria ‣ Lógico Sim Envio de e-mails (logs, eventos e erros) para a software house, auxiliando o suporte: os e-mails da Central XML® seguem com cópia oculta (Bcc) para a caixa de auditoria.

O que acontece ao clicar em Avançar

  1. Verificação do ambiente: confere se existe a chave TOPMEMOMEGA=1 na seção do ambiente, em [TopConnect] ou em [DBAccess]. Se não existir, tenta gravá-la no appserver.ini (mensagem "Ajuste forçado da chave TopMemoMega"). Se não for possível, exibe "Falta configuração 'TopMemoMega=1'" e não avança.
  2. Conexão com o servidor SMTP, usando SSL/TLS conforme marcado.
  3. Time-out: aplica o tempo informado.
  4. Autenticação com Login e Senha (se “Autenticação Requerida” estiver marcado).
  5. E-mail de teste: envia a mensagem "Teste de Email de Configuração Central XML" da Conta de Email para ela mesma. Em caso de sucesso aparece "Email enviado para ...".
  6. Gravação de todos os parâmetros da tela e avanço para a Etapa 2 - Configuração POP3/IMAP.

<aside> ⚠️

Os parâmetros desta etapa só são gravados se todos os testes forem concluídos com sucesso. Enquanto houver falha o Wizard permanece nesta tela.

</aside>

Mensagens de erro mais comuns

Mensagem Causa provável / ação
[ERROR]Falha ao conectar: ... Servidor ou porta incorretos, porta bloqueada no firewall do servidor Protheus, ou combinação SSL/TLS diferente da exigida pelo provedor.
Falha ao setar o TimeOut Valor de Time-Out inválido. Informe um número de segundos (ex.: 30 ou 60).
[ERROR]Falha ao autenticar: ... Login/senha inválidos, conta sem permissão de SMTP autenticado ou provedor exigindo senha de app.
Erro ao Enviar email Conta de Email (remetente) não autorizada a enviar pelo login informado, ou envio SMTP suspenso no provedor.
Erro ao desconectar do Servidor SMTP Falha ao encerrar a sessão; tente novamente.

image.png