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.
Nesta página
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
| Campo | Finalidade e cuidado |
|---|---|
| Name | Nome reconhecível para quem configura o Workflow, como LabOperations. |
| Type | Email, HTTPS Webhook, Slack ou Microsoft Teams, conforme oferecido no formulário. |
| Description | Finalidade e responsável, sem credenciais. |
| Recipients | No tipo Email, destinatários separados por vírgulas; o transporte depende do SMTP de plataforma. |
| Endpoint | Destino específico de Webhook, Slack ou Teams, por meio do campo protegido. |
| Enable this channel | Habilita 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
- Abra
Notification channelse use Search notification channels para identificar um destino autorizado já existente. - Se precisar de outro, selecione New notification channel e informe um nome claro.
- Escolha Type e preencha somente os campos exigidos por esse tipo; siga sua validação específica.
- Confira tenant, destino, descrição e estado de Enable this channel. Salve e aguarde a resposta.
- Reabra o registro para confirmar os dados persistidos que a aplicação permite consultar.
- Quando disponível e autorizado, use
Testcom conteúdo sintético. Confira a resposta e o sistema receptor do laboratório. - Associe o canal na configuração do
Workflowpertinente e escolha os eventos autorizados. Revise também política, severidade, supressão, deduplicação e horários quando aplicáveis. - 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
- Confirme que o evento foi gerado e que o canal correto estava associado e habilitado.
- Revise se a política suprimiu ou adiou o aviso antes de alterar o destino.
- Confira o tipo, destinatários, credencial configurada e mensagem segura de autenticação ou transporte.
- Se for email, encaminhe um problema global de SMTP à administração autorizada.
- 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.