Portal del cliente — gestionar cita sin login

Portal del cliente — gestionar cita sin login

Cada vez que el agente agenda una cita, el sistema genera un enlace único y firmado para que el cliente pueda gestionar esa cita sin necesidad de crear una cuenta ni iniciar sesión. Este enlace tiene la forma:

https://agentes-saas-ten.vercel.app/c/[token]

El token es un JWT firmado con la clave secreta del servidor. Contiene el ID de la cita y el ID del tenant, con una firma que impide su manipulación.

Qué puede hacer el cliente en su portal

[Screenshot: portal del cliente /c/token]

• Ver los detalles de la cita — fecha, hora, servicio, dirección o enlace de videollamada.
• Reprogramar — seleccionar un nuevo horario disponible (respeta las reglas de anticipación mínima).
• Cancelar — cancelar la cita con una nota opcional.
• Subir comprobante de pago — para citas con pago por transferencia bancaria.
• Ver historial — si el cliente tuvo más de una cita con el mismo tenant, puede ver el historial desde su token actual.

Cómo llega el enlace al cliente

El agente envía el enlace automáticamente al confirmar la cita, usando la herramienta enviar_confirmacion. El enlace va incluido en:

• El cuerpo del correo de confirmación.
• El mensaje de WhatsApp o Telegram (como botón o enlace de texto).
• El SMS de confirmación.

Vigencia del token

El token no tiene fecha de expiración fija — es válido mientras la cita exista en el sistema. Sin embargo:

• Si la cita es cancelada desde el dashboard, el enlace redirige a una pantalla de "cita no encontrada".
• Si el tenant elimina su cuenta, los tokens de ese tenant dejan de funcionar.

Seguridad del token

El token es un JWT firmado con NEXTAUTH_SECRET (o la variable equivalente configurada en el servidor). Aunque el token no está cifrado (es decodificable en Base64), no puede ser falsificado sin la clave privada del servidor.

Para proteger el portal de accesos no autorizados:

• El token está ligado al appointment_id y al tenant_id — no se puede usar un token de una cita para ver otra.
• Las acciones (reprogramar, cancelar) se registran en el audit log del dashboard.

Reenviar el enlace al cliente

Si el cliente perdió el enlace original:

1. Ve a /dashboard/appointments.

2. Abre la cita del cliente.

3. Haz clic en Reenviar enlace de cliente.

4. Selecciona el canal (email, WhatsApp, Telegram, SMS) y haz clic en Enviar.

El nuevo mensaje enviará el mismo token — no se genera uno nuevo.

Desactivar el portal de cliente

Si tu flujo de negocio no necesita que el cliente gestione su cita directamente, puedes desactivar el portal en /dashboard/settings → Negocio → desactiva la opción Portal de cliente activo. En ese caso, el enlace /c/[token] mostrará un mensaje indicando que el cliente debe contactar al negocio directamente.