Webhooks: os cliques nos seus links chegam sozinhos ao seu servidor

O Lix.li envia um evento a cada clique direto para sua URL via HTTP POST — em tempo real, assinado com HMAC e com entrega confiável. Nada de ficar consultando a API o tempo todo: os dados chegam sozinhos no momento do clique.

Configurar um webhook Ver o formato dos dados

Tempo real · assinatura HMAC · retentativas e log de entregas

# Lix.li itself sends POST to your server during transitions POST https://your-server.com/hooks X-Lix-Signature: sha256=9f86d0818884… Content-Type: application/json { "event_type": "redirects.batch", "count": 2, "events": [ { "link_id": 9053352, "country": "DE", "device": "mobile" } ] }

Para que servem os webhooks

Receba os dados de cada clique na hora e construa seus próprios fluxos em cima deles

Tempo real

Os eventos chegam no momento do clique. Sem precisar consultar a API de tempos em tempos e esperar atualização.

Dados de cada clique

País, cidade, dispositivo, sistema operacional, navegador, origem e sinalização de bot — tudo o que você precisa para sua própria análise.

Seguro por padrão

Cada requisição é assinada com HMAC usando seu próprio segredo, então fica fácil diferenciar eventos reais de falsificados.

Entrega confiável

Se seu servidor cair, a entrega é reenviada. Todas as tentativas e status ficam visíveis no log de entregas.

Casos de uso

Para onde os eventos de clique costumam ser direcionados

Lix.li POST
Sua própria análise ou CRM

Grave cada clique no seu próprio banco de dados ou CRM e monte relatórios do seu jeito.

Lix.li POST
Notificações no chat

Deixe um bot do Telegram, Slack ou Discord avisar sobre novos cliques na hora, sem checagem manual.

Lix.li POST
Automação

Dispare fluxos no Zapier, Make ou n8n: um evento de clique vira o gatilho para qualquer ação seguinte.

O que chega no webhook

O evento redirects.batch: um único payload agrupa um lote de cliques de uma janela de tempo

{ "delivery_id": "d_01HXY9F0…", "event_type": "redirects.batch", "sent_at": "2026-08-04T10:15:00Z", "window": { "from": "…10:14:00Z", "to": "…10:15:00Z" }, "count": 1, "truncated": false, "events": [ { "event_id": "e_9f86d0…", "link_id": 9053352, "datetime": "2026-08-04T10:14:12Z", "country": "DE", "city": "Berlin", "browser": "Chrome", "os": "Android", "device": "mobile", "ref_domain": "t.me", "group_id": null, "is_bot": false } ] }

O IP do visitante não é incluído por padrão (são dados pessoais) — só é adicionado se você habilitar isso explicitamente para aquele endpoint.

O que dá para fazer com webhooks

Configuração flexível, segurança sólida e entrega previsível

Entrega de eventos em lotes

Os cliques chegam agrupados (redirects.batch) em uma janela de tempo — isso economiza requisições no seu servidor.

Escopo do seu jeito

Todos os links da conta, um grupo específico ou um único link — receba só os eventos que você realmente precisa.

Assinatura HMAC

Cada requisição é assinada com o seu segredo. Você pode regenerar o segredo quando quiser.

Retentativas e desativação automática

Servidor fora do ar? A entrega é reenviada; um endpoint que fica "morto" é desativado automaticamente.

Log de entregas

Histórico de todos os envios, com status e corpo da requisição — fácil de rastrear o que deu errado.

Envio de teste (ping)

Valide a integração com um clique antes de qualquer tráfego real — seu servidor recebe um evento de teste.

Dados ricos em cada evento

link_id, data e hora, país, cidade, sistema operacional, dispositivo, navegador, origem e sinalização de bot em cada clique.

Privacidade por padrão

O IP não é enviado a menos que você ative isso explicitamente para um endpoint específico.

Experimente grátis

Como configurar um webhook

Cinco passos — da URL do seu servidor até um fluxo contínuo de eventos de clique

