Como configurar um Webhook para receber notificações automáticas de eventos do meu site

Como configurar um Webhook para receber notificações automáticas de eventos do seu site

Olá, querido(a) cliente da GeHost! 🌟

Se você está aqui, provavelmente quer automatizar algo no seu site — como receber um aviso quando um novo formulário é enviado, um novo pedido é feito ou quando algum erro acontece. Isso é possível com um Webhook!

Imagine um sinal de alerta que toca automaticamente quando algo importante acontece no seu site. O Webhook é esse sinal — ele envia dados em tempo real para um endereço específico (como um serviço de mensagens, uma planilha ou um sistema de controle). É como ter um amigo atento sempre olhando seu site por você.

Na GeHost, você pode configurar Webhooks por meio de scripts no seu site (como PHP, Node.js, Python etc.) que recebem essas notificações. Vamos juntos montar isso, passo a passo, com calma e clareza — como se fosse uma conversa entre amigos.

Passo 1: Escolha o serviço que receberá a notificação

Antes de tudo, você precisa decidir para onde o Webhook vai enviar as notificações.

• Um chat no Telegram?
• Uma planilha no Google Sheets?
• Um serviço de monitoramento como Zapier ou Make (antes Integromat)?
• Ou até um serviço próprio que você mesmo desenvolveu?

Dica sensata: Comece com algo simples, como um webhook que envia uma mensagem para um grupo do Telegram. É fácil, rápido e visualmente claro.

💡 Importante: O Webhook não é uma ferramenta do painel da GeHost — ele é criado por você no seu código. O que a GeHost oferece é o ambiente seguro e estável para rodar seu site e seus scripts.

Passo 2: Crie um endpoint (ponto de entrada) no seu site

Um endpoint é uma URL no seu site que recebe os dados do Webhook. Ele precisa estar acessível pela internet e ser capaz de receber requisições HTTP (geralmente via POST).

Exemplo de URL: https://seusite.com/webhook.php

Para criar esse endpoint:

1. Entre no painel do cliente em painel.gehost.com.br.
2. Localize seu site na lista de domínios e clique em cPanel.
3. No cPanel, acesse a ferramenta Gerenciador de Arquivos (File Manager).
4. Abra a pasta public_html (ou a pasta raiz do seu site).
5. Crie um novo arquivo chamado webhook.php (ou webhook.js se usar Node.js).

Esse arquivo será o "receptor" das notificações. Ele vai receber os dados e fazer o que você quiser com eles — salvar em um arquivo, enviar um e-mail, postar no Telegram, etc.

Passo 3: Escreva o código do Webhook

Abra o arquivo webhook.php no editor do cPanel (ou via FTP) e insira um código simples para testar. Aqui está um exemplo em PHP:

<?php
// Recebe os dados do Webhook
$data = file_get_contents('php://input');

// Salva os dados em um arquivo de log
file_put_contents('webhook_log.txt', date('Y-m-d H:i:s') . ' - Dados recebidos: ' . $data . "\n", FILE_APPEND);

// Responde com sucesso (200 OK)
http_response_code(200);
echo "Recebido com sucesso!";
?>

Esse código:

• Recebe os dados enviados pelo Webhook.
• Salva uma mensagem com data e hora no arquivo webhook_log.txt.
• Responde com 200 OK — isso é essencial! Se não responder, o sistema que enviou o evento pode achar que falhou.

Salve o arquivo e deixe ele na pasta public_html.

Passo 4: Teste o endpoint

Para testar se seu Webhook está funcionando:

1. Abra um terminal ou use um serviço como curl.trillworks.com.
2. Envie uma requisição POST com dados de teste. Exemplo:

curl -X POST https://seusite.com/webhook.php \
  -H "Content-Type: application/json" \
  -d '{"evento": "teste", "mensagem": "Olá, Webhook!"}'

Se tudo funcionar, você verá a mensagem Recebido com sucesso! no navegador e o log será gravado no arquivo webhook_log.txt.

Passo 5: Configure o sistema que dispara o evento

Agora que seu endpoint está pronto, é hora de configurar o sistema que vai disparar o evento.

Por exemplo:

• Se você usa um formulário no site, configure-o para enviar os dados para https://seusite.com/webhook.php.
• Se usa um sistema de e-commerce (como WooCommerce), configure o webhook no painel do sistema para apontar para essa URL.
• Se usa um serviço externo (como Zapier), configure-o para enviar dados para o seu endpoint.

Se o sistema que envia o evento não aceitar URLs públicas, você pode usar um serviço de proxy como ngrok para criar um link temporário — mas isso é mais avançado.

Dica final: Segurança e boas práticas

Webhooks são poderosos, mas também podem ser usados por hackers. Por isso:

• Nunca exponha dados sensíveis no corpo da requisição.
• Verifique a origem da requisição (por exemplo, validando um token secreto).
• Use HTTPS sempre — o acesso ao seu endpoint deve ser seguro.
• Monitore o arquivo de log para ver se algo estranho está acontecendo.

🌱 Um toque de sabedoria: O Webhook é uma ferramenta de automação — mas a verdadeira magia está na intenção por trás dele. Use-o para facilitar sua vida, não para complicar.

Pronto! Você está no caminho certo.

Se precisar de ajuda, entre em contato com nosso suporte — estamos aqui para te ajudar, com carinho e atenção. 💌

GeHost — seu site, sua história, nosso compromisso.

— Raphael Neves Koga, dono do Grupo G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)