[comment]: # ({473c0010-d40475f4})
# 1 E-mail

[comment]: # ({/473c0010-d40475f4})

[comment]: # ({860d77dd-9d59e93d})
#### Visão geral

Para configurar o e-mail como canal de entrega de mensagens, é necessário configurar o e-mail como tipo de mídia e atribuir endereços específicos aos usuários.

::: noteclassic
Várias notificações para um único evento serão agrupadas no mesmo tópico de e-mail.
:::

[comment]: # ({/860d77dd-9d59e93d})

[comment]: # ({5a73e45c-3711e99d})
#### Configuração

Para configurar email como o tipo de mídia:

1. Acesse *Alerts > Media types*.
2. Clique em *Create media type* (ou clique em *Email* na lista de tipos de mídia predefinidos).

A aba **Media type** contém os atributos gerais do tipo de mídia:

![](../../../../../assets/en/manual/config/notifications/media/media_email.png){width="600"}

Todos os campos obrigatórios são marcados com um asterisco vermelho.

:::notewarning
A senha é exportada em texto claro ao exportar a configuração do tipo de mídia email.
:::

Os seguintes parâmetros são específicos para o tipo de mídia email:

|Parameter|Description|
|--|--------|
|*Email provider*|Selecione o provedor de email: *Generic SMTP*, *Gmail*, *Gmail relay*, *Office365* ou *Office365 relay*.<br>Se você selecionar as opções relacionadas ao Gmail/Office365, será necessário informar apenas o endereço de email do remetente e a senha; opções como *SMTP server*, *SMTP server port*, *SMTP helo* e *Connection security* serão preenchidas automaticamente pelo Zabbix. Veja também: [Automated Gmail/Office365 media types](/manual/config/notifications/media#automated-gmailoffice365-media-types). |
|*SMTP server*|Defina um servidor SMTP para processar as mensagens de saída.<br>Este campo está disponível se *Generic SMTP* estiver selecionado como provedor de email.|
|*SMTP server port*|Defina a porta do servidor SMTP para processar as mensagens de saída.<br>Este campo está disponível se *Generic SMTP* estiver selecionado como provedor de email.|
|*Email*|O endereço informado aqui será usado como endereço **From** das mensagens enviadas.<br>É possível adicionar um nome de exibição do remetente (como "Zabbix\_info" em *Zabbix\_info <zabbix\@company.com>* na captura de tela acima) junto com o endereço de email real.<br>Há algumas restrições sobre nomes de exibição em emails do Zabbix em comparação com o que é permitido pela RFC 5322, conforme ilustrado pelos exemplos:<br>Exemplos válidos:<br>*zabbix\@company.com* (apenas endereço de email, sem necessidade de usar colchetes angulares)<br>*Zabbix\_info <zabbix\@company.com>* (nome de exibição e endereço de email entre colchetes angulares)<br>*∑Ω-monitoring <zabbix\@company.com>* (caracteres UTF-8 no nome de exibição)<br>Exemplos inválidos:<br>*Zabbix HQ zabbix\@company.com* (há nome de exibição, mas o endereço de email não está entre colchetes angulares)<br>*"Zabbix\\@\\<H(comment)Q\\>" <zabbix\@company.com>* (embora válido pela RFC 5322, pares entre aspas e comentários não são suportados em emails do Zabbix)|
|*SMTP helo*|Defina um valor correto para o SMTP helo, normalmente um nome de domínio.<br>Se estiver vazio, o nome de domínio do email será enviado (ou seja, o que vem após `@` no campo *Email*). Se não for possível obter o nome de domínio, um aviso em nível de depuração será registrado e o hostname do server será enviado como domínio para o comando HELO.<br>Este campo está disponível se *Generic SMTP* estiver selecionado como provedor de email.|
|*Connection security*|Selecione o nível de segurança da conexão:<br>**None** - não use a opção [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html)<br>**STARTTLS** - use a opção CURLOPT\_USE\_SSL com o valor CURLUSESSL\_ALL<br>**SSL/TLS** - o uso de CURLOPT\_USE\_SSL é opcional|
|*SSL verify peer*|Marque a caixa de seleção para verificar o certificado SSL do servidor SMTP.<br>O valor da diretiva de configuração do server "SSLCALocation" deve ser colocado em [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) para validação do certificado.<br>Isso define a opção cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).|
|*SSL verify host*|Marque a caixa de seleção para verificar se o campo *Common Name* ou o campo *Subject Alternate Name* do certificado do servidor SMTP corresponde.<br>Isso define a opção cURL [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).|
|*Authentication*|Selecione o nível de autenticação:<br>**None** - nenhuma opção cURL é definida<br>**Username and password** - implica "AUTH=\*" deixando a escolha do mecanismo de autenticação para o cURL|
|*Username*|Nome de usuário a ser usado na autenticação.<br>Isso define o valor de [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html).<br>[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) suportados.|
|*Password*|Senha a ser usada na autenticação.<br>Isso define o valor de [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html).<br>[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) suportados.<br>O valor informado aqui é exportado como está quando a configuração do tipo de mídia é exportada. Para evitar expor credenciais sensíveis em arquivos exportados, use um user macro (por exemplo `{$EMAIL_SMTP_PASSWORD}`) em vez de uma senha literal — a referência ao macro será exportada, enquanto o valor secreto deve ser (re)configurado no sistema de destino.|
|*Message format*|Selecione o formato da mensagem:<br>**HTML** - enviar como HTML<br>**Plain text** - enviar como texto simples|

::: noteimportant
Para habilitar a autenticação SMTP, o server do Zabbix deve ser compilado com a opção de [compilação](/manual/installation/install#configure-the-sources) `--with-libcurl`, que requer libcurl (veja os requisitos do [server](/manual/installation/requirements#serverproxy) para detalhes sobre a versão).
:::

Veja também [common media type parameters](/manual/config/notifications/media#common-parameters) para detalhes sobre como configurar mensagens padrão e opções de processamento de alertas.

[comment]: # ({/5a73e45c-3711e99d})

[comment]: # ({50e8f033-98f29ec0})
#### Teste

Para testar se um tipo de mídia de e-mail configurado funciona corretamente:

1. Localize o e-mail relevante na [lista](/manual/config/notifications/media#overview) de tipos de mídia.
2. Clique em *Test* na última coluna da lista (uma janela de teste será aberta).
3. Informe um endereço de destinatário em *Send to*, o corpo da mensagem e, opcionalmente, o assunto.
4. Clique em *Test* para enviar uma mensagem de teste.

Uma mensagem de sucesso ou falha do teste será exibida na mesma janela:

![](../../../../../assets/en/manual/config/notifications/media/test_email0.png){width="600"}

[comment]: # ({/50e8f033-98f29ec0})

[comment]: # ({859be4b6-5e74f274})
#### Mídia do usuário

Depois que o tipo de mídia de e-mail estiver configurado, vá para a seção *Users > Users* e edite o perfil do usuário para atribuir a mídia de e-mail ao usuário.
As etapas para configurar a mídia do usuário, comuns a todos os tipos de mídia, estão descritas na página [Media types](/manual/config/notifications/media#user-media).

[comment]: # ({/859be4b6-5e74f274})