--- title: "Resolver falhas no envio de notificações" description: "Como testar o envio de notificações do Signer por e-mail, SMS e Whatsapp, onde as falhas aparecem (log e Hangfire) e como corrigir as falhas de cada canal." canonical: "https://docs.lacunasoftware.com/articles/signer/on-premises/notificacoes-nao-enviadas" locale: "pt-BR" product: "Signer" last_updated: "2026-10-22" --- # 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)](https://docs.lacunasoftware.com/articles/signer/on-premises/email-smtp), [Envio de SMS](https://docs.lacunasoftware.com/articles/signer/on-premises/sms) e [Whatsapp](https://docs.lacunasoftware.com/articles/signer/on-premises/whatsapp). ## Como testar o envio Para testar o envio de e-mail: 1. Reinicie a aplicação depois de alterar a seção `Email`. 1. Crie um documento e adicione como participante um endereço de e-mail que você acessa. 1. Verifique a caixa de entrada e a pasta de spam desse endereço. 1. Se o e-mail não chegar em alguns minutos, procure a falha no log e no Hangfire (veja [Onde as falhas aparecem](https://docs.lacunasoftware.com/articles/signer/on-premises/notificacoes-nao-enviadas#where-failures-show)). Para testar o SMS sem enviar SMS, veja [Testar o SMS com o simulador](https://docs.lacunasoftware.com/articles/signer/on-premises/notificacoes-nao-enviadas#sms-simulator). ## 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 ` 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](https://docs.lacunasoftware.com/articles/signer/on-premises/linux/troubleshoot/check-logs) ou em [Docker](https://docs.lacunasoftware.com/articles/signer/on-premises/docker/docker-swarm/check-logs). * 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 `/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](https://docs.lacunasoftware.com/articles/signer/on-premises/notificacoes-nao-enviadas#where-failures-show)). ### 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`. 1. 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. 1. 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](https://learn.microsoft.com/exchange/clients-and-mobile-in-exchange-online/deprecation-of-basic-authentication-exchange-online). > 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](https://docs.lacunasoftware.com/articles/signer/on-premises/email-smtp#amazon-ses) ou o [SendGrid](https://docs.lacunasoftware.com/articles/signer/on-premises/email-smtp#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](https://docs.lacunasoftware.com/articles/signer/on-premises/notificacoes-nao-enviadas#where-failures-show)). ### 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. ```json { "SMS": { "Enabled": true, "Type": "Simulator" } } ``` Se a mensagem não aparecer no log, defina o nível `Information` para a categoria `Lacuna.Commons.SmsSender`: ```json "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. 1. Substitua a credencial na seção `SMS` (por exemplo, `ChaveKey` no SMS Empresa). 1. Reinicie a aplicação. 1. 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](https://docs.lacunasoftware.com/articles/signer/on-premises/whatsapp#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. 1. Verifique se a conta tem os modelos aprovados com os nomes que o Signer usa, nos três idiomas: | Modelo | Categoria na Meta | Quando o Signer envia | |---|---|---| | `authenticationcode` | Autenticação | Código de autenticação da assinatura eletrônica | | `pendingsignature` | Utilidade | Aviso 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](https://docs.lacunasoftware.com/articles/signer/on-premises/settings#configurações-whatsapp-v1560)). 1. Procure no log a mensagem `Error sending notification `. Ela traz o erro que a API da Meta devolveu. Veja [Onde as falhas aparecem](https://docs.lacunasoftware.com/articles/signer/on-premises/notificacoes-nao-enviadas#where-failures-show). > **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 * [Servidor de e-mail (SMTP)](https://docs.lacunasoftware.com/articles/signer/on-premises/email-smtp) * [Envio de SMS](https://docs.lacunasoftware.com/articles/signer/on-premises/sms) * [Whatsapp](https://docs.lacunasoftware.com/articles/signer/on-premises/whatsapp) * [Configurações do Signer](https://docs.lacunasoftware.com/articles/signer/on-premises/settings)