Como configurar notificações no Slack ou Discord quando um deploy falha

Como configurar notificações no Slack ou Discord quando um deploy falha

Olá, viajante da DevOps! Seja bem-vindo ao seu guia prático e humano para manter o controle do seu projeto, mesmo quando algo dá errado. Aqui, você vai aprender, passo a passo, como receber notificações em tempo real no Slack ou Discord sempre que um deploy (envio de código) falhar — assim, você nunca perde um erro importante, mesmo que esteja longe do computador.

Este guia foi feito com carinho para quem está começando, ou mesmo para quem já tem experiência, mas quer um jeito simples e seguro de manter o time alinhado. Vamos lá?

Antes de começar: o que você precisa

Para seguir este guia, você vai precisar de:

• Um Slack ou Discord com um canal dedicado para notificações (ex: #notificacoes-deploy).
• Um webhook gerado nesse canal (você vai aprender a criar).
• Seu acesso ao painel da GeHost (painel.gehost.com.br).
• Seu projeto configurado com um sistema de deploy (como Git, CI/CD, ou um script personalizado).

Dica Sensei: Não se preocupe se não sabe o que é webhook. É só um "endereço de entrega" que o Slack ou Discord te dá para receber mensagens automaticamente. Vamos criar isso juntos!

Passo 1: Crie um webhook no Slack ou Discord

Abra o seu Slack ou Discord e vá até o canal onde quer receber as notificações (ex: #notificacoes-deploy).

Para Slack:

1. Clique com o botão direito no canal e escolha “Integrações”.
2. Procure por “Incoming Webhooks” e clique em “Configure”.
3. Escolha o canal onde as mensagens serão enviadas.
4. Salve e copie o URL do webhook (ele começa com https://hooks.slack.com/services/).

Para Discord:

1. Abra o canal e clique nos três pontos ao lado do nome do canal.
2. Escolha “Integrações” → “Webhooks”.
3. Clique em “Criar Webhook”.
4. Dê um nome (ex: “Deploy Falhou”) e salve.
5. Clique em “Copy” para copiar o URL do webhook (ele começa com https://discord.com/api/webhooks/).

Passo 2: Acesse o painel da GeHost

Entre no seu painel de controle em painel.gehost.com.br com suas credenciais.

Se você não tem acesso, entre em contato com o suporte da GeHost — estamos aqui para ajudar!

Passo 3: Configure o sistema de deploy para enviar notificações

Este é o coração do guia. Você vai precisar ajustar o script ou ferramenta que faz o deploy do seu site. Aqui está um exemplo genérico com curl (usado em muitos sistemas de CI/CD, como GitHub Actions, GitLab CI ou scripts próprios).

Quando o deploy falhar, o sistema deve executar um comando como este:

curl -X POST -H 'Content-type: application/json' \
  --data '{"text":"🚨 Deploy falhou no ambiente: produção. Verifique o log."}' \
  https://hooks.slack.com/services/SEU_WEBHOOK_AQUI

Substitua https://hooks.slack.com/services/SEU_WEBHOOK_AQUI pelo URL que você copiou no passo 1.

Dica Sensei: Se estiver usando um sistema como GitHub Actions, você pode adicionar um passo no workflow que verifica se o deploy foi bem-sucedido. Se não for, usa o curl acima para disparar a notificação.

Passo 4: Teste a notificação

Para garantir que tudo está funcionando:

1. Forçar uma falha no deploy (por exemplo, apagar um arquivo necessário ou colocar um erro no código).
2. Execute o processo de deploy.
3. Verifique se apareceu uma mensagem no seu canal do Slack ou Discord com a mensagem de erro.

Se aparecer, parabéns! Você está no controle total do seu projeto. Se não aparecer, verifique:

• O URL do webhook está correto?
• O sistema de deploy está executando o comando de notificação?
• O firewall ou rede está bloqueando o envio?

Passo 5: Mantenha tudo seguro

Seu webhook é como uma senha. Nunca compartilhe ele com ninguém e evite colocá-lo em arquivos públicos (como repositórios no GitHub).

Se precisar, pode gerar um novo webhook a qualquer momento no Slack ou Discord.

Conclusão: você está no comando

Com esse simples ajuste, você transforma um momento de frustração — uma falha no deploy — em uma oportunidade de ação rápida. E, melhor ainda: seu time sabe exatamente quando algo deu errado, mesmo que esteja dormindo.

Se tiver dúvidas, ou precisar de ajuda com o script do seu deploy, é só chamar o suporte da GeHost. Nós estamos aqui, com um coração de código e um sorriso de humano.

Com carinho,
Sensei da GeHost
— Raphael Neves Koga, dono da G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)