Como configurar um webhook para automatizar notificações entre sistemas na hospedagem

Como configurar um webhook para automatizar notificações entre sistemas na hospedagem

Olá, amigo(a) desenvolvedor(a) ou administrador(a) de sistema! Seja muito bem-vindo(a) ao nosso guia prático e cheio de carinho, onde vamos transformar o mundo da automação em algo simples, claro e até divertido. 💡

Imagine que toda vez que um cliente se inscreve no seu site, uma mensagem automática é enviada para o seu sistema de CRM, ou que um novo pedido no seu e-commerce aciona um e-mail de confirmação. Isso é possível com um webhook — um pequeno "sinal" que diz: “Oi, algo aconteceu! Vamos reagir?”.

Na GeHost, você pode configurar webhooks diretamente no seu servidor, mesmo sem ser um especialista. Vamos juntos nesse passeio com calma, passo a passo. Afinal, cada grande sistema começou com um simples "clicar aqui". 😊

O que é um webhook?

Um webhook é como um alarme que dispara quando algo específico acontece no seu sistema. Ele envia uma mensagem automática (um "pedido HTTP") para um endereço específico (a URL que você definir), que pode ser outro sistema, um serviço de mensagens, um e-mail, ou até um sistema de monitoramento.

Dica do Sensei: Webhooks são como o “sinal de alerta” do seu sistema. Quando o evento ocorre, o webhook diz: “Ei, olha aqui!”, e manda a notícia para onde você quiser.

Passo a passo: Como configurar um webhook na GeHost

1. Entre no seu painel de controle (cPanel)

   Abra seu navegador e acesse o cPanel da sua hospedagem. Você pode fazer isso através do link que recebemos por e-mail ou pelo painel da GeHost.

   

2. Localize a ferramenta "PHP Configurador" (ou "PHP Settings")

   Na página inicial do cPanel, procure pela seção “Programas” ou “PHP”. Clique em “PHP Configurador” (ou “PHP Settings”).

   

3. Crie um arquivo PHP para receber o webhook

   Para que o webhook funcione, você precisa de um script que receba a mensagem. Vamos criar um arquivo simples.

   • Na parte superior do cPanel, clique em “Gerenciador de Arquivos”.
   • Selecione a pasta public_html (ou a pasta do seu site).
   • Clique em “Criar arquivo” (ou “New File”).
   • Digite o nome: webhook.php.
   • Clique em “Criar”.
   

4. Adicione o código PHP no arquivo

   Clique duas vezes no arquivo webhook.php para editá-lo.

   Insira o seguinte código básico:

   <?php
   // Recebe os dados do webhook
   $data = file_get_contents('php://input');
   $timestamp = date('Y-m-d H:i:s');
   
   // Salva os dados em um arquivo de log
   file_put_contents('webhook_log.txt', "Evento recebido em: $timestamp\nDados: $data\n\n", FILE_APPEND);
   
   // Responde com sucesso
   http_response_code(200);
   echo "Webhook recebido com sucesso!";
   ?>

   Salve o arquivo.

5. Defina a URL do webhook

   Seu webhook agora está ativo! A URL para ele será algo como:

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

   Essa é a "porta de entrada" que outros sistemas devem usar para enviar notificações.

6. Teste o webhook

   Use uma ferramenta como Postman ou curl para enviar um teste:

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

   Se tudo estiver certo, você verá a mensagem “Webhook recebido com sucesso!” e o arquivo webhook_log.txt será atualizado com os dados.

Dica extra: Segurança e boas práticas

Como o webhook recebe dados de fora, é importante protegê-lo. Aqui vão algumas dicas do Sensei:

• Use autenticação: Adicione um token secreto no cabeçalho e verifique-o no código.
• Validação de origem: Verifique o IP do remetente, se necessário.
• Evite logs sensíveis: Não salve dados como senhas ou cartões de crédito no log.
• Use HTTPS: Sempre que possível, use o protocolo seguro (HTTPS) para proteger os dados.

Leve em conta: Um webhook é poderoso, mas com grande poder vem grande responsabilidade. Trate os dados com cuidado, como se fossem um segredo entre amigos.

Próximos passos

Com esse webhook funcionando, você pode:

• Enviar notificações para o Slack ou Telegram.
• Atualizar um banco de dados automaticamente.
• Disparar e-mails de boas-vindas ou confirmações.
• Integrar com sistemas de CRM, ERP ou plataformas de pagamento.

Se precisar de ajuda, nosso time de suporte está aqui para te ajudar — é só chamar. E lembre-se: cada grande automação começou com um simples “clicar aqui”.

Com carinho, seu Sensei da GeHost 🌿