> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/administration/settings/email-and-sms.md).

# Notificações por e-mail e SMS

Configure o servidor de e-mail e a conta Twilio das notificações de alerta, adicione os destinatários padrão e teste os dois com Save and Test Email e Save and Test SMS.

## O que é e quando usar

O SONAR envia notificações de alerta por e-mail, por meio de um servidor SMTP fornecido por você, e por SMS, por meio da sua própria conta Twilio. **Admin Center › Settings › Mail Server** e **Admin Center › Settings › SMS** guardam os dados de conexão e os destinatários padrão.

Configure-os antes de contar com alertas por e-mail ou SMS: enquanto o servidor de e-mail ou a conta Twilio não estiver configurado, os alertas aparecem apenas no painel. Os destinatários definidos aqui são os padrões. Um modelo de alerta pode indicar destinatários próprios, que então substituem estes para os dispositivos que usam esse modelo.

## Antes de começar

* Seu papel precisa de **View Core Settings** para abrir **Settings**, e de **Edit Core Settings** para salvar e enviar testes (grupo **Settings** em **Admin Center › Roles**).
* Para e-mail: o host e a porta SMTP, e um usuário e uma senha se o servidor exigir autenticação. O servidor SMTP precisa aceitar conexões vindas do SONAR; se o seu servidor filtra pela origem, peça ao suporte de implementação da DataDike o endereço a partir do qual o SONAR envia.
* Para SMS: uma conta Twilio com um número de envio, o Account SID e o Auth Token dela.
* Os números de telefone dos destinatários no formato E.164, como `+15555550100`.

## Passos

### Configurar o e-mail

1. Abra **Admin Center › Settings** e a aba **Mail Server**.
2. Em **Email Alert Routing**, clique em **Add emails**, digite um endereço em **Email** e clique em **Add**. Repita para cada destinatário.
3. Em **SMTP Settings**, preencha **From email** e, se quiser, **From name**.
4. Preencha **Host** e **Port**.
5. Se o servidor exigir login, marque **My Server Requires Authentication** e preencha **Username** e **Password**.
6. Clique em **Save and Test Email** para salvar e enviar uma mensagem de teste, ou em **Save Settings** para apenas salvar.
7. Em **Confirm changes**, clique em **Save**.

### Configurar o SMS

1. Abra **Admin Center › Settings** e a aba **SMS**.
2. Em **SMS Alert Routing**, clique em **Add numbers**, digite um número em **Number** e clique em **Add**. Repita para cada destinatário.
3. Em **Twilio Settings**, preencha **Twilio Number**, **Twilio Account SID** e **Twilio Auth Token**.
4. Clique em **Save and Test SMS** para salvar e enviar uma mensagem de teste, ou em **Save Settings** para apenas salvar.
5. Em **Confirm changes**, clique em **Save**.

Para remover um destinatário, clique na etiqueta dele em **Recipients** e salve.

### Usar nos alertas

Quais alertas enviam e-mail ou SMS é decidido pelo modelo de alerta e pelas opções **Email** e **Text** de cada check, tarefa e dispositivo; veja [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md). No modelo de alerta:

* **Email recipients** e **SMS recipients** substituem os destinatários padrão desta página para os dispositivos que usam esse modelo. Se ficarem vazios, valem os padrões.
* **Email From address** substitui **From email** nos e-mails desse modelo.

