Como configurar notificações Slack para erros da aplicação Print

Como configurar notificações no Slack para erros da sua aplicação

Olá, dev! 👋 Seja bem-vindo(a) ao guia da GeHost, onde transformamos o complexo em simples — especialmente quando o assunto é monitoramento de erros. Neste tutorial, você vai aprender, passo a passo, como receber notificações no Slack sempre que sua aplicação apresentar um erro, sem precisar ficar vigiando logs o dia todo.

É como ter um guardião digital que te avisa no momento exato — e tudo isso com apenas algumas configurações no seu painel de controle. Vamos lá?

Passo 1: Prepare o seu Slack

Antes de qualquer coisa, você precisa ter um canal no Slack onde as notificações vão chegar. Se ainda não tem, crie um canal chamado #erros-aplicacao ou algo parecido.

Dica do Sensei: Use um canal dedicado para erros. Assim, você não perde as notificações no meio do barulho do dia a dia!

Passo 2: Crie um Webhook no Slack

Para que o Slack receba as notificações, você precisa gerar um Webhook — uma espécie de “porta de entrada” segura.

1. Entre no seu Slack.
2. Na barra lateral, clique em Apps (no canto inferior esquerdo).
3. Busque por “Incoming Webhooks” e clique em “Configure”.
4. Escolha o canal onde as mensagens vão aparecer (ex: #erros-aplicacao).
5. Clique em “Add Incoming Webhook”.
6. Copie a URL que aparecer — ela começa com https://hooks.slack.com/services/. Guarde com cuidado!

Passo 3: Acesse o Painel da GeHost (cPanel)

Seu próximo passo é entrar no painel de controle da GeHost — o cPanel, o coração da sua hospedagem.

• Abra seu navegador e vá para https://cpanel.gehost.com.br.
• Insira seu usuário e senha (os mesmos da sua conta).

Passo 4: Acesse o Gerenciador de Arquivos

As notificações de erro geralmente são enviadas por scripts que rodam no servidor. Para configurar isso, vamos usar o Gerenciador de Arquivos do cPanel.

1. Na tela inicial do cPanel (home), encontre a seção “Arquivos”.
2. Clique em “Gerenciador de Arquivos”.

Passo 5: Localize o arquivo de configuração da sua aplicação

Agora, você precisa encontrar o arquivo onde o erro será detectado — geralmente um script de log ou uma função de monitoramento.

1. No Gerenciador de Arquivos, clique em public_html (ou a pasta raiz da sua aplicação).
2. Procure por arquivos como:
   • error.log
   • app.php ou index.php (dependendo da estrutura)
   • monitor.php ou notify_slack.php (se já existir)

Passo 6: Crie um script simples para enviar notificações

Vamos criar um pequeno script PHP que verifica os erros e envia uma mensagem no Slack.

Se você ainda não tem um script de notificação, clique em “Novo Arquivo” no Gerenciador de Arquivos e crie um arquivo chamado notify_slack.php.

Abra o arquivo e cole este código (substitua o URL pelo seu Webhook):

<?php
// URL do seu Webhook do Slack (substitua pelo seu)
$webhook_url = 'https://hooks.slack.com/services/SEU/WEBHOOK/EXEMPLO';

// Mensagem de erro
$error_message = '🚨 Erro detectado na aplicação: ' . date('Y-m-d H:i:s') . ' - Verifique os logs.';

// Dados para enviar
$data = [
    'text' => $error_message,
    'username' => 'GeHost Monitor',
    'icon_emoji' => ':warning:'
];

// Envia a notificação
$ch = curl_init($webhook_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

// Opcional: registrar no log
file_put_contents('slack_notify.log', "Notificação enviada às " . date('Y-m-d H:i:s') . "\n", FILE_APPEND);
?>

Dica do Sensei: Seu script pode ser chamado por um crontab a cada 5 minutos para verificar erros automaticamente. Vamos ver isso no próximo passo!

Passo 7: Configure o Cron para rodar o script automaticamente

Para que o sistema verifique erros sem você precisar fazer nada, vamos usar o Cron do cPanel.

1. No cPanel, vá até a seção “Cron Jobs” (em “Tarefas Agendadas”).
2. Na opção “Common Settings”, escolha “Every 5 minutes”.
3. Na caixa “Command”, insira: php /home/SEU_USUARIO/public_html/notify_slack.php
4. Clique em “Add New Cron Job”.

Pronto! Agora, a cada 5 minutos, o script vai verificar se há erros e enviar uma notificação no Slack — mesmo quando você estiver dormindo. 😴

Passo 8: Teste e confirme

Para garantir que tudo está funcionando:

1. Forçar um erro na sua aplicação (ex: tentar acessar uma página inexistente).
2. Esperar 5 minutos (ou menos, se o cron estiver configurado para rodar mais rápido).
3. Verifique o canal do Slack — você deve receber uma mensagem como:

   🚨 Erro detectado na aplicação: 2025-04-05 10:30:15 - Verifique os logs.

Se aparecer, parabéns! Você acaba de transformar sua hospedagem em um sistema inteligente e proativo. 🎉

Conclusão

Configurar notificações no Slack para erros da sua aplicação não é só possível — é simples, rápido e muito poderoso. Com esse guia, você agora tem um sistema de alerta que cuida de você mesmo quando não está olhando.

Se tiver dúvidas, não hesite em entrar em contato com nosso suporte. Estamos aqui para te ajudar — como um verdadeiro companheiro de jornada.

Até a próxima, dev. 🙏