Slack Notificador

O que faz

O Slack Notificador permite que o Claude Code envie mensagens bem formatadas para

canais do Slack — alertas, resumos diários, avisos de deploy, notificações de novos

leads, relatórios automáticos — usando um Incoming Webhook. Em vez de copiar e

colar status manualmente, você pede ao agente para "avisar o time" e ele monta uma

mensagem clara, com título, contexto e (quando útil) blocos formatados, e a envia para

o canal certo.

O plugin entende o formato de mensagens do Slack (texto simples e Block Kit), então

consegue criar avisos com destaque visual: cabeçalho, campos em colunas, listas e até

botões/links. É ideal para fechar o ciclo de outras automações: o crm-leads qualifica

um lead quente, o analytics-ga4 gera um resumo, o backup-automatico termina — e o

Slack Notificador comunica isso ao time.

Casos de uso típicos:

• "Avise o canal #vendas que o lead Mariana virou quente."
• Resumo diário de métricas postado às 9h.
• Alerta quando um backup falha ou conclui.
• Notificação de deploy ou de erro detectado.

Instalação

1. Copie a pasta slack-notificador/ para o diretório de plugins do Claude Code.
2. No Slack, crie um Incoming Webhook apontando para o canal desejado (Apps →

Incoming Webhooks → Add to Slack). Copie a URL gerada.

1. Defina a URL na variável de ambiente SLACK_WEBHOOK_URL (nunca no código).
2. Reinicie o Claude Code.

Comandos disponíveis

• /slack-avisar — envia uma mensagem/alerta para o Slack a partir de uma

descrição, escolhendo o tom e a formatação adequados.

• /slack-relatorio — monta e envia um resumo/relatório formatado (Block Kit) com

título, métricas e itens, ideal para status periódicos.

Configuração

Sempre por nome de variável de ambiente — jamais cole a URL real do webhook no

projeto.

• SLACK_WEBHOOK_URL — obrigatória. URL do Incoming Webhook do canal de destino.

A URL já define o canal; trate-a como um segredo (quem a tiver pode postar no canal).

• SLACK_DEFAULT_USERNAME — opcional; nome de exibição do remetente (ex.: "Bot Aulas

de IA").

• SLACK_DEFAULT_ICON — opcional; emoji do remetente (ex.: :robot_face:).

Para enviar a múltiplos canais, configure um webhook por canal e selecione qual usar

no comando.

Exemplo de uso

/slack-avisar Deploy do site concluído com sucesso às 14h32, versão 1.4.0,
sem erros. Marque como informativo.

O Claude monta uma mensagem com um emoji de check, título "Deploy concluído" e os

detalhes, e a envia via webhook. Para um resumo:

/slack-relatorio Resumo do dia: 12 novos leads, 3 qualificados como quentes,
1 venda fechada de R$ 2.500. Próximo passo: follow-up dos mornos.

Ele gera blocos formatados e posta no canal.

Segurança e limites

• Trate o webhook como segredo. Quem possui a SLACK_WEBHOOK_URL pode postar no

canal. Mantenha-a em variáveis de ambiente e revogue/recrie se vazar.

• Sem spam. Evite disparos em alta frequência; o Slack aplica limites de taxa

(rate limit) e mensagens repetitivas irritam o time.

• Conteúdo sensível: não envie dados pessoais ou segredos para canais com muitos

membros. Pense em quem tem acesso ao canal.

• Confirmação opcional: por padrão, os comandos mostram a prévia da mensagem antes

de enviar, para você revisar.

• Escopo do webhook: um Incoming Webhook posta em um único canal predefinido; ele

não lê mensagens nem executa ações administrativas.