Esta página es el contrato de referencia para los agentes que crean o editan emails de Emailify directamente a través de Figma MCP. Sigue los nombres y la estructura al pie de la letra para que Emailify reconozca el resultado y todos los componentes sigan vinculados a su componente principal original.

Los agentes pueden leer la versión en Markdown de este contrato, más compacta, sin cargar la interfaz de la documentación que la rodea.

Este flujo de trabajo directo en Figma forma parte de AI Designer (BETA). El contrato puede cambiar mientras se mejora la función, así que los agentes deben leer esta página antes de cada flujo de trabajo con MCP.

Instrucción para el agente

Pega esto en Codex, Claude Code u otro agente con acceso de escritura a Figma:

Read and follow the current Emailify Figma MCP contract at https://docs.hypermatic.com/emailify/design/figma-mcp.md before writing to Figma. Create or edit the email using only linked Emailify component instances. Preserve protected content, component links, and existing instance overrides. For a new email, create a vertical auto-layout frame on the page or inside Figma sections named exactly "✉️ Emailify MCP: [email name]" and include at least one linked Emailify section, wrapper, hero, or code-only custom-code instance. Ordinary images and frame layers may also be direct children and export as images. Never detach Emailify instances. Create a separate sibling frame in the same page or section named exactly "✉️ Emailify MCP Metadata: [same email name]" with TEXT layers named exactly "Subject Line" and "Preheader Text", containing only their corresponding values. Replace the bracketed placeholders with the actual email name. When finished, tell me to open or refresh Emailify.

Contrato del frame del email

Para cada email nuevo, crea un frame que cumpla todas las reglas siguientes:

Propiedad	Valor obligatorio
Nombre	✉️ Emailify MCP: [email name]
Posición	Directamente en la página de Figma o dentro de secciones de Figma; nunca dentro de un frame o grupo normal
Diseño	Auto Layout vertical
Hijos directos	Instancias vinculadas de componentes de Emailify, que se pueden combinar con capas visuales normales exportables
Raíces de Emailify permitidas	mj-section, mj-wrapper o mj-hero; instancias de código personalizado que solo contengan capas de texto Custom Code de Emailify
Contenido	Al menos una instancia válida de un componente de Emailify

Sustituye [email name] por el nombre real. El texto que va después de ✉️ Emailify MCP: pasa a ser el nombre del email en Emailify y no puede estar vacío.

No desvincules las instancias de Emailify ni recrees su contenido como capas sueltas. Haz los cambios de contenido de los componentes mediante modificaciones de instancia, para que las actualizaciones del sistema de diseño sigan llegando a todos los emails montados. Puedes colocar imágenes, frames, grupos y otras capas visuales normales directamente dentro del frame del email; Emailify los exporta como imágenes, no como contenido de email editable.

Asunto y preencabezado

Crea un frame hermano independiente, en la misma página o sección, para los metadatos del email. Su nombre de email debe coincidir exactamente con el del frame del email:

Propiedad	Valor obligatorio
Nombre del frame	✉️ Emailify MCP Metadata: [same email name]
Capa del asunto	Una capa TEXT llamada Subject Line que solo contenga el asunto
Capa del preencabezado	Una capa TEXT llamada Preheader Text que solo contenga el preencabezado

Mantén este frame de metadatos fuera del frame del email. No añadas etiquetas, prefijos, notas ni textos alternativos a los valores de texto.

Emailify importa cada campo por separado cuando el plugin se abre o se actualiza. Si los metadatos del lienzo no cambian, no sobrescriben las ediciones manuales que hayas hecho después en Emailify. Si el agente cambia un valor de los metadatos en el lienzo, Emailify importa ese campo modificado en la siguiente actualización.

Editar un email existente

Al actualizar un email que ya sigue este contrato:

• Modifica en su sitio las instancias vinculadas existentes siempre que puedas.
• Mantén vinculados los componentes de Emailify al añadirlos o reordenarlos. Pueden convivir con capas visuales normales, que se exportan como imágenes.
• Conserva el nombre del frame del email y la estructura de Auto Layout vertical.
• Conserva los vínculos de componentes y las modificaciones de instancia existentes, salvo que el brief indique cambiarlos expresamente.
• Nunca cambies, ocultes ni elimines una capa bloqueada o una capa cuyo nombre empiece por 🔒.
• Conserva los enlaces existentes, salvo que el brief indique una URL de sustitución exacta.
• Actualiza el frame de metadatos correspondiente cuando cambie el asunto o el preencabezado.

Adopción y validación

Cuando el agente termine, abre o actualiza Emailify. Emailify valida el frame candidato antes de aplicar sus metadatos mj-body habituales e importar los valores de asunto y preencabezado correspondientes.

Emailify rechaza el frame si está anidado dentro de un frame o grupo normal, está vacío, no está organizado en vertical, contiene una capa que no se puede exportar o no tiene ningún componente vinculado de Emailify de tipo sección, wrapper, hero o código personalizado solo con código. El rechazo es intencionado: los diseños normales de Figma nunca deben convertirse en emails de Emailify por accidente.

Solución de problemas

Problema	Qué comprobar
No se reconoce el email	Confirma el nombre exacto ✉️ Emailify MCP:, que esté en una página o sección, el Auto Layout vertical y que haya al menos una instancia vinculada de Emailify como hijo directo.
Falta el asunto o el preencabezado	Confirma que el frame de metadatos usa el mismo nombre de email y que las capas de texto se llaman exactamente Subject Line y Preheader Text.
Un componente ya no está vinculado	Sustituye las capas desvinculadas o reconstruidas por una instancia del componente principal original de Emailify.
Ha cambiado contenido legal o fijo	Bloquea la capa o añade 🔒 al principio de su nombre y, después, restaura el contenido aprobado en el componente principal.
Un valor manual de Emailify no ha cambiado	Edita el texto de metadatos correspondiente en el lienzo y vuelve a actualizar Emailify.

Si las herramientas de escritura de Figma no están disponibles, usa el flujo de trabajo de importación de JSON validado que se describe en Crear emails con AI Designer.

Los componentes de código personalizado pueden ir directamente entre las secciones del email, por ejemplo para abrir y cerrar lógica condicional de la plantilla. Tanto el componente principal como su instancia deben contener solo una o varias capas de texto Custom Code. Los componentes vacíos, los frames anidados, el texto normal y el contenido visual mixto no sirven. Mantén estos componentes vinculados a sus componentes principales.

Las secciones de Figma pueden contener tus frames de email, incluso con secciones anidadas. Siempre que puedas, mantén cada frame de metadatos junto a su email en la misma sección. Emailify da preferencia a los metadatos correspondientes que estén en el mismo contenedor, aunque se siguen admitiendo los que ya existan en otro lugar de la página. Los frames y grupos normales no son contenedores de email.