Máy chủ và DevOps 113 visualizações

Como implementar notificação por webhook automática

Ver no WHMCS

Como Implementar Notificação por Webhook Automática na GeHost

Olá, amigo(a) desenvolvedor(a) ou administrador(a) de site! Seja muito bem-vindo(a) ao nosso Sensei da GeHost — aqui, vamos te guiar com carinho, passo a passo, para que você entenda como configurar notificações automáticas por webhook no seu servidor. Não se preocupe: mesmo que você nunca tenha ouvido falar disso antes, vamos tornar tudo simples, claro e humano.

Dica do Sensei: Webhook é como um "sinal de alerta" automático que seu site envia para outro serviço (como WhatsApp, Telegram, Slack ou até um sistema interno) quando algo importante acontece — por exemplo, um novo pedido, um erro no sistema ou um backup concluído.

Passo 1: Entenda o que você quer notificar

Antes de tudo, pense: o que você quer ser avisado automaticamente?

  • Novo formulário enviado?
  • Erro no servidor?
  • Backup concluído com sucesso?
  • Novo usuário cadastrado?

Essa ação será o "gatilho" do seu webhook. A GeHost permite que você configure isso via scripts, mas o mais simples é usar o Gerenciador de Arquivos e um script PHP básico para disparar a notificação.

Passo 2: Acesse o Gerenciador de Arquivos do cPanel

Para começar, faça login no cPanel da sua conta na GeHost:

Tela de LOGIN do cPanel (campos Usuário e Senha + botão Log in)

Depois de logado, você verá a tela principal do cPanel:

Painel inicial (home) do cPanel com os grupos de ferramentas (E-mail, Arquivos etc.)

Clique em Gerenciador de Arquivos (File Manager), dentro da seção Arquivos.

Passo 3: Acesse a pasta pública do seu site

No Gerenciador de Arquivos, clique duas vezes na pasta public_html (ou o nome da sua pasta raiz, se diferente).

É aqui que seu site está hospedado. Vamos criar um script PHP simples para disparar o webhook.

Gerenciador de Arquivos (File Manager) — árvore de pastas (public_html etc.) e barra de ações

Passo 4: Crie um script PHP para o webhook

Clique no botão Novo Arquivo no topo do painel. Nomeie o arquivo como:

webhook-notifier.php

Depois de criado, clique duas vezes nele para editá-lo.

Insira o seguinte código PHP (substitua SEU_WEBHOOK_URL pela URL do serviço onde você quer receber a notificação — por exemplo, um webhook do Telegram ou Slack):

<?php
// URL do webhook (ex: https://api.telegram.org/bot123456789:ABCdefGHIJKlmnopQRStuVWXyz/sendMessage)
$webhook_url = 'SEU_WEBHOOK_URL';

// Dados que você quer enviar
$data = [
    'message' => 'Um evento importante ocorreu no seu site!',
    'timestamp' => date('Y-m-d H:i:s'),
    'status' => 'sucesso'
];

// Envia a notificação via cURL
$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);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// Resposta
echo "Notificação enviada com código HTTP: $http_code";
?>

Dica do Sensei: Se você não sabe qual URL usar, crie um webhook no webhook.site — é grátis e mostra tudo que chega. Use essa URL temporária para testar!

Passo 5: Teste o webhook

Agora, abra seu navegador e acesse:

https://seudominio.com.br/webhook-notifier.php

Substitua seudominio.com.br pelo domínio do seu site.

Se tudo estiver certo, você verá a mensagem:

Notificação enviada com código HTTP: 200

Isso significa que o webhook foi disparado com sucesso!

Passo 6: Automatize o disparo (opcional, mas poderoso)

Quer que o webhook seja acionado automaticamente?

  • Se for um backup, use o Backup no cPanel e configure um script que execute após o backup.
  • Se for um formulário, configure o script do formulário para chamar esse arquivo PHP após o envio.
  • Se for um erro, use o Log de Erros (em Métricas) e crie um script que verifique o log diariamente.

Dica do Sensei: Use o Cron Jobs (em cPanel) para rodar esse script automaticamente a cada hora, dia ou semana — perfeito para monitoramento contínuo!

Conclusão: Você está no caminho certo!

Parabéns, querido(a) aluno(a)! Agora você sabe como configurar uma notificação automática por webhook na GeHost. É como ter um assistente digital que te avisa sempre que algo importante acontece — sem precisar ficar olhando o servidor o tempo todo.

Se precisar de ajuda com um caso específico (como notificar no WhatsApp ou Telegram), é só pedir. Aqui na GeHost, estamos sempre prontos para te ajudar com um sorriso no coração.

Até a próxima, e lembre-se: o código é só a ponte. O verdadeiro poder está na ação.

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.