Como configurar um webhook para integrar seu site a uma automação com IA

Como configurar um webhook para integrar seu site a uma automação com IA

Olá, amigo(a) desenvolvedor(a) ou empreendedor(a) digital! Seja bem-vindo(a) ao nosso guia de hoje, onde vamos juntos desvendar um dos segredos mais poderosos da web moderna: webhooks. E não se assuste com o nome — é mais simples do que parece. Vamos transformar seu site em uma máquina de ações inteligentes, conectando-o a automações com IA, como responder a clientes, enviar notificações ou até gerar conteúdo automaticamente.

Sensei diz: "A IA é como um aluno aplicado. Mas só funciona se você ensinar com clareza. Um webhook é o 'sinal de chamada' que diz: 'Chegou a hora de agir!'"

O que é um webhook?

Imagine um sistema que, assim que algo acontece no seu site (como um novo formulário enviado), envia uma mensagem automática para outro serviço — por exemplo, uma IA que responde ao cliente no WhatsApp. Esse "envio automático" é o webhook. Ele é como um botão de interação entre dois sistemas.

Passo a passo: como configurar seu webhook na GeHost

1. Entre no painel do cliente da GeHost
   Acesse painel.gehost.com.br com seu login e senha. Aqui você controla tudo: domínios, e-mails, arquivos e mais.
2. Abra o cPanel
   No painel, clique em cPanel (geralmente no menu principal). Você será redirecionado para o painel de controle do seu site.
3. Localize o Gerenciador de Arquivos
   No cPanel, procure por Gerenciador de Arquivos (File Manager). Ele está na seção "Arquivos". Clique nele.
4. Encontre a pasta do seu site
   No Gerenciador de Arquivos, selecione a pasta public_html (ou o nome do seu domínio). É aqui que estão os arquivos do seu site.
5. Crie um arquivo PHP para receber o webhook
   Clique em Novo Arquivo na barra de ações. Dê um nome como webhook.php. Clique em "Criar".
   
   Agora, clique duas vezes no arquivo para editá-lo. Cole o código abaixo (não se preocupe se não entender tudo — o importante é que ele funciona):

   <?php
   // Recebe 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
   $logfile = 'webhook-log.txt';
   file_put_contents($logfile, "[$timestamp] Dados recebidos: $data\n", FILE_APPEND);
   
   // Responde com sucesso
   http_response_code(200);
   echo "Webhook recebido com sucesso!";
   ?>
       

   Salve o arquivo.

6. Defina permissões para o arquivo
   Volte ao Gerenciador de Arquivos, clique com o botão direito no arquivo webhook.php e selecione Alterar Permissões.
   
   Defina as permissões como 644 (leitura e escrita para o dono, leitura apenas para os outros). Isso garante que o servidor possa executar o arquivo.
7. Teste o webhook localmente
   Use uma ferramenta como Postman ou curl para enviar um teste. Exemplo com curl:

   curl -X POST https://seudominio.com/webhook.php \
        -H "Content-Type: application/json" \
        -d '{"mensagem": "Teste de webhook!", "status": "ok"}'
       

   Se aparecer Webhook recebido com sucesso!, parabéns! Você acertou o caminho.

8. Configure o serviço de IA para usar seu webhook
   Agora, no painel da sua automação com IA (como Zapier, Make, ou um serviço próprio), configure o "gatilho" para enviar dados para https://seudominio.com/webhook.php.
   
   Dica: Se estiver usando uma plataforma de automação, ela geralmente pede um URL. Basta colar o endereço do seu webhook (substitua "seudominio.com" pelo seu domínio real).
9. Verifique os logs
   Volte ao Gerenciador de Arquivos e abra o arquivo webhook-log.txt. Lá você verá todas as mensagens recebidas. Se aparecerem dados, seu webhook está funcionando!

Importante: Segurança e boas práticas

• Nunca exponha seu webhook para o público — ele deve ser usado apenas entre sistemas confiáveis.
• Use autenticação — se possível, adicione um token secreto no header ou URL (ex: https://seudominio.com/webhook.php?token=abc123) e valide no código PHP.
• Evite arquivos com nomes genéricos — use nomes como ia-webhook.php para facilitar o controle.
• Monitore os logs — se algo der errado, o webhook-log.txt é seu aliado.

Sensei diz: "Um webhook é como um sinal de fumaça. Ele só serve se for visto no momento certo. E o seu site é o farol que o envia."

Quer ajuda extra?

Se precisar de suporte técnico, entre em contato com nosso time pelo painel do cliente. Lembre-se: temos 30 dias grátis após a entrega para te ajudar em qualquer dúvida — e estamos aqui para te guiar, com paciência e carinho.

Seu site está pronto para conversar com a IA. Agora, é só deixar o mundo saber que você está conectado ao futuro.

Com carinho,
Sensei da GeHost
*Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)*