Os Webhooks permitem que você receba notificações automáticas em tempo real diretamente no seu servidor ou aplicação. Atualmente, esta funcionalidade está disponível para gatilhos de Ataque DDoS.
Siga o passo a passo abaixo para configurar uma nova notificação via Webhook.
Passo a Passo para Configuração
Acesse sua conta: Faça login no Painel de Controle GoCache.
Navegue até Alertas: No menu superior ou lateral, clique em "Minha Conta" e, em seguida, selecione a aba "Alertas".
Crie uma nova notificação: Clique no botão "Nova notificação".
Selecione o Canal: No campo "Canal", escolha a opção "Webhook". Os campos específicos para esta configuração serão exibidos.
Campos de Configuração
Ao selecionar o canal Webhook, você precisará preencher as seguintes informações:
URL: Insira a URL completa do seu servidor que está preparada para receber a requisição (ex:
https://api.seusite.com/webhook-gocache). A GoCache enviará uma requisição do tipo POST para este endereço.Secret: Defina uma chave de segurança (token). Este valor é de sua escolha e não está vinculado a outras senhas da GoCache. Ele serve para que seu servidor valide que a requisição foi enviada pela GoCache.
Cabeçalhos (Headers): Você pode definir quantos cabeçalhos personalizados desejar. Eles são úteis para autenticação adicional ou organização interna de logs no seu servidor.
Estrutura do Conteúdo (Body)
No corpo (body) da requisição, a GoCache utiliza variáveis dinâmicas que serão substituídas pelas informações reais no momento do alerta. Você pode utilizar:
$secret: O valor da chave que você definiu no campo "Secret".$message: Uma mensagem curta padrão, similar ao assunto do e-mail de alerta.$alert: A mensagem detalhada do alerta, contendo informações como o domínio afetado e o horário do ataque.
Exemplo de Recebimento no Servidor
Quando um alerta for disparado, seu servidor receberá um JSON com a seguinte estrutura (exemplo):
Headers:
{
"user-agent": "GoCache-Webhook-Notification/1.0",
"content-type": "application/json",
"authorization": "SuaChaveDefinida",
"x-gocache-from": "gocache"
}
Body:
{
"secret": "SuaChaveDefinida",
"message": "Ataque DDoS 09/03/2026 14:41:45 no domínio seu-site.com.br acontecendo neste momento",
"alert": "Detectamos um ataque DDoS 09/03/2026 14:41:45 direcionado ao domínio seu-site.com.br"
}
Observações Importantes
Gatilhos Disponíveis: Atualmente, o sistema de Webhook suporta apenas notificações de Ataque DDoS.
Validação: Recomendamos utilizar o campo
$secretou um Header personalizado para validar a autenticidade da requisição no seu servidor.
Ainda tem dúvidas?
Se precisar de ajuda com a configuração técnica ou tiver problemas para receber os dados no seu servidor, entre em contato com nosso suporte técnico: suporte@gocache.com.br!