Dova Docs22.0.5
Suporte

Notification channels: destinos reutilizáveis e entrega

Configure um destino autorizado, associe eventos e valide persistência, política, transporte e recebimento como etapas distintas.

Manual completo em PDF
Nesta página
  1. Objetivo e modelo
  2. Tipos e campos
  3. Criar e verificar um canal
  4. Exemplo: LabOperations
  5. Conteúdo e SMTP têm responsáveis diferentes
  6. Erros e recuperação
  7. Leituras relacionadas

Objetivo e modelo

Notification channels define destinos reutilizáveis para eventos autorizados, como os de Workflows. O canal informa para onde enviar e se está habilitado; a política decide quando gerar e encaminhar o aviso. O template define o conteúdo de email, e SMTP fornece seu transporte de plataforma. Uma configuração correta em uma camada não comprova o resultado das outras.

Confirme conta, tenant e papel. Consultar canais e administrá-los ou testá-los são capacidades diferentes. Use apenas destinatário ou endpoint de laboratório sob seu controle. Endereços e webhooks podem ser sensíveis mesmo sem uma senha visível; não os publique em capturas ou exemplos.

Tipos e campos

CampoFinalidade e cuidado
NameNome reconhecível para quem configura o Workflow, como LabOperations.
TypeEmail, HTTPS Webhook, Slack ou Microsoft Teams, conforme oferecido no formulário.
DescriptionFinalidade e responsável, sem credenciais.
RecipientsNo tipo Email, destinatários separados por vírgulas; o transporte depende do SMTP de plataforma.
EndpointDestino específico de Webhook, Slack ou Teams, por meio do campo protegido.
Enable this channelHabilita o recebimento dos eventos aplicáveis; não cria eventos por si só.

Ao editar, um segredo já configurado pode não ser reapresentado. Um campo protegido em branco não significa ausência de credencial armazenada. Leia o indicador e a ajuda antes de substituir. Não coloque segredos no nome, na descrição ou no texto do aviso para contornar o fluxo protegido.

Criar e verificar um canal

  1. Abra Notification channels e use Search notification channels para identificar um destino autorizado já existente.
  2. Se precisar de outro, selecione New notification channel e informe um nome claro.
  3. Escolha Type e preencha somente os campos exigidos por esse tipo; siga sua validação específica.
  4. Confira tenant, destino, descrição e estado de Enable this channel. Salve e aguarde a resposta.
  5. Reabra o registro para confirmar os dados persistidos que a aplicação permite consultar.
  6. Quando disponível e autorizado, use Test com conteúdo sintético. Confira a resposta e o sistema receptor do laboratório.
  7. Associe o canal na configuração do Workflow pertinente e escolha os eventos autorizados. Revise também política, severidade, supressão, deduplicação e horários quando aplicáveis.
  8. Gere um evento controlado, compare Delivery history com o receptor e restaure as políticas temporárias ao concluir.

Reload, Filters, Clear filters, Columns e Export CSV alteram a consulta ou a apresentação do gerenciador. Exportar o inventário não deve ser tratado como exportação de segredos. Revise referências antes de excluir um canal utilizado por Workflows.

Exemplo: LabOperations

No laboratório, crie LabOperations com uma caixa de email controlada e associe-o a um Workflow sintético pequeno. Configure o evento pretendido e anote um identificador seguro e o horário esperado. O canal deve permanecer salvo, e o resultado informado deve corresponder ao recebimento esperado ou a uma supressão explicada pela política. No email, confira assunto, texto e links sem incluir dados de entrada da execução.

Para verificar a desabilitação, desmarque Enable this channel e repita apenas o ensaio necessário. O canal permanece disponível para administração, mas não recebe eventos de Workflow enquanto desabilitado. Reabilite se esse for o estado final pretendido. Um aviso de sucesso local pode indicar aceitação pelo transporte, não recebimento final.

Conteúdo e SMTP têm responsáveis diferentes

Para email, revise separadamente Execution email template e Email delivery. Use variáveis do catálogo, como %WORKFLOW_NAME%, %STATUS% e %RUN_ID%, sem inventar sintaxe; o corpo de texto deve transmitir o mesmo resultado do HTML. Um preview não testa conexão nem entrega. O gerenciamento global de SMTP exige a autoridade de plataforma correspondente e não deve ser feito adicionando credenciais ao template.

Consulte a política para eventos, severidades, destinatários, deduplicação, resumo e horários silenciosos. Confira fuso e limites de horário. Estados sent, failed, suppressed e acknowledged de Delivery history não são equivalentes; suppressed não é automaticamente falha SMTP.

Erros e recuperação

  1. Confirme que o evento foi gerado e que o canal correto estava associado e habilitado.
  2. Revise se a política suprimiu ou adiou o aviso antes de alterar o destino.
  3. Confira o tipo, destinatários, credencial configurada e mensagem segura de autenticação ou transporte.
  4. Se for email, encaminhe um problema global de SMTP à administração autorizada.
  5. Se o resultado continuar pendente, consulte seu estado antes de enviar testes repetidos: o receptor pode já ter aceitado a primeira tentativa.

Não diagnostique uma lista filtrada vazia como perda de canal. Limpe filtros e confira o tenant. Uma negativa de permissão exige revisão de acesso; criar uma cópia em outro workspace não corrige o escopo. Para assistência, use o formulário Cloudata, sem incluir endpoints secretos.

Leituras relacionadas

Workflows · Monitor · Templates, SMTP e política.