Pular para o conteúdo principal

E-mail e notificações

A gaveta de notificações no aplicativo do Kanera funciona sem configuração. Tudo o que sai do servidor – e-mail, push do navegador e canais de entrega pessoal – precisa de uma decisão sua.

Configurar e-mail​

O SMTP é opcional, mas recomendado para convites, notificações, verificação e uso operacional.

SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_SECURITY=starttls
[email protected]
SMTP_PASSWORD=your-password
[email protected]
SMTP_FROM_NAME=Kanera

Um administrador da organização também pode inserir configurações de SMTP em Configurações -> Organização -> Integrações em vez de usar valores de ambiente. A página de configurações marca qual fonte está em uso.

Deixe a verificação de e-mail desativada até que o e-mail enviado esteja funcionando:

EMAIL_VERIFICATION_ENABLED=false

Depois que o e-mail estiver funcionando, você poderá definir EMAIL_VERIFICATION_ENABLED=true para exigir verificação de inscrição, inscrição de convite e alterações de e-mail.

Notificações por e-mail​

Depois que o SMTP funciona, os usuários gerenciam seu próprio canal de e-mail e preferências de e-mail por tipo de Configurações de perfil -> Notificações. Nenhuma configuração adicional do servidor é necessária.

Envio do navegador​

  1. Confirme se o Kanera é servido por HTTPS.
  2. Abrir Configurações -> Organização -> Integrações como administrador da organização.
  3. Habilitar Permitir push do navegador para esta organização. Isso também prepara a configuração web push compartilhada que os navegadores precisam antes que qualquer pessoa possa se inscrever.
  4. Pergunte aos usuários que desejam que os alertas push sejam abertos Configurações de perfil -> Notificações, habilitar Permitir notificações push, conceda permissão ao navegador e escolha suas preferências de push por tipo.

Configurações de notificação pessoal após a execução do Kanera.

Push é específico do dispositivo e do navegador. Um usuário que deseja alertas em vários dispositivos deve habilitar o push em cada navegador ou PWA instalado.

O push está desativado por padrão tanto para a organização quanto para cada usuário, mas é o canal que vale a pena encorajar: um alerta chega enquanto o trabalho está em andamento e depois não deixa nada na caixa de entrada. Veja Configuração.

Canais de entrega pessoal​

Os usuários podem enviar suas próprias notificações para ntfy, Gotify ou um webhook pessoal sem qualquer configuração de servidor, desde que o destino seja acessível por HTTPS público.

Se seus usuários executam esses serviços na rede interna, permita receptores privados:

KANERA_ALLOW_PRIVATE_NOTIFICATION_DESTINATIONS=true

Isto permite http:// e endereços privados como loopback, RFC1918, CGNAT e IPv6 ULA. Endereços de metadados locais e de nuvem, multicast e outros intervalos reservados permanecem bloqueados. Deixe-o indefinido ou false para exigir destinos HTTPS públicos.

Um servidor homelab ou ntfy interno ou Gotify costuma ser o motivo para a auto-hospedagem, então essa geralmente é a única configuração de notificação que vale a pena alterar. A página de configurações de notificação informa a cada usuário qual das duas políticas está ativa. Veja Canais de entrega pessoal.

Destinos de bate-papo​

Os administradores do espaço de trabalho podem postar atividades de cartões no Slack, Discord, Telegram ou Zulip a partir de Configurações do espaço de trabalho -> Integrações. Isso não requer configuração de servidor além do acesso HTTPS de saída.

Os destinos de bate-papo e webhooks pessoais armazenam suas credenciais criptografadas com SECRETS_ENCRYPTION_KEY. Defina-o para um valor estável distinto de JWT_SECRETe não o altere depois que os destinos existirem. Veja Destinos de bate-papo.