Como configurar um webhook para avisar o Slack quando o deploy terminar
Oi! Aqui é a Sensei da GeHost 🥋 Hoje vou te ensinar um truque simples e muito útil: fazer o seu Slack "apitar" sozinho assim que um deploy do seu site ou sistema terminar. Assim, você e o seu time ficam sabendo na hora — sem precisar ficar checando o servidor a cada 5 minutos.
Vamos por partes, com calma, do jeitinho que a gente gosta por aqui.
Primeiro, o que é esse tal de "webhook"?
Pensa assim: um webhook é tipo um "aviso automático" que um sistema manda pro outro quando algo acontece. No nosso caso, quando o deploy (a publicação de uma atualização do seu site/sistema) terminar, o servidor vai disparar uma mensaginha direto pro seu canal do Slack. Simples assim — nada de mágica, só um "toque" via internet.
Passo 1 — Criar o webhook dentro do Slack
- Entre na sua conta do Slack (pelo navegador ou app) e acesse o app oficial Incoming Webhooks (você encontra em "Adicionar apps" > pesquisando por "Incoming Webhooks").
- Escolha o canal onde quer receber os avisos (pode ser um canal só pra isso, tipo #deploys — fica bem organizado).
- O Slack vai te entregar uma URL única do webhook (algo como https://hooks.slack.com/services/...). É essa URL que vamos usar no próximo passo.
Dica da Sensei: essa URL do webhook é praticamente uma "senha" — qualquer um que souber dela pode mandar mensagem no seu canal. Guarde ela num lugar seguro (um gerenciador de senhas, por exemplo) e nunca cole ela em código público, tipo um repositório aberto no GitHub. 🔒
Passo 2 — Ligar o aviso ao final do seu deploy
Aqui depende de como você publica as atualizações do seu site. Os dois caminhos mais comuns são:
Se você usa o Git™ Version Control do cPanel
Se o seu deploy é feito pela ferramenta de controle de versão Git dentro do painel, dá pra configurar uma tarefa de pós-deploy (aquele arquivo .cpanel.yml do seu repositório) pra disparar o aviso automaticamente assim que a publicação terminar. Basta adicionar um comando de "chamada" pra URL do webhook, algo no estilo:
curl -X POST -H 'Content-type: application/json' --data '{"text":"🚀 Deploy finalizado com sucesso!"}' SUA_URL_DO_WEBHOOK_AQUI
Esse comando entra como mais um passo do seu processo de deploy — ou seja, ele só roda depois que os arquivos já foram atualizados no servidor.
Se você usa uma esteira de CI/CD externa (ex.: GitHub Actions, GitLab CI)
Nesse caso, o aviso não precisa nem passar pelo nosso servidor: você adiciona esse mesmo tipo de chamada como a última etapa do seu workflow de deploy, direto na configuração da esteira (ex.: um "step" final chamando a URL do webhook). Assim que o job de deploy fechar com sucesso, o Slack recebe o toque.
Dica da Sensei: não sabe ao certo se o seu plano permite configurar tarefas de pós-deploy via Git no painel, ou se você tem acesso via terminal para rodar esses comandos? Dá uma olhadinha no painel.gehost.com.br ou fala com o nosso suporte — eles te confirmam certinho o que está disponível no seu plano. 😉
Passo 3 — Teste antes de confiar de olhos fechados
- Rode o comando de teste manualmente (você pode simplesmente executar aquele
curldo Passo 2 direto, sem esperar um deploy de verdade) e veja se a mensagem chega no canal do Slack. - Depois, faça um deploy real e confirme que o aviso chegou sozinho, sem você precisar tocar em nada.
- Se quiser capricho, deixe a mensagem mais completa — por exemplo, incluindo o nome do projeto ou a hora do deploy no texto que você manda.
E se não chegar nada no Slack?
- Confira se copiou a URL do webhook completa e sem espaços.
- Veja se o webhook ainda está ativo lá no Slack (eles podem ser desativados/removidos por um admin do workspace).
- Confirme que o passo do webhook está mesmo entrando no fluxo do deploy (às vezes ele fica "fora" da etapa certa e não chega a ser executado).
Se mesmo assim continuar travado, é só chamar a gente pelo suporte — a equipe te ajuda a revisar a configuração com calma. 💛
Até o próximo guia — Sensei da GeHost.
