Configurando integração com Slack

Como configurar a integração com Slack

Configure webhooks do Slack para receber alertas automáticos de monitoramento diretamente no seu workspace, mantendo toda a equipe informada em tempo real.

Passo 1: Criando um Webhook no Slack

Primeiro, você precisa criar um webhook no seu workspace do Slack:

  1. Acesse o Slack API em api.slack.com
  2. Clique em "Create an app" ou "Criar um aplicativo"
  3. Selecione "From scratch" (Do zero)
  4. Digite um nome para o app (ex: "SuperPing Alertas")
  5. Escolha o workspace onde quer receber os alertas
  6. Clique em "Create App"

Passo 2: Configurando o Webhook

Agora configure o webhook para envio de mensagens:

  1. No painel do seu app, clique em "Incoming Webhooks"
  2. Ative o toggle "Activate Incoming Webhooks"
  3. Clique em "Add New Webhook to Workspace"
  4. Escolha o canal onde quer receber os alertas (ex: #alertas, #monitoramento)
  5. Clique em "Allow" para autorizar
  6. Copie a URL do webhook que foi gerada

💡 Dica de organização

Crie um canal específico para alertas (ex: #superping-alertas) para manter as notificações organizadas e não atrapalhar outras conversas.

Passo 3: Configurando na SuperPing

Agora configure o webhook na SuperPing:

  1. No seu dashboard da SuperPing, vá em "Integrações"
  2. Localize o card do Slack
  3. Cole a URL do webhook no campo "Webhook URL"
  4. Clique em "Salvar Integração Slack"
  5. Aguarde a confirmação de sucesso

Testando a integração

Para verificar se tudo está funcionando:

  1. Crie um monitor de teste ou pause um monitor existente
  2. Aguarde alguns minutos
  3. Verifique se a mensagem chegou no canal do Slack
  4. Se não chegou, verifique se a URL do webhook está correta

Personalizando as mensagens

As mensagens do Slack incluem:

Configurações avançadas do Slack

Criando canais específicos

Organize os alertas por critérios:

Configurando menções

Para alertas críticos, configure menções automáticas:

Integrando com workflows do Slack

Use o Slack Workflow Builder para automatizar:

  1. Criação automática de tickets
  2. Notificação de pessoas específicas por horário
  3. Escalação automática após X minutos
  4. Criação de threads para organizar discussões

Múltiplos webhooks

Você pode configurar diferentes webhooks para diferentes tipos de alerta:

Webhook para alertas críticos


Canal: #alertas-urgentes
Webhook: https://hooks.slack.com/services/T123/B123/abc123
Uso: Sites fora do ar, problemas graves

Webhook para alertas de performance


Canal: #performance
Webhook: https://hooks.slack.com/services/T123/B456/def456
Uso: Sites lentos, degradação de performance

Horários de funcionamento

Configure alertas por horário:

Mensagens personalizadas

Exemplo de mensagem simples que você receberá no Slack:


🔴 ALERTA: Site Principal está OFFLINE

📊 Detalhes:
• URL: https://meusite.com
• Status: Timeout (1 min)
• Verificação: São Paulo, BR
• Horário: 15:30 - 25/01/2024

🔗 Ver detalhes: https://app.superping.com/monitor/abc123

Mensagens avançadas com Block Kit

Para mensagens mais ricas e interativas, a SuperPing pode usar Block Kit:


{
  "blocks": [
    {
      "type": "header",
      "text": {
        "type": "plain_text",
        "text": "🔴 ALERTA: Site Principal OFFLINE"
      }
    },
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*URL:*
https://meusite.com"
        },
        {
          "type": "mrkdwn",
          "text": "*Status:*
Timeout (1 min)"
        }
      ]
    },
    {
      "type": "actions",
      "elements": [
        {
          "type": "button",
          "text": {
            "type": "plain_text",
            "text": "Ver Detalhes"
          },
          "url": "https://app.superping.com/monitor/abc123"
        }
      ]
    }
  ]
}

Configuração avançada via OAuth

Para aplicações que precisam gerar webhooks programaticamente:

Usando OAuth para Apps distribuídas

  1. Inclua o escopo incoming-webhook na instalação OAuth
  2. Usuário escolhe o canal durante autorização
  3. Webhook URL é retornado na resposta OAuth
  4. Use a URL gerada automaticamente

Resposta OAuth com webhook


{
  "ok": true,
  "access_token": "xoxp-XXXXXXXX-XXXXXXXX-XXXXX",
  "incoming_webhook": {
    "channel": "#alertas",
    "channel_id": "C05002EAE",
    "url": "https://hooks.slack.com/TXXXXX/BXXXXX/XXXXXXXXXX"
  }
}

Integrando com ferramentas de DevOps

PagerDuty + Slack

Combine com PagerDuty para escalação automática:

  1. Slack recebe alerta primeiro
  2. Se não houver resposta em 5 minutos
  3. PagerDuty dispara telefone/SMS
  4. Escalação automática para supervisor

Jira + Slack

Crie tickets automaticamente:

  1. Alerta chega no Slack
  2. Bot do Jira cria ticket automaticamente
  3. Link do ticket aparece no Slack
  4. Updates do ticket voltam para o Slack

Troubleshooting

Webhook não funciona

Problema: Mensagens não chegam no Slack

Soluções:

Teste manual do webhook


curl -X POST -H 'Content-type: application/json' \
  --data '{"text":"Teste da SuperPing"}' \
  https://hooks.slack.com/services/T123/B123/abc123

Códigos de erro comuns

A API do Slack pode retornar os seguintes erros:

Muitas mensagens

Problema: Spam de alertas no Slack

Soluções:

Melhores práticas

Organização

Segurança

Performance

✅ Checklist de configuração

  1. ☐ Webhook criado no Slack
  2. ☐ Canal de alertas configurado
  3. ☐ URL adicionada na SuperPing
  4. ☐ Teste realizado com sucesso
  5. ☐ Equipe informada sobre o canal
  6. ☐ Horários de alerta definidos
  7. ☐ Escalação configurada

Próximos passos

Após configurar o Slack:

Referências úteis

Links importantes para configuração e troubleshooting:

Suporte e ajuda

Se tiver problemas: