Pular para o conteúdo principal

Resolver falhas no envio de notificações

Esta página mostra como testar o envio de notificações do Signer e como corrigir as falhas de cada canal. Para configurar os canais, veja Servidor de e-mail (SMTP), Envio de SMS e Whatsapp.

Como testar o envio​

Para testar o envio de e-mail:

  1. Reinicie a aplicação depois de alterar a seção Email.
  2. Crie um documento e adicione como participante um endereço de e-mail que você acessa.
  3. Verifique a caixa de entrada e a pasta de spam desse endereço.
  4. Se o e-mail não chegar em alguns minutos, procure a falha no log e no Hangfire (veja Onde as falhas aparecem).

Para testar o SMS sem enviar SMS, veja Testar o SMS com o simulador.

Onde as falhas aparecem​

O Signer envia cada notificação (e-mail, SMS ou Whatsapp) em um job em segundo plano. Se o envio falhar:

  • O log da aplicação registra Error sending notification <id> com o erro do canal: a exceção do servidor SMTP, a resposta do provedor de SMS ou o erro que a API da Meta devolveu. Veja como ler o log em Linux ou em Docker.
  • O Hangfire tenta enviar de novo, até 10 vezes. Depois da última tentativa, a notificação fica com o status de falha. Para ver os jobs, entre como administrador do sistema e clique em Hangfire no menu de administração. O dashboard abre em <SiteUrl>/hangfire. Os jobs que aguardam nova tentativa ficam na aba Retries. Os que esgotaram as tentativas ficam em Failed.

E-mail (SMTP)​

Se o e-mail não chegar, procure no log a exceção do servidor SMTP (veja Onde as falhas aparecem).

Office 365 (Exchange Online)​

O Signer se autentica no servidor SMTP com usuário e senha (autenticação básica). Ele não usa OAuth para SMTP. Para enviar pelo Exchange Online:

  1. Use ServerHost = smtp.office365.com, ServerPort = 587 e EnableSsl = true.
  2. Use em SenderAddress o mesmo endereço da caixa de correio de Username. Se o remetente for outro endereço, a caixa de Username precisa da permissão Send As sobre ele.
  3. Peça ao administrador do Microsoft 365 para habilitar o SMTP AUTH na caixa de correio que o Signer usa. Se o tenant usa os security defaults do Microsoft Entra ID, o SMTP AUTH fica desabilitado.

Se o log mostrar um erro como 535 5.7.139 Authentication unsuccessful, o Exchange Online recusou a autenticação. Verifique a senha e as configurações acima.

aviso

A Microsoft anunciou a retirada da autenticação básica no SMTP AUTH do Exchange Online. Uma senha de aplicativo também usa autenticação básica. Consulte o cronograma atual da Microsoft. Se o seu tenant não aceitar mais a autenticação básica, use outro servidor SMTP (por exemplo, um relay interno), o Amazon SES ou o SendGrid.

SMS​

Se o provedor recusar o envio, o log registra a resposta do provedor, e o Hangfire tenta de novo (veja Onde as falhas aparecem).

Testar o SMS com o simulador​

Use o provedor Simulator em um ambiente de homologação. Ele não envia SMS. Ele só registra o envio no log da aplicação.

{
  "SMS": {
    "Enabled": true,
    "Type": "Simulator"
  }
}

Se a mensagem não aparecer no log, defina o nível Information para a categoria Lacuna.Commons.SmsSender:

"Serilog": {
  "MinimumLevel": {
    "Override": {
      "Lacuna.Commons.SmsSender": "Information"
    }
  }
}

Não use o Simulator em produção. Os signatários não recebem o código.

O provedor responde 403​

Se o log mostrar o código de status HTTP 403 (por exemplo, NAO AUTENTICADO), o provedor recusou a credencial:

  1. Gere uma chave nova no painel do provedor.
  2. Substitua a credencial na seção SMS (por exemplo, ChaveKey no SMS Empresa).
  3. Reinicie a aplicação.
  4. Reenvie o SMS e verifique o log.

Whatsapp​

Se as mensagens de Whatsapp não chegam e o e-mail funciona, verifique estes pontos na ordem:

  1. Verifique se a conta de Whatsapp Business está associada à Lacuna Software como parceiro de tecnologia, com Controle total (veja Configuração do Parceiro de tecnologia). A associação é obrigatória. Se você trocou ou criou outra conta de Whatsapp, faça a associação de novo.

  2. Verifique se a conta tem os modelos aprovados com os nomes que o Signer usa, nos três idiomas:

    ModeloCategoria na MetaQuando o Signer envia
    authenticationcodeAutenticaçãoCódigo de autenticação da assinatura eletrônica
    pendingsignatureUtilidadeAviso de documento que aguarda a assinatura

    Se você registrou um modelo com outro nome, informe o nome em Whatsapp:TemplateMapping (veja as configurações de Whatsapp).

  3. Procure no log a mensagem Error sending notification <id>. Ela traz o erro que a API da Meta devolveu. Veja Onde as falhas aparecem.

observação

Uma mensagem de Whatsapp que não veio do Signer (por exemplo, enviada pelo sistema que cria os documentos pela API) não aparece no log do Signer. Se a integração de Whatsapp não estiver configurada na instância, o Signer não envia nenhuma mensagem por Whatsapp.

Veja também​

Ver em Markdown