claude-plugins/automacao/skills/n8n-notify/SKILL.md

/n8n-notify - Notificações e Alertas n8n

Criar sistemas de alertas via Slack, email, SMS.

---

Uso

/n8n-notify create <descrição>     # Criar sistema de alertas
/n8n-notify slack <mensagem>       # Quick Slack notification
/n8n-notify email <para> <assunto> # Quick email

---

Workflow Obrigatório

1. Health check       → mcp__n8n__n8n_health_check()
2. Pesquisar template → mcp__n8n__search_templates({ query: "notification" })
3. Se template OK     → mcp__n8n__n8n_deploy_template()
4. Se criar do zero   → Seguir fluxo abaixo

---

Canais Disponíveis

Canal	Node	Uso
Slack	nodes-base.slack	Notificações equipa
Email	nodes-base.emailSend	Alertas formais
Telegram	nodes-base.telegram	Alertas mobile
Discord	nodes-base.discord	Comunidades
SMS	nodes-base.twilio	Alertas críticos

---

Slack

Documentação

mcp__n8n__get_node({
  nodeType: "nodes-base.slack",
  detail: "standard",
  includeExamples: true
})

Configuração

mcp__n8n__validate_node({
  nodeType: "nodes-base.slack",
  config: {
    resource: "message",
    operation: "post",
    channel: "#alertas",
    text: "Mensagem de alerta"
  },
  mode: "minimal"
})

Mensagem Formatada (Blocks)

{
  blocksUi: {
    blocksValues: [
      {
        type: "header",
        text: { type: "plain_text", text: "Alerta" }
      },
      {
        type: "section",
        text: { type: "mrkdwn", text: "*Detalhes:*\n{{ $json.message }}" }
      }
    ]
  }
}

---

Email

Configuração

mcp__n8n__validate_node({
  nodeType: "nodes-base.emailSend",
  config: {
    fromEmail: "alertas@descomplicar.pt",
    toEmail: "emanuel@descomplicar.pt",
    subject: "Alerta: {{ $json.title }}",
    text: "{{ $json.message }}"
  },
  mode: "minimal"
})

---

Padrões Comuns

Webhook → Slack

Webhook (evento externo)
  ↓
Set (formatar)
  ↓
Slack (enviar)

Monitor → Multi-canal

Schedule (cada 5min)
  ↓
HTTP Request (check health)
  ↓
IF (erro?)
  ↓ TRUE
Slack + Email (alertar)

Error Handler

Qualquer workflow
  ↓ (erro)
Error Trigger
  ↓
Slack (alertar erro)

---

Níveis de Alerta

Nível	Canal	Quando
Info	Slack	Eventos normais
Warning	Slack + Email	Atenção necessária
Critical	Todos + SMS	Acção imediata

Implementação

IF (severity = "critical")
  ↓ TRUE
Slack + Email + SMS
  ↓ FALSE
IF (severity = "warning")
  ↓ TRUE
Slack + Email
  ↓ FALSE
Slack

---

Exemplos

Alerta de Servidor Down

Schedule (5min)
  ↓
HTTP Request (ping servidor)
  ↓
IF (falhou?)
  ↓ TRUE
Slack (#infra)
Email (admin)

Novo Lead

Webhook (lead criado)
  ↓
Set (formatar)
  ↓
Slack (#vendas)

Factura Vencida

Schedule (diário 9h)
  ↓
HTTP Request (facturas vencidas)
  ↓
Loop (cada factura)
  ↓
Email (cliente)
Slack (#contabilidade)

---

Templates

mcp__n8n__search_templates({
  searchMode: "keyword",
  query: "slack notification alert"
})

---

Troubleshooting

Problema	Solução
Slack não envia	Verificar token e canal
Email em spam	Configurar SPF/DKIM
Rate limited	Agrupar notificações

---

Skill v1.0 | Descomplicar®