Pular para o conteúdo principal

Alertas e webhooks

O agente pode enviar notificações para qualquer serviço que aceite webhooks — Slack, Discord, Microsoft Teams, PagerDuty, ou qualquer endpoint HTTP customizado.

Como o agente envia alertas​

Usando a ferramenta de requisição HTTP, o agente faz um POST para o endpoint do webhook com o conteúdo que você definir no prompt.

Configurando alertas no Slack​

1. Crie um webhook no Slack​

  1. Acesse api.slack.com/apps
  2. Crie um app ou selecione um existente
  3. Em Incoming Webhooks, ative e crie um webhook para o canal desejado
  4. Copie a URL (ex: https://hooks.slack.com/services/T.../B.../...)

2. Use no prompt da tarefa​

Verifique o endpoint https://api.minha-empresa.com/health.

Se o status não for 200, envie alerta no Slack:
POST https://hooks.slack.com/services/SEU_WEBHOOK
Body: {"text": "🚨 API fora do ar! Status: [status_code] — [timestamp]"}

Se estiver ok, não envie nenhuma notificação.

Alertas no Discord​

POST https://discord.com/api/webhooks/SEU_WEBHOOK_ID/SEU_TOKEN
Body: {"content": "⚠️ Alerta de monitoramento: [descrição do problema]"}

Alertas no Microsoft Teams​

POST https://outlook.office.com/webhook/SEU_WEBHOOK
Body: {"text": "Alerta NeurAI: [descrição]"}

Variáveis de sessão para webhooks​

Salve a URL do webhook como variável para reutilizar entre sessões. No prompt:

Salve a variável SLACK_WEBHOOK = https://hooks.slack.com/services/...

Ou inclua a URL diretamente no prompt da tarefa agendada.

Boas práticas​

  • Não inclua tokens secretos diretamente no prompt — use variáveis de sessão
  • Teste o webhook antes de agendar a tarefa
  • Defina claramente quando enviar (não alertar em caso de sucesso)
  • Inclua contexto suficiente na mensagem: o que falhou, quando e qual servidor