Como configurar um webhook para integrar a IA do site com o WhatsApp Business
Olá, querido(a) cliente da GeHost! Seja bem-vindo(a) ao seu guia prático, com carinho e paciência, como se fosse uma conversa entre amigos. Hoje vamos te ajudar a conectar a inteligência artificial do seu site ao WhatsApp Business — uma forma incrível de automatizar atendimento, receber mensagens e até vender mais, sem precisar ficar o dia inteiro no celular.
Este guia é feito especialmente para quem não é técnico, mas quer usar a tecnologia com confiança. Vamos passo a passo, com linguagem simples, como se eu estivesse explicando pessoalmente. Seu site está hospedado na GeHost? Ótimo! Já temos o terreno pronto para construir essa integração.
1. Entenda o que é um webhook
Um webhook é como um "alarme digital". Quando algo acontece no seu site (ex.: um cliente envia uma mensagem via formulário), o webhook envia uma notificação automática para outro serviço — no nosso caso, o WhatsApp Business.
Imagine que seu site é uma loja. Quando alguém compra algo, em vez de você olhar o site todo minuto, o sistema manda um alerta no WhatsApp: “Novo pedido!”. É isso que vamos fazer.
Dica Sensei: O webhook não é uma coisa que você configura no WhatsApp. Ele é configurado no seu site (no servidor da GeHost), e o WhatsApp recebe a mensagem por meio de uma API (um canal de comunicação seguro).
2. Prepare seu site para receber o webhook
Antes de tudo, você precisa ter um script (um pequeno programa) no seu site que receba as mensagens e as envie para o WhatsApp. Esse script pode ser escrito em PHP, JavaScript ou outra linguagem compatível com o cPanel da GeHost.
Se você não sabe programar, não se preocupe! Existem ferramentas prontas (como ManyChat, Chatfuel ou FlowXO) que fazem isso por você — e elas geralmente fornecem um endpoint (URL) onde o webhook deve ser enviado.
Passo a passo:
- Escolha uma ferramenta de automação que suporte integração com WhatsApp Business (via API).
- Configure um novo "fluxo" ou "gatilho" que receba dados via HTTP POST.
- Na ferramenta, anote a URL de recebimento do webhook. Ela será algo como:
https://seusite.com/webhook.php(você vai criar esse arquivo no seu site).
3. Acesse o cPanel da GeHost
O cPanel é o painel de controle do seu site. Vamos usá-lo para criar o arquivo que receberá as mensagens.
Para acessar:
- Entre no seu painel do cliente: painel.gehost.com.br
- Selecione o domínio do seu site.
- Clique em cPanel (geralmente está no menu "Hospedagem").
4. Acesse o Gerenciador de Arquivos
Com o cPanel aberto, procure por Gerenciador de Arquivos (File Manager).
Na tela do cPanel, clique em File Manager dentro da seção "Arquivos".
5. Crie o arquivo do webhook
No Gerenciador de Arquivos, navegue até a pasta public_html (é onde o site é acessado na internet).
Clique no botão Novo Arquivo (ou "New File") e digite o nome do arquivo, por exemplo:
webhook.php
Após criar o arquivo, clique duas vezes nele para editá-lo.
6. Insira o código do webhook (simples e seguro)
Na janela de edição, cole o seguinte código básico (em PHP). Ele recebe dados do formulário e os envia para o WhatsApp:
<?php
// Recebe os dados do formulário via POST
$data = file_get_contents("php://input");
$decoded = json_decode($data, true);
// Verifica se temos um nome e uma mensagem
if (isset($decoded['nome']) && isset($decoded['mensagem'])) {
$nome = $decoded['nome'];
$mensagem = $decoded['mensagem'];
// Aqui você pode chamar a API do WhatsApp Business
// Exemplo: enviar para um número via WhatsApp Business API
// (Você precisará de um token e número de telefone do WhatsApp Business)
// Exemplo de envio (substitua pelos dados reais da sua conta)
$whatsapp_url = "https://graph.facebook.com/v18.0/SEU_NUMERO_ID/messages";
$token = "SEU_TOKEN_AQUI";
$message = "Novo contato: $nome\nMensagem: $mensagem";
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $whatsapp_url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
"messaging_product" => "whatsapp",
"to" => "SEU_NUMERO_WHATSAPP",
"text" => ["body" => $message]
]));
curl_setopt($curl, CURLOPT_HTTPHEADER, [
"Authorization: Bearer $token",
"Content-Type: application/json"
]);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);
// Responde com sucesso
http_response_code(200);
echo "Mensagem recebida e enviada ao WhatsApp.";
} else {
http_response_code(400);
echo "Dados incompletos.";
}
?>Dica Sensei: Esse código é um exemplo básico. Para usar com segurança, você precisa de um número de WhatsApp Business com acesso à API do Facebook (Meta), um token de acesso e um número de telefone válido. Essas configurações não são feitas na GeHost — são no WhatsApp Business Manager.
7. Salve o arquivo
Depois de colar o código, clique em Salvar ou Salvar Arquivo.
Seu webhook agora está ativo! Qualquer mensagem enviada para https://seusite.com/webhook.php será recebida e processada.
8. Configure o formulário do seu site
Seu site precisa enviar as mensagens para esse endpoint. No formulário (HTML), o atributo action deve apontar para:
https://seusite.com/webhook.phpExemplo de formulário simples:
<form action="https://seusite.com/webhook.php" method="POST">
<input type="text" name="nome" placeholder="Seu nome" required>
<textarea name="mensagem" placeholder="Sua mensagem" required></textarea>
<button type="submit">Enviar</button>
</form>9. Teste com segurança
Antes de usar em produção, teste com um formulário de teste. Envie uma mensagem e veja se aparece no WhatsApp Business.
Se nada acontecer, verifique:
- O URL do webhook está correto.
- O token do WhatsApp está válido.
- O número do WhatsApp Business está configurado corretamente.
- O cPanel permite requisições POST (geralmente sim, por padrão).
10. Proteja seu webhook
Para evitar que qualquer pessoa envie mensagens falsas, você pode adicionar uma chave de segurança (token) no URL