Fuentes de datos y etiquetas de combinación

Las etiquetas de combinación te permiten personalizar cada correo con datos reales. Escribe {{field}} en cualquier lugar de un bloque de texto — Hola {{first_name}}, tu {{plan}} se renueva pronto — y cada destinatario ve sus propios valores. Un proyecto puede conectar varias fuentes de datos a la vez: cada una recibe un alias corto, y los campos de una fuente que no es la audiencia se escriben como {{alias.field}} (por ejemplo {{products.name}}).

Tipos de fuente de datos

Las fuentes de datos se gestionan desde la sección Fuentes de datos de tu panel (las listas de contactos viven bajo Contactos). Hay dos tipos:

Tablas alojadas

Una tabla almacenada en MailInApp. Define columnas, agrega filas en el panel, y cada columna se convierte en un campo de combinación. Ideal cuando tus datos hoy viven en una hoja de cálculo. Las listas de contactos son tablas alojadas con una columna email garantizada.

Conexiones API

Apunta MailInApp a tu propio endpoint HTTP que devuelve JSON. Las filas se obtienen del lado del servidor — desde nuestros servidores, nunca desde la bandeja de entrada del destinatario ni el navegador de tus visitantes.

Tres formas de autenticar la conexión, elegidas desde el menú desplegable Autenticación cuando la configuras:

• Encabezados estáticos — agrega encabezados de solicitud (por ejemplo un encabezado Authorization) con un valor fijo. La opción más simple, y la única que tenía sentido antes de que un token pudiera expirar.
• OAuth2 Client Credentials — una URL de token más un ID y secreto de cliente. MailInApp los intercambia por un token de acceso del lado del servidor, lo almacena en caché, y lo renueva automáticamente antes de que expire — el patrón común para la mayoría de las integraciones empresariales de clave API y secreto.
• OAuth2 JWT Bearer — una URL de token, emisor, sujeto, audiencia, y una clave privada RSA (PEM). MailInApp firma una afirmación JWT nueva y la intercambia por un token de acceso, sin inicio de sesión interactivo ni token de actualización que vigilar — así es como se autentican las integraciones servidor-a-servidor de Salesforce (mira la guía de integración de Salesforce), y funciona de la misma forma para una cuenta de servicio de Google o cualquier otro IdP compatible con este flujo.

Sea cual sea el modo que elijas, el token portador resultante se inyecta automáticamente como un encabezado Authorization — cualquier encabezado adicional que agregues se sigue enviando junto a él, combinado (un encabezado literalmente llamado Authorization ahí se ignora, ya que el token generado siempre gana). Todos los campos de credenciales — valores de encabezados, secreto de cliente, clave privada — siguen la misma regla:

• se almacenan solo del lado del servidor,
• nunca se envían al navegador,
• se enmascaran en cada respuesta de la API después de guardarlos.

Editar una conexión cuyo secreto se muestra enmascarado y hacer clic en Probar esta configuración necesita que se vuelva a introducir el valor real primero; Probar la conexión guardada en cambio ejecuta la comprobación contra la credencial exactamente como está almacenada, sin enviarla nunca de vuelta a tu navegador.

Conectar fuentes: el panel de Datos

El panel de Datos del estudio es donde un proyecto declara qué fuentes usa. + Agregar fuente de datos… conecta una (hasta 10 por proyecto); cada conexión tiene tres partes:

• Alias — el nombre corto que usan sus etiquetas de combinación: letras minúsculas, dígitos y guiones bajos, empezando con una letra (por ejemplo, contacts, products, open_invoices). Renombrar un alias actualiza automáticamente cualquier bloque de repetición vinculado a él.
• Fuente — la tabla alojada, lista de contactos o conexión API detrás de él.
• Rol — cómo la usa el correo:
  • Audiencia — la lista de contactos a la que se envía el correo. Como máximo una por proyecto, y debe ser una lista de contactos. Sus campos son las etiquetas simples — {{first_name}}, {{email}} — resueltas por destinatario desde su propia fila en el momento del envío. La audiencia también impulsa el selector "Previsualizar como" y la atribución de respuestas por destinatario.
  • Campos de combinación — campos legibles bajo el alias: {{alias.field}}, resueltos desde la primera fila de la fuente cuando se renderiza el correo. Úsalo para contenido compartido — el producto destacado, las estadísticas de esta semana — en lugar de datos por destinatario.
  • Filas de repetición — filas que alimentan bloques de repetición vinculados al alias. No aporta campos de combinación fuera de la repetición. El mismo rol collection también alimenta los bloques de gráfico de indicador clave/barras/líneas/circular — mira Vincular gráficos a datos reales.

Cada fuente conectada lista sus campos como chips clicables — haz clic en uno para copiar la etiqueta de combinación exacta, pégala en cualquier propiedad de texto. Los editores de condiciones de visibilidad agrupan su menú desplegable de campos de la misma forma: campos de destinatario (audiencia) más un grupo por fuente de combinación.

Etiquetas integradas

Un puñado de etiquetas las proporciona la plataforma misma en lugar de una fuente de datos — el panel Variables del panel izquierdo del estudio las lista junto a cualquier variable que definas; haz clic en una para copiar su etiqueta.

• {{recipient_email}} — la dirección a la que se envía el correo.
• {{today}} / {{now}} — la fecha (u hora y fecha) en que se abre el correo.
• {{unsubscribe_url}} — un enlace de cancelación de suscripción de un clic por destinatario. El preajuste de Pie de página ya lo incluye — mira Envío a tus contactos.

Un código de descuento de tienda de un solo uso por destinatario no es una etiqueta de combinación — coloca el bloque Descuento de comercio electrónico (solo para audiencias conectadas a Shopify/WooCommerce) en el correo en su lugar, y genera y muestra su propio código automáticamente. Mira Oferta de descuento.

Las etiquetas integradas solo se resuelven en envíos reales (manual, programado, o un envío de prueba estilo "Backfill") — la vista previa del estudio y el lienzo las muestran vacías o como marcador de posición, igual que cualquier campo sin valor de muestra.

Contenido repetido

El bloque de repetición renderiza sus hijos una vez por cada fila de la fuente a la que lo vincules — una cuadrícula de productos, un resumen de artículos, una lista de facturas pendientes. Elige la fuente por alias en el Inspector; dentro de la repetición, las etiquetas se resuelven contra la propia fila de cada repetición.

Previsualizar con datos reales

El selector de datos de vista previa del estudio renderiza el lienzo con cualquier fila de la lista de audiencia, así puedes comprobar que {{first_name}} realmente dice Amina y no {{first_name}} antes de enviar. Los campos de otras fuentes también pueden recibir valores de vista previa.

Bueno saberlo

• Los campos que faltan para un destinatario se renderizan como cadenas vacías — diseña de forma que un valor en blanco se lea de forma natural.
• Las páginas alojadas (vista en vivo, formularios alojados) resuelven las etiquetas de combinación por destinatario en el momento de renderizar, así que la personalización sobrevive incluso cuando un destinatario sale de la bandeja de entrada.
• Los proyectos construidos antes de la compatibilidad con varias fuentes siguen funcionando sin cambios: su única fuente conectada aparece en el panel de Datos automáticamente, y las etiquetas simples {{field}} siempre se resuelven contra la audiencia.