1
Crie um endpoint

Cadastre-se no Lix.li, abra a seção Webhooks e informe a URL do seu servidor — é para lá que o Lix.li vai enviar os eventos de clique.

2
Escolha o escopo

Decida de quais links você quer receber eventos: todos os links da conta, um grupo específico ou um único link.

3
Guarde o segredo de assinatura

O Lix.li gera uma chave secreta. Cada requisição é assinada com HMAC — confira a assinatura no cabeçalho para confirmar que o evento realmente veio do Lix.li.

4
Envie uma requisição de teste

Clique em "Testar" (ping) e confirme que seu servidor aceita a requisição e responde com um 2xx. Assim você valida a integração antes de receber tráfego real.

5
Acompanhe o log de entregas

O log mostra todos os envios, seus status e as retentativas. Se o servidor ficar indisponível, a entrega é reenviada, e um endpoint que fica "morto" é desativado automaticamente.

Configurar um webhook

Perguntas frequentes sobre webhooks

Um webhook é uma notificação HTTP que o Lix.li envia sozinho para o seu servidor quando algo acontece. Você não precisa consultar nenhuma API: os dados chegam automaticamente no momento do clique no seu link.
Os cliques nos seus links curtos. Os eventos chegam em lotes (event_type = redirects.batch); cada clique traz data e hora, país, cidade, sistema operacional, dispositivo, navegador, origem e sinalização de bot.
JSON via HTTP POST. O corpo tem campos de controle (delivery_id, janela de tempo, count) e um array events com os dados de cada clique. Um exemplo completo do corpo da requisição está nesta página.
Cada requisição é assinada com HMAC a partir da sua chave secreta — compare a assinatura do cabeçalho com o corpo da requisição para filtrar falsificações. Você pode regenerar o segredo (rotação) quando quiser.
A entrega é reenviada automaticamente. Se um endpoint ficar muito tempo sem responder, ele é desativado temporariamente, e todas as tentativas e seus status ficam no log de entregas — nada se perde sem você notar.
Dá sim. Você escolhe o escopo: todos os links da conta, links de um grupo específico ou um único link. Assim seu servidor não recebe tráfego desnecessário.
Por padrão, não — são dados pessoais. O IP só entra nos eventos se você habilitar isso explicitamente nas configurações daquele endpoint.
Webhooks estão disponíveis no plano Premium. Cadastre-se e assine o Premium para conectar seu endpoint.

Construa integrações em cima dos eventos de clique

Configure um webhook em poucos minutos — e receba os dados de clique exatamente onde você precisa.

Os webhooks do Lix.li são uma forma de receber notificações de clique dos seus links curtos automaticamente. Em vez de ficar consultando uma API o tempo todo, você informa a URL do seu servidor, e o Lix.li manda um HTTP POST para lá no momento do clique. É o clássico HTTP callback para links curtos, levando os eventos de clique até o seu sistema em tempo real.

Cada corpo de requisição é um evento redirects.batch com um array de cliques: cada um traz data e hora, país, cidade, navegador, sistema operacional, dispositivo, origem e sinalização de bot. Dá para jogar esses dados direto no seu banco de dados ou CRM, transformá-los em notificações de clique no Telegram, Slack ou Discord, ou usá-los como gatilho no Zapier, Make e n8n. As requisições são protegidas por assinatura HMAC: você confere a assinatura do cabeçalho com o corpo e filtra falsificações, podendo regenerar o segredo sempre que precisar.

A entrega é previsível: se o servidor cair, os eventos são reenviados, um endpoint que fica "morto" é desativado temporariamente, e todas as tentativas aparecem no log de entregas. Você pode limitar o escopo a todos os links, a um grupo ou a um único link, e validar a integração com um envio de teste (ping) antes de qualquer tráfego real. Os webhooks funcionam junto com os links curtos do Lix.li, os QR codes e as estatísticas, e estão disponíveis no plano Premium.

Configurar um webhook