Zapier

Zapier se comunica con la misma API REST que tus propios scripts. Necesitas un espacio de trabajo Growth o Ultimate y un token de API de Integraciones → Zapier (o API: es el mismo token).

Conecta la app

1. En Zapier, agrega la conexión de Letlink y pega el token de API cuando te lo pida.
2. Zapier llama a GET /api/v1/auth/me para verificarlo.
3. Si la prueba falla con 403, el plan del espacio de trabajo aún no incluye la API: mejora a Growth.

Disparador: se visita un enlace

Es un REST Hook en el evento link_visited. Cuando activas el Zap, Zapier envía un POST a /api/v1/hooks/subscribe con su Catch URL. A partir de ahí, cada clic registrado se envía por POST con la estructura del payload del webhook (consulta Webhooks). Mientras asignas campos, Zapier también puede llamar a GET /api/v1/visits para obtener filas de ejemplo; ese endpoint devuelve los últimos 50 clics con la misma estructura.

Campos útiles en el Zap: link_shortcode, link_destination_url, visitor_device_type, visitor_browser, visitor_referrer, visitor_variation, utm_source, utm_campaign, instagram_username.

Acción: crear un enlace

Corresponde a POST /api/v1/links. Puedes pasar type, destination, short_code, title, domain y los campos de tipos inteligentes (ios_url, android_url, etc.). Los tipos inteligentes en el plan Free y los espacios de trabajo por encima del límite devuelven un error en el registro de ejecución del Zap.

Notas operativas

• Regenerar el token en Letlink rompe la conexión de Zapier hasta que pegues el nuevo valor.
• Al desactivar un Zap, el hook debería cancelar su suscripción. Si queda una Catch URL, elimínala en Integraciones → Webhooks.
• Los enlaces con mucho tráfico generarán una ejecución de Zap por cada clic registrado. Filtra en Zapier (por ejemplo, solo visitor_variation = qr) en lugar de registrar un segundo código corto.