Enlaces cortos para SaaS: integre URLW en su producto mediante API

Los productos SaaS modernos generan diariamente URLs para compartir: invitaciones de equipo, compartidos de documentos, enlaces de descarga, páginas de estado... Integrar un acortador de URL directamente en su SaaS mejora la experiencia del usuario y le da una visibilidad precisa sobre los comportamientos de compartición. La API de URLW hace que esta integración sea rápida y fiable.

Por qué los SaaS se benefician de los enlaces cortos

La integración de un acortador de URL en un SaaS responde a varios casos de uso concretos:

• Enlaces de invitación: «Invite a un colega» genera un enlace corto personalizado con el nombre del invitante y un token de invitación — legible, compartible por SMS o email
• Compartición de contenido: sus usuarios comparten informes, paneles de control o documentos. Un enlace corto go.su-saas.com/informe-xyz es mucho más profesional que la URL interna de su app
• Descargas y exportaciones: los enlaces de descarga temporales suelen ser largos y complejos. Un enlace corto con expiración es más tranquilizador para el usuario
• Notificaciones y emails transaccionales: los enlaces en sus emails de notificación (confirmación, restablecimiento de contraseña, etc.) pueden beneficiarse de un dominio coherente con su marca
• Analíticas sobre los compartidos: mida cuántos enlaces generados por sus usuarios son efectivamente clicados — una métrica de engagement muy valiosa

Integrar la API de URLW en su SaaS

A continuación se muestra un ejemplo de integración para generar automáticamente un enlace corto al compartir un informe:

curl -X POST https://urlw.fr/api/v1/links \
-H "Authorization: Bearer SU_CLAVE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.su-saas.com/informes/rpt_a1b2c3?token=eyJhbGc...",
"slug": "informe-junio-equipo-acme",
"domain": "share.su-saas.com",
"expires_at": "2025-07-31T23:59:59Z",
"metadata": {
  "user_id": "usr_456",
  "report_id": "rpt_a1b2c3",
  "workspace": "acme-corp"
}
}'

El campo metadata le permite almacenar identificadores internos que le permitirán relacionar cada clic de URLW con un usuario y un objeto específico en su base de datos.

Webhooks de URLW para notificaciones en tiempo real

En lugar de hacer polling a la API de URLW para detectar nuevos clics, configure webhooks para recibir una notificación HTTP en tiempo real con cada evento:

• Evento link.clicked: recibido con cada clic en un enlace. Contiene el ID del enlace, la fecha/hora, el país y el tipo de dispositivo.
• Evento link.expired: notifica cuando un enlace alcanza su fecha de expiración o su número máximo de clics.
• Evento link.created: útil para sincronizar los enlaces creados mediante la interfaz de URLW (por un operador) con su base de datos.

Configuración del webhook en URLW:

curl -X POST https://urlw.fr/api/v1/webhooks \
-H "Authorization: Bearer SU_CLAVE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.su-saas.com/webhooks/urlw",
"events": ["link.clicked", "link.expired"],
"secret": "su_secreto_webhook_para_verificar_la_firma"
}'

Buenas prácticas de integración SaaS

• Utilice un dominio dedicado para sus compartidos: share.su-saas.com o go.su-saas.com refuerza su identidad de marca en cada compartido
• Cree los enlaces de forma asíncrona: nunca bloquee su UI esperando la respuesta de la API de URLW. Cree el enlace en segundo plano y devuélvalo al usuario en cuanto esté disponible
• Gestione las expiraciones en el lado del negocio: defina duraciones de validez coherentes con su lógica de aplicación (p. ej.: enlace de invitación válido 7 días)
• Almacene el ID de URLW en su base de datos: conserve el ID del enlace de URLW junto al objeto asociado para poder consultar las estadísticas o eliminar el enlace en caso necesario
• Pruebe la resiliencia: ¿qué sucede si la API de URLW no está disponible temporalmente? Su app debe hacer un fallback graceful a la URL completa

Consulte la documentación completa de la API de URLW y los planes tarifarios para SaaS. Cree su cuenta para empezar la integración.