Enviar notificações por e-mail do Analytics

Informações do conceito

Você pode enviar mensagens de notificação por e-mail do Analytics para um ou mais destinatários. As mensagens podem incluir arquivos de dados anexados e projetos do Analytics.

Um uso comum de notificações por e-mail é alertar a equipe apropriada quando um script falha inesperadamente.

Como a notificação por e-mail funciona

O recurso de notificação do Analytics envia uma mensagem de e-mail de saída a um servidor SMTP (Simple Mail Transfer Protocol). O servidor de e-mail, por sua vez, retransmite a mensagem aos destinatários. A conexão entre o Analytics e o servidor de e-mail pode ser autenticada ou não. Uma conexão não autenticada não é mais o padrão para sistemas de e-mail modernos.

Servidores SMTP compatíveis

O recurso de notificação por e-mail do Analytics funciona com uma ampla variedade de servidores SMTP que requerem conexões autenticadas. No entanto, o envio de notificações não funciona com todos os servidores ou serviços SMTP. Por exemplo, o recurso não funciona com o Gmail. Para aplicativos de terceiros se conectarem a uma Conta do Google, é necessária uma configuração de segurança compatível com o Analytics, além de nome de usuário e senha.

De modo geral, esteja ciente de que o uso bem-sucedido do Analytics para enviar e-mails de saída a um servidor SMTP requer uma configuração compatível tanto no Analytics como no servidor SMTP. Se o Analytics falhar ao se conectar, mas conseguir enviar e-mails, trabalhe com seu departamento de TI para garantir que haja uma configuração de conexão compatível entre o Analytics e o servidor.

Envie mensagens de e-mail usando uma conexão SMTP autenticada

Nota

É preciso usar o Analytics 16.1 ou uma versão mais recente para configurar uma conexão SMTP autenticada na interface do usuário. Se você estiver usando a versão 16.0, a configuração de uma conexão autenticada será compatível apenas com scripts. Para obter mais informações, consulte Comando NOTIFY.

As versões do Analytics anteriores à 16.0 não são compatíveis com conexões autenticadas com um servidor de e-mail SMTP.

Use a interface do usuário do Analytics para configurar o envio de notificações por e-mail usando uma conexão autenticada com um servidor de e-mail SMTP. A maioria dos sistemas de e-mail modernos exige conexões autenticadas.

A vantagem de configurar a conexão por meio da interface do usuário é que o Analytics cria a sintaxe do ACLScript para você. Depois de configurar uma conexão que funcione, você pode copiar a sintaxe do log de comando para um script.

No menu principal do Analytics, selecione Ferramentas > Notificar por e-mail.
A caixa de diálogo Notificar abre.
Selecione SMTP e inclua as seguintes informações:
- Usuário do SMTP (opcional) Insira o nome da conta de usuário para autenticação e acesse o servidor SMTP.
  É possível deixar este campo em branco, e o endereço de e-mail especificado pelo Remetente será usado para autenticar e acessar o servidor SMTP.
- Porta Digite o número da porta a ser usada para acessar o servidor SMTP.
  Talvez você tenha que entrar em contato com o departamento de TI para saber qual porta deve usar. Veja números de porta comuns para servidores SMTP:
  - 587
  - 2525
  - 465
- SSL Opcional. Selecione SSL se o servidor SMTP exigir uma conexão SMTP/SSL segura.
  Talvez você precise entrar em contato com o departamento de TI para descobrir se o servidor SMTP exige uma conexão SSL. Também é possível enviar e-mails de teste com e sem a opção SSL selecionada.
Preencha as seguintes informações:
- Remetente – Digite um endereço de e-mail do remetente para as mensagens enviadas por meio do servidor SMTP.
- Senha – Digite a senha da conta de e-mail do remetente.
  O Analytics criptografa a senha automaticamente, e a versão criptografada aparece no log. Para obter mais informações, consulte Gerando uma senha criptografada.
- Caminho da caixa postal – Insira o nome de domínio do servidor SMTP a ser usado para enviar as mensagens de e-mail.
  Por exemplo: smtp.example.com
- Para – Digite o endereço de e-mail de um ou mais destinatários. Separe vários endereços de e-mail com vírgula.
  Nota
  Insira no máximo 1020 caracteres.
- Cc – Opcional. Digite o endereço de e-mail de um ou mais destinatários de cópia. Separe vários endereços de e-mail com vírgula.
  Nota
  Insira no máximo 1000 caracteres.
