Panel de Shortcodes

¿Para qué sirve esto?

El Panel de Shortcodes aparece debajo del editor de Cuerpo de Email en el popup de Acción de Email. Proporciona botones de copiado instantáneo para placeholders dinámicos (shortcodes) que inyectan datos específicos del evento y del suscriptor en tus emails. Cuando el email se envía, cada shortcode se sustituye por datos reales — el enlace del evento, nombre del evento, hora de inicio, la identidad del suscriptor o botones de calendario. Esto te permite escribir una plantilla que se personaliza automáticamente para cada destinatario.

Dónde Encontrarlo

1. Abre el popup de Acción de Email (crea nueva o edita existente).
2. Ve al campo Cuerpo del email (editor de texto enriquecido).
3. Debajo de la barra de herramientas del editor verás una sección titulada "Panel de shortcodes" con botones de iconos de colores.

Shortcodes Disponibles

Cómo Usar un Shortcode

1. Coloca el cursor en el editor de Cuerpo de Email donde quieras el contenido dinámico.
2. Haz clic en el botón del shortcode deseado en el panel.
3. El texto del shortcode (p. ej., {eventLink}) se copia al portapapeles.
4. Un toast confirma: "Copiado con éxito: [nombre del shortcode]".
5. Pega (Ctrl/Cmd+V) en la posición del cursor en el editor.
6. El shortcode aparece en tu texto. Dale formato como texto normal (negrita, color, enlace, etc.).

Consejo: Puedes pegar el mismo shortcode varias veces — cada clic lo copia fresco al portapapeles.

Detalles y Comportamiento de Cada Shortcode

{eventLink}

• Se sustituye por: La URL pública completa al evento/página de inscripción.
• Uso típico: Envolver en enlace: <a href="{eventLink}">Regístrate Ya</a> o pegar como URL plana.
• Funciona para: Todos los tipos de destinatario (Suscriptor, Propietario, Email Personalizado).

{eventTime}

• Se sustituye por: Fecha/hora de inicio del evento formateada (p. ej., "15 de junio de 2024 a las 10:00").
• Zona horaria: Usa la zona horaria configurada del evento.
• Funciona para: Todos los tipos de destinatario.

{eventName}

• Se sustituye por: El Nombre del Evento exacto tal como se introdujo en el Constructor de Eventos.
• Funciona para: Todos los tipos de destinatario.

{userIdentity}

• Se sustituye por: La identidad visible del suscriptor — típicamente su nombre si lo dio, si no su email.
• Visibilidad: Oculto del panel cuando Destinatario = Propietario. Solo se muestra para destinatarios Suscriptor y Email Personalizado.
• Razón: Los emails al Propietario no tienen contexto de suscriptor específico — el organizador ya sabe quién es.

{addToCalendar}

• Se sustituye por: Dos botones con estilo — Google Calendar y Outlook — cada uno con enlace .ics pre-relleno con título, fecha/hora y descripción del evento.
• Uso típico: Pegar en su propia línea: "Reserva la fecha: {addToCalendar}"
• Funciona para: Todos los tipos de destinatario.

Reglas Importantes y Consejos

Nota: Los shortcodes distingue mayúsculas/minúsculas y deben incluir las llaves. Escribe o pega exactamente como se muestra: {eventLink}, {eventTime}, {eventName}, {userIdentity}, {addToCalendar}.

Flujo Copiar-Pegar: Los botones copian al portapapeles — NO auto-insertan en el editor. Debes pegar (Ctrl/Cmd+V) en la posición del cursor. Esto te da control total sobre colocación y formato.

Visibilidad Según Destinatario: El botón Identidad de Usuario ({userIdentity}) desaparece del panel cuando cambias Destinatario a Propietario en el mismo popup. Vuelve a Suscriptor o Email Personalizado para verlo de nuevo.

Conteo de Caracteres: Los shortcodes cuentan para el límite de 300 caracteres del Cuerpo por su longitud en texto plano (p. ej., {eventLink} = 11 caracteres). El email renderizado final será más largo tras la sustitución — eso está bien.

Vista Previa: Usa el botón Vista Previa de Email (botón verde "preview email" en el popup) para ver cómo queda el email con shortcodes resueltos para un destinatario de prueba.

Plantillas: Los shortcodes funcionan en cualquier plantilla. La plantilla da el layout; los shortcodes dan los datos dinámicos.

Preguntas Frecuentes y Solución de Problemas

Hice clic en un botón pero no apareció nada en el editor. El botón copia al portapapeles. Debes pegar (Ctrl/Cmd+V) en la posición del cursor en el editor. Revisa tu portapapeles — el texto del shortcode debería estar ahí.

Falta el botón Identidad de Usuario. Probablemente tengas Destinatario = Propietario seleccionado. Cambia a Suscriptor o Email Personalizado — el botón reaparecerá.

¿Puedo escribir shortcodes a mano en vez de usar los botones? Sí. Escríbelos exactamente con llaves: {eventLink}, {eventTime}, etc. Los botones son solo comodidad para evitar errores.

¿Qué pasa si el evento no tiene enlace/nombre/hora configurados? El sistema solo permite guardar una acción de email tras seleccionar Plantilla de Email. El contexto de evento de la plantilla provee los datos. Si faltan datos del evento, el shortcode resuelve a cadena vacía o placeholder — asegúrate de que tu evento esté completamente configurado.

¿Funcionan los shortcodes en la línea de Asunto? No. Los shortcodes solo funcionan en el editor de Cuerpo de Email. El campo Asunto es solo texto plano.

¿Puedo dar estilo a los botones de calendario? El shortcode {addToCalendar} renderiza botones Google/Outlook pre-estilizados. No puedes personalizar su apariencia desde el editor — usan estilo por defecto del sistema para máxima compatibilidad.

¿Qué pasa si envío a un destinatario Email Personalizado?

• {eventLink}, {eventTime}, {eventName}, {addToCalendar} → se resuelven normalmente con datos del evento.
• {userIdentity} → se resuelve a la dirección de email personalizada que introdujiste (pues no hay perfil de suscriptor).