---
url: "/pt/emailify/design/figma-mcp.md"
description: "O contrato exato de frames, componentes e metadados que os agentes devem seguir ao criar ou editar e-mails do Emailify direto no Figma."
---

# Usar o Emailify com o Figma MCP

> O contrato exato de frames, componentes e metadados que os agentes devem seguir ao criar ou editar e-mails do Emailify direto no Figma.

Esta página é o contrato oficial para agentes que criam ou editam e-mails do Emailify direto pelo Figma MCP. Siga os nomes e a estrutura exatamente como descritos para que o Emailify reconheça o resultado e cada componente continue vinculado ao componente principal original.

Os agentes podem ler a [versão compacta em Markdown deste contrato](/pt/emailify/design/figma-mcp.md) sem carregar a interface da documentação ao redor.

> **Note:** Este fluxo de trabalho direto no Figma faz parte do AI Designer (BETA). O contrato pode mudar enquanto o recurso é aprimorado, então os agentes devem ler esta página antes de cada fluxo de trabalho com MCP.

## Instrução para o agente {#agent-instruction}

Cole isto no Codex, no Claude Code ou em outro agente com acesso de escrita ao Figma:

```text
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 do frame do e-mail {#email-frame-contract}

Para cada novo e-mail, crie um frame que cumpra todas as regras abaixo:

| Propriedade | Valor obrigatório |
| --- | --- |
| Nome | `✉️ Emailify MCP: [email name]` |
| Posição | Direto na página do Figma ou dentro de seções do Figma; nunca dentro de um frame ou grupo comum |
| Layout | Auto Layout vertical |
| Filhos diretos | Instâncias vinculadas de componentes do Emailify, que podem ser combinadas com camadas visuais comuns exportáveis |
| Raízes do Emailify permitidas | `mj-section`, `mj-wrapper` ou `mj-hero`; instâncias de código personalizado que contenham apenas camadas de texto Custom Code do Emailify |
| Conteúdo | Pelo menos uma instância válida de componente do Emailify |

Substitua `[email name]` pelo nome real. O texto depois de `✉️ Emailify MCP:` vira o nome do e-mail no Emailify e não pode ficar vazio.

Não desvincule (detach) as instâncias do Emailify nem recrie o conteúdo delas como camadas soltas. Faça as mudanças de conteúdo dos componentes por meio de substituições (overrides) nas instâncias, para que as atualizações do design system continuem chegando a todos os e-mails montados. Imagens, frames, grupos e outras camadas visuais comuns podem ficar direto dentro do frame do e-mail; o Emailify os exporta como imagens, e não como conteúdo de e-mail editável.

## Linha de assunto e pré-cabeçalho {#subject-line-and-preheader}

Crie um frame irmão separado, na mesma página ou seção, para os metadados do e-mail. O nome do e-mail nele deve ser exatamente igual ao do frame do e-mail:

| Propriedade | Valor obrigatório |
| --- | --- |
| Nome do frame | `✉️ Emailify MCP Metadata: [same email name]` |
| Camada do assunto | Uma camada TEXT chamada `Subject Line` contendo apenas o assunto |
| Camada do pré-cabeçalho | Uma camada TEXT chamada `Preheader Text` contendo apenas o pré-cabeçalho |

Mantenha esse frame de metadados fora do frame do e-mail. Não adicione rótulos, prefixos, observações nem textos alternativos aos valores.

O Emailify importa cada campo de forma independente quando o plugin é aberto ou atualizado. Metadados que não mudaram no canvas não sobrescrevem edições manuais feitas depois no Emailify. Se o agente alterar um valor de metadados no canvas, o Emailify importa o campo alterado na próxima atualização.

## Editar um e-mail existente {#editing-an-existing-email}

Ao atualizar um e-mail que já segue este contrato:

- Sempre que possível, modifique as instâncias vinculadas existentes no próprio lugar.
- Mantenha os componentes do Emailify vinculados ao adicioná-los ou reordená-los. Camadas visuais comuns podem conviver com eles e são exportadas como imagens.
- Preserve o nome do frame do e-mail e a estrutura de Auto Layout vertical.
- Preserve os vínculos de componentes e as substituições das instâncias, a menos que o briefing peça explicitamente para alterá-los.
- Nunca altere, oculte ou remova uma camada bloqueada ou uma camada cujo nome comece com `🔒`.
- Preserve os links existentes, a menos que o briefing forneça uma URL exata para substituí-los.
- Atualize o frame de metadados correspondente quando a linha de assunto ou o pré-cabeçalho mudar.

## Adoção e validação {#adoption-and-validation}

Quando o agente terminar, abra ou atualize o Emailify. O Emailify valida o frame candidato antes de aplicar os metadados `mj-body` normais e importar os valores de assunto e pré-cabeçalho correspondentes.

O Emailify rejeita o frame se ele estiver dentro de um frame ou grupo comum, estiver vazio, não estiver organizado na vertical, tiver uma camada que não pode ser exportada ou não tiver nenhum componente vinculado do Emailify do tipo seção, wrapper, hero ou código personalizado só com código. A rejeição é intencional: layouts comuns do Figma nunca devem ser convertidos em e-mails do Emailify por acidente.

## Solução de problemas {#troubleshooting}

| Problema | O que verificar |
| --- | --- |
| O e-mail não é reconhecido | Confirme o nome exato `✉️ Emailify MCP:`, a posição na página ou seção, o Auto Layout vertical e pelo menos uma instância vinculada do Emailify como filho direto. |
| Falta o assunto ou o pré-cabeçalho | Confirme que o frame de metadados usa o mesmo nome de e-mail e que as camadas de texto se chamam exatamente `Subject Line` e `Preheader Text`. |
| Um componente não está mais vinculado | Substitua as camadas desvinculadas ou recriadas por uma instância do componente principal original do Emailify. |
| Um conteúdo jurídico ou fixo mudou | Bloqueie a camada ou comece o nome dela com `🔒` e restaure o conteúdo aprovado no componente principal. |
| Um valor manual do Emailify não mudou | Edite o texto de metadados correspondente no canvas e atualize o Emailify de novo. |

Quando as ferramentas de escrita do Figma não estiverem disponíveis, use o fluxo de trabalho de importação de JSON validado descrito em [Criar e-mails com o AI Designer](/pt/emailify/design/ai-designer).

Componentes de código personalizado podem ficar direto entre as seções do e-mail, por exemplo para abrir e fechar uma lógica condicional do template. Tanto o componente principal quanto a instância devem conter apenas uma ou mais camadas de texto Custom Code. Componentes vazios, frames aninhados, texto comum e conteúdo visual misto não se qualificam. Mantenha esses componentes vinculados aos componentes principais.

As seções do Figma podem conter seus frames de e-mail, inclusive seções aninhadas. Sempre que possível, mantenha cada frame de metadados junto do seu e-mail, na mesma seção. O Emailify dá preferência aos metadados correspondentes no mesmo contêiner, mas metadados correspondentes que já estejam em outro lugar da página continuam sendo aceitos. Frames e grupos comuns não são contêineres de e-mail.