Webhooks
Visão Geral
Nessa página você entenderá o que é o Webhook da Alocis e quando você deve utilizar desse protocolo para receber as informações.
O que significa Webhook
Webhook é um protocolo de comunicação criado para comunicação entre sistemas, a ideia é sempre que você precisar saber que aconteceu alguma coisa na Alocis, a gente lhe avisa, sem precisar ficar consultando nosso sistema a cada período.
Essa é uma forma de comunicação muito poderosa, pois nosso sistema avisa o seu praticamente em tempo real, o que permite que o sistema integrado interaja com a informação, realizando processamentos internos de acordo com o ocorrido.
A Alocis envia a informação para seu sistema de acordo com o configurado no painel.
Quando usar?
Esses são alguns casos de uso que fazem sentido realizar a integração por meio de webhooks:
- Liberar acesso — Libere curso, área restrita ou produto digital assim que o pagamento confirmar.
- Sincronizar informações — Atualize CRM, planilha ou ferramenta de automação (Zapier, n8n, Make) em tempo real.
- Automatizar avisos — Dispare e-mails ou mensagens internas quando assinatura atrasa ou carrinho abandona.
Como configurar?
Em poucos passos você deixa a integração pronta para receber notificações:
- URL HTTPS — Cadastre uma URL pública em HTTPS (seu backend ou ferramenta de automação). Endereços locais ou privados não são aceitos.
- Eventos — Marque só os tipos de evento que sua integração precisa — por exemplo pagamento aprovado ou assinatura cancelada.
- Teste — Ao salvar, a Alocis envia um POST de prova (endpoint.test). Responda 2xx em até 10 segundos para validar a URL.
- Processar — Nos eventos reais, valide o token no JSON, execute sua lógica e responda 2xx. Guarde o token em local seguro.