Skip to Content

Vercel

Vercel sends each request your site serves to Lua as it happens. Lua keeps the visits from AI crawlers (GPTBot, ClaudeBot, PerplexityBot and others) and shows them in Agent Analytics.

This uses a Vercel Drain, which needs a Vercel Pro or Enterprise plan. Vercel bills drains by the volume of data sent.

  1. In Lua, open Integrations and click Set up on the Vercel card.
  2. Click Create drain link. Lua shows a drain URL and a secret. Copy both: the secret is shown once.

2. Add the drain in Vercel

  1. In Vercel, open Team Settings > Drains and click Add Drain.
  2. Choose Logs.
  3. Name the drain and select your site’s project.
  4. Under Additional configuration for logs, choose the Production environment.
  5. Under the destination, choose Custom Endpoint:
    • Endpoint URL: the drain URL from Lua.
    • Format: JSON.
    • Signature Verification Secret: replace the generated value with the secret from Lua.
  6. Click Create Drain. Vercel sends a test request, and Lua accepts it.

Crawler visits appear in Agent Analytics as they arrive.

Troubleshooting

Lost the secret. In Lua, click New secret, then paste it into the drain in Vercel (Drains > Edit). Until you do, Vercel’s deliveries are refused.

Vercel marks the drain as errored. Check the endpoint URL and the secret match what Lua shows.

Last updated on