Os alertas informativos e de aviso só notificam se **Informational Alerts** e **Warning Alerts** estiverem marcados em **Admin Center › Settings › General**; veja [Configurações gerais](https://wiki.datadike.com/pt/sonar/administration/settings/general.md).

## O que você deve ver

Os destinatários aparecem como etiquetas em **Recipients**; sem nenhum, o quadro mostra **No recipients**.

Depois de **Save and Test Email**, a mensagem **Email test ok!** confirma que o servidor aceitou a mensagem, e cada destinatário padrão recebe um e-mail de teste curto. Depois de **Save and Test SMS**, **SMS Test sent successfully!** confirma que a Twilio aceitou as mensagens.

Com **My Server Requires Authentication** marcado, o SONAR se conecta ao host, passa a conexão para TLS (STARTTLS) e faz login. Sem essa opção, o SONAR entrega a mensagem ao host como a um servidor de retransmissão sem autenticação. Use uma porta compatível: em geral 587 com autenticação, 25 para uma retransmissão interna.

## Como verificar se funcionou

1. Clique em **Save and Test Email** e confirme que a mensagem de teste chega a todos os endereços de **Recipients**, olhando também a pasta de spam.
2. Clique em **Save and Test SMS** e confirme que todos os números recebem o SMS de teste.
3. Para uma notificação real, ative **Email** ou **Text** em um check de um dispositivo de teste, faça o check falhar e confirme que a mensagem chega. O próprio alerta aparece em **Alerts**.
4. Em **Reports & Audits › Audits**, uma entrada **Modify Object** em **Core Settings** registra a alteração; veja [Trilha de auditoria](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md).

## Erros comuns

| Sintoma                                                                                  | Causa                                                                                                                                                          | Correção                                                                                                                    |
| ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **There needs to be at least one email recipient configured**                            | Não há destinatário em **Recipients**, ou **From email**, **Host** e **Port** (e **Username** e **Password**, com autenticação) não estão todos preenchidos    | Adicione um destinatário e complete os campos SMTP                                                                          |
| **Failed to send test email** com um erro de autenticação                                | **Username** ou **Password** errado, ou o servidor não permite que essa conta envie                                                                            | Confira a conta com o administrador de e-mail                                                                               |
| **Failed to send test email** com um erro de conexão ou de tempo esgotado                | **Host** ou **Port** errado, ou o servidor SMTP não aceita conexões vindas do SONAR                                                                            | Confira o host e a porta; peça ao suporte de implementação da DataDike o endereço a partir do qual o SONAR envia            |
| O teste funciona, mas os e-mails caem no spam                                            | **From email** não está autorizado a enviar pelo próprio domínio                                                                                               | Use um endereço de remetente autorizado pelo seu domínio de e-mail                                                          |
| **All fields are required, including at least 1 recipient**                              | **Twilio Number**, **Twilio Account SID** ou **Twilio Auth Token** está vazio                                                                                  | Preencha os três campos da Twilio                                                                                           |
| **No sms recipients found**                                                              | **Recipients** em **SMS Alert Routing** está vazio                                                                                                             | Adicione pelo menos um número                                                                                               |
| **Failed to send test SMS** com um erro da Twilio                                        | A conta, o token ou o número de envio foi recusado, ou um número de destinatário não é válido                                                                  | Confira a conta Twilio e o formato dos números                                                                              |
| **Invalid phone number**, **Invalid Account SID** ou **Invalid Auth Token** sob um campo | O valor não corresponde ao formato esperado                                                                                                                    | Veja a referência de campos                                                                                                 |
| As mensagens de teste chegam, mas as de alerta não                                       | O alerta é informativo ou de aviso e essa severidade não está marcada em **Admin Center › Settings › General**, ou o modelo ou o check não ativa e-mail ou SMS | Confira os dois; veja [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md) |

## Referência de campos

### Mail Server

| Campo                                 | O que faz                                                                                   | Valores aceitos                                             | Padrão                               |
| ------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------ |
| **Recipients** (Email Alert Routing)  | Endereços padrão dos e-mails de alerta e do e-mail de teste                                 | Endereços de e-mail válidos, adicionados com **Add emails** | Nenhum                               |
| **From email**                        | Endereço do remetente dos e-mails                                                           | Um endereço de e-mail válido. Obrigatório                   | Um endereço de exemplo, a substituir |
| **From name**                         | Nome de exibição do remetente                                                               | Texto livre                                                 | Vazio                                |
| **Host**                              | Nome ou endereço do servidor SMTP                                                           | Nome de host ou endereço IP                                 | Um valor de exemplo, a substituir    |
| **Port**                              | Porta SMTP                                                                                  | 1 a 65535                                                   | 587                                  |
| **My Server Requires Authentication** | Usa STARTTLS e faz login com a conta abaixo                                                 | Ligado ou desligado                                         | Ligado                               |
| **Username**                          | Conta SMTP, exibida quando a autenticação está ligada                                       | Texto                                                       | Um valor de exemplo, a substituir    |
| **Password**                          | Senha SMTP, exibida quando a autenticação está ligada; o ícone de olho a mostra ou a oculta | Texto                                                       | (sem padrão)                         |

### SMS

| Campo                              | O que faz                                          | Valores aceitos                                           | Padrão |
| ---------------------------------- | -------------------------------------------------- | --------------------------------------------------------- | ------ |
| **Recipients** (SMS Alert Routing) | Números padrão dos SMS de alerta e do SMS de teste | Números no formato E.164, adicionados com **Add numbers** | Nenhum |
| **Twilio Number**                  | Número Twilio a partir do qual os SMS são enviados | `+` seguido de 7 a 15 dígitos, como `+15555550100`        | Vazio  |
| **Twilio Account SID**             | Identifica a conta Twilio                          | `AC` seguido de 32 caracteres hexadecimais                | Vazio  |
| **Twilio Auth Token**              | Autentica o SONAR na Twilio                        | 32 caracteres hexadecimais                                | Vazio  |

Cada SMS é enviado uma vez por número de destinatário.

## Páginas relacionadas

* [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md): quais alertas notificam, e os destinatários por modelo
* [Configurações gerais](https://wiki.datadike.com/pt/sonar/administration/settings/general.md): as severidades que notificam
* [Checks](https://wiki.datadike.com/pt/sonar/administration/automation/checks.md): as opções **Email** e **Text** de um check
* [Webhooks](https://wiki.datadike.com/pt/sonar/administration/settings/webhooks.md): enviar os alertas a outro sistema em vez de a uma caixa de correio
* [Trilha de auditoria](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md): quem alterou essas configurações