- Bcc – Opcional. Digite o endereço de e-mail de um ou mais destinatários de cópia oculta. Separe vários endereços de e-mail com vírgula.
- Assunto – Insira a linha de assunto da mensagem de e-mail.
- Texto – Digite o texto do corpo da mensagem de e-mail.
  A mensagem usa texto simples e não permite HTML. Se você quiser inserir uma quebra de linha na mensagem, use dois caracteres de circunflexo: ^^
- Anexo – Opcional. Especifique o caminho e o nome do arquivo de um ou mais anexos ou clique em Procurar para abrir a caixa de diálogo Selecionar Arquivo.
  Se o arquivo estiver na mesma pasta que o projeto do Analytics, não será necessário especificar o caminho do arquivo.
  Especifique vários anexos inserindo uma lista de arquivos separados por vírgula. Por exemplo: result1.csv,result2.csv
  Nota
  Em uma lista separada por vírgula, confirme que não há espaços após as vírgulas.
Clique em OK.
O Analytics envia o e-mail ao servidor de e-mail SMTP para ser transmitido aos destinatários.
Se a tentativa de conexão entre o Analytics e o servidor de e-mail falhar, o Analytics tentará de novo a conexão automaticamente por um número determinado de vezes. Para obter mais informações, consulte Como o Analytics responde às tentativas de conexão com falha.

Envie mensagens de e-mail usando uma conexão não autenticada

Use a interface do usuário do Analytics para configurar o envio de notificações por e-mail usando uma conexão não autenticada com um servidor de e-mail SMTP ou com um sistema de e-mail local. Uma conexão não autenticada não é mais o padrão para sistemas de e-mail modernos.

Uma conexão não autenticada entre o Analytics e um servidor SMTP aberto usa a porta 25, que deve estar aberta no servidor para a conexão ser bem-sucedida.

No menu principal do Analytics, selecione Ferramentas > Notificar por e-mail.
A caixa de diálogo Notificar abre.
Verifique se a opção SMTP não está selecionada.
Preencha as seguintes informações:
- Remetente – Digite um endereço de e-mail do remetente para as mensagens enviadas por meio do servidor SMTP ou do sistema de e-mail local.
- Senha – Se for necessário, digite uma senha para a conta de e-mail do remetente.
  O Analytics criptografa a senha automaticamente, e a versão criptografada aparece no log. Para obter mais informações, consulte Gerando uma senha criptografada.
- Caminho da caixa postal – Insira o nome de domínio do servidor SMTP a ser usado para enviar as mensagens de e-mail.
  Por exemplo: smtp.example.com
  Se você estiver usando um sistema de correio local, digite o caminho para a caixa postal local ou clique em Procurar para abrir a caixa de diálogo Procurar pasta.
- Para – Digite o endereço de e-mail de um ou mais destinatários. Separe vários endereços de e-mail com vírgula.
  Nota
  Insira no máximo 1020 caracteres.
- Cc – Opcional. Digite o endereço de e-mail de um ou mais destinatários de cópia. Separe vários endereços de e-mail com vírgula.
  Nota
  Insira no máximo 1000 caracteres.
- Bcc – Opcional. Digite o endereço de e-mail de um ou mais destinatários de cópia oculta. Separe vários endereços de e-mail com vírgula.
- Assunto – Insira a linha de assunto da mensagem de e-mail.
- Texto – Digite o texto do corpo da mensagem de e-mail.
  A mensagem usa texto simples e não permite HTML. Se você quiser inserir uma quebra de linha na mensagem, use dois caracteres de circunflexo: ^^
- Anexo – Opcional. Especifique o caminho e o nome do arquivo de um ou mais anexos ou clique em Procurar para abrir a caixa de diálogo Selecionar Arquivo.
  Se o arquivo estiver na mesma pasta que o projeto do Analytics, não será necessário especificar o caminho do arquivo.
  Especifique vários anexos inserindo uma lista de arquivos separados por vírgula. Por exemplo:result1.csv,result2.csv
  Nota
  Em uma lista separada por vírgula, confirme que não há espaços após as vírgulas.
Clique em OK.
O Analytics envia o e-mail ao servidor de e-mail SMTP ou ao sistema de e-mail local para ser transmitido aos destinatários.
Se a tentativa de conexão entre o Analytics e o servidor ou sistema de e-mail falhar, o Analytics tentará de novo a conexão automaticamente por um número determinado de vezes. Para obter mais informações, consulte Como o Analytics responde às tentativas de conexão com falha.