Webhooks

Não Growth e no Ultimate, o Letlink envia JSON via POST para cada URL HTTPS registrada no espaço de trabalho quando um clique é registrado. Proprietários e administradores adicionam ou removem URLs em Integrações → Webhooks. Os membros podem ver a lista, mas não podem alterá-la.

Adicionar um endpoint

1. Disponibilize uma URL HTTPS que aceite POST com Content-Type: application/json. HTTP é rejeitado.
2. Cole-a em Integrações → Webhooks e salve. O nome do evento é link_visited.
3. Clique em um dos seus links curtos (de uma rede que não tenha ultrapassado o limite mensal). Você deve ver uma requisição em poucos segundos — a entrega fica em fila, não acontece junto com o redirecionamento.

Você também pode assinar pela API: POST /api/v1/hooks/subscribe com target_url e event opcional (o padrão é link_visited). Os REST Hooks do Zapier chamam esse mesmo par de rotas de assinatura/cancelamento.

Payload

O corpo é o objeto de visita canônico. Campos UTM ou de loja vazios são null.

{
  "visit_id": 42,
  "visit_time": "2026-09-09T18:01:22+00:00",
  "link_type": "utm",
  "link_shortcode": "summer",
  "link_domain": "letl.ink",
  "link_destination_url": "https://example.com/a",
  "utm_source": "newsletter",
  "utm_campaign": "sep",
  "utm_medium": "email",
  "google_play_app_url": null,
  "google_play_utm_source": null,
  "google_play_utm_campaign": null,
  "app_store_app_url": null,
  "app_store_ct": null,
  "instagram_username": null,
  "visitor_ip": "203.0.113.10",
  "visitor_browser": "Chrome",
  "visitor_device_type": "desktop",
  "visitor_referrer": "https://mail.example.com/",
  "visitor_variation": "hero-b"
}

Quando um webhook não dispara

• O espaço de trabalho está no Free ou no Solo (allowsWebhooks está desativado).
• O limite mensal de cliques rastreados já foi atingido — o redirecionamento acontece, mas nenhuma linha é gravada, então nada é enviado.
• Um limite de visitas por dispositivo retornou 429 antes de o clique ser armazenado.
• Uma regra de acesso por país barrou o visitante. Visitas bloqueadas nunca são armazenadas como cliques.
• A URL de destino está fora do ar. A entrega é feita com base no melhor esforço e nunca deve atrasar o visitante; publicações que falham não são repetidas a partir desta página.

Quem recebe o quê

Os hooks são armazenados por usuário. As URLs link_visited de cada membro são notificadas sobre cliques em qualquer link do espaço de trabalho. Se dois colegas assinaram o Zapier, os dois Zaps são executados. Remova URLs não usadas para que um Catch Hook esquecido não continue disparando.