Figma 是一个用于创建电子邮件横幅、社交媒体图形和其他营销视觉效果的设计平台。通过 Figma 集成，您可以将设计自动同步到 Omnisend 图像库，作为 PNG 文件。
本文解释了如何连接 Figma，配置自动同步，在电子邮件活动和自动化中使用您的设计，以及排除常见连接问题。
开始之前
确保：
您有一个活跃的 Figma 账户。
您授权的 Figma 账户可以打开您想要同步的文件。
如果您复制一个 Figma 社区文件，请在登录您将用于授权连接的账户时进行复制。 由其他账户复制的文件可能无法通过 Figma API 访问。
您在 Figma 文件中创建了一个页面，也称为画布。 您可以将其命名为 Omnisend Sync 或使用其他名称。
您想要同步的设计直接放置在此页面上，作为顶级框架。
您的 Figma 计划和座位类型在设置期间可用，因为它们影响可用的同步频率。
设计将仅作为 PNG 文件同步。
每个连接可以同步一个文件和一个页面。
每个帧必须小于 5 MB。超过此大小的帧将无法同步。
好处
通过 Figma 集成，您可以：
自动同步新的和更新的 Figma 设计。
在 Omnisend 图像库中使用同步的设计。
将同步的设计添加到电子邮件活动和自动化工作流消息中。
根据您的 Figma 计划和座位类型，从每 15 分钟到每月一次选择同步频率。
设置 Figma 集成
步骤 1：在 Figma 中准备同步页面
打开您想要同步的 Figma 文件。
在文件的顶层添加一个新页面。
输入您希望在 Omnisend 设置期间使用的页面名称。 默认名称是 Omnisend Sync。
将您想要同步的设计移动到此页面。
确保每个设计都是直接放置在页面上的顶级框架。
在此页面添加或更新的任何框架都可以导入到您的 Omnisend 图片库 中。
重要： 嵌套在组、组件或其他帧中的帧将无法同步。
请记住以下几点：
在将 Figma 连接到 Omnisend 之前，页面必须存在。
页面名称匹配不区分大小写。 例如，
Omnisend Sync和OMNISEND SYNC被视为相同的名称。如果在连接 Figma 后重命名页面，请在您的 Omnisend 连接中更新 同步页面名称。
当前更新页面名称需要您在 Omnisend 中重新安装 Figma 应用。
步骤 2：连接您的
账户
在 Omnisend 中，转到 应用。
搜索 Figma。
点击 立即连接.
完成连接表单.
输入以下信息:
API 基础 URL： 保持不变
https://api.figma.com unchanged. 使用https://api.figma-gov.com only if you use a Figma for Government tenant.Figma 文件 URL： 输入您想要同步的 Figma 文件的完整 URL。例如：
https://www.figma.com/design//.也支持裸文件密钥.同步页面名称： 输入您在步骤 1 中准备的页面名称。该页面必须已经存在于所选文件中.
同步频率： 选择 Omnisend 应该多频繁检查新设计或更新设计.
重要： 使用 Figma 文件 URL，而不是文件夹或项目 URL。您授权的 Figma 账户必须能够打开所选文件.
5. 点击 连接.
6. 当被重定向到 Figma 时，使用可以访问该文件的账户登录.
7. 点击 允许 授权连接。
8. 授权后，您将返回 Omnisend.
步骤 3：配置同步设置
连接 Figma 后：
转到 应用 → 连接的应用。
选择 Figma。
打开设置。
您可以配置以下选项：
自动同步：开启新更新帧的自动同步。
立即同步：立即检查新框架或更新的框架。
注意： Figma 的速率限制可能会阻止新设计的导入，如果您在选定的同步间隔未结束之前运行 立即同步，在选定的同步间隔时间过去之前。Omnisend 可以检查连接，但在所需时间过去之前不会导入新设计。
步骤 4：在电子邮件中使用您的设计
打开一个电子邮件活动或自动化工作流。
打开Omnisend邮件构建器（Email Builder）。
将 图片 项拖入您的电子邮件。
点击 选择文件。
选择您同步的 Figma 设计之一。
您的 Figma 设计已作为 PNG 文件添加到 Omnisend 图片库中。
💡 了解更多关于 Omnisend 图像库 的信息。
同步如何工作
Figma 操作 | Omnisend 结果 |
向同步页面添加新框架 | 帧将在下一个合格检查时同步。 |
更新现有帧 | 更新的帧作为新图像同步。 |
从同步页面中移除帧 | 现有图像保留在 Omnisend 图像库中。 |
保持帧不变 | 该帧被跳过，不会再次上传。 |
帧超过 5 MB | 该帧被跳过，不会同步到图像库。 |
故障排除
连接失败或返回到设置表单
检查以下内容：
授权的 Figma 账户可以打开所选文件。
文件 URL 指向一个 Figma 文件，而不是文件夹或项目。
同步页面存在于所选文件中。
同步页面名称与在 Omnisend 中输入的名称匹配。
API 基础 URL 对于您的 Figma 租户是正确的。
如果无法访问文件，Figma 可能会返回 403 权限被拒绝 错误。 此错误可能意味着授权帐户没有访问该文件的权限，或者文件 URL 不正确。
如果页面名称无效或 URL 不指向支持的文件，Omnisend 将您返回到设置表单。 您之前的输入仍然可用，Omnisend 在适用时会显示可用页面。 您可以更正详细信息并尝试再次操作，而无需重新授权 Figma。
我的设计未出现在图像库中
检查以下内容：
设计是顶级框架。
框架直接放置在所选页面上。
页面名称与您的 Figma 连接中的名称匹配。
文件 URL 指向正确的文件。
每个框架小于 5 MB。大于 5 MB 的帧将无法同步。
您正在通过选择 图像 项并点击 选择文件 来检查电子邮件构建器。
您已进入 应用 → 已连接的应用 → Figma → 设置 并点击了 立即同步。
导入可能需要一分钟或更长时间，具体取决于正在同步的帧数。
如果在选定的同步间隔未结束前点击 立即同步，Omnisend 可能会检查连接而不导入新设计。
要确认帧是否因过大而失败，请检查 Omnisend 中的 API 访问日志。
同步失败，出现速率限制错误
Figma 限制通过其 API 访问文件的频率。 限制取决于您的 Figma 计划和座位类型。
如果同步反复失败或您收到 429 速率限制错误：
选择更长的同步间隔。
避免重复点击 立即同步。
在再次尝试之前，请等待速率限制期结束。
常见问题
支持哪些图像格式？
Figma 设计仅以 PNG 文件格式同步。
我可以同步整个 Figma 电子邮件模板吗？
集成将 Figma 设计同步为 PNG 图像。 它不会同步可编辑的电子邮件布局或模板。
连接后我可以重命名同步页面吗？
是的。 在 Figma 中重命名页面后，请在 Omnisend 中更新 同步页面名称。目前，更新页面名称需要您在 Omnisend 中重新安装 Figma 应用。
我可以将多个 Omnisend 品牌连接到同一个 Figma 账户吗？
是的。 您可以将同一个 Figma 账户连接到不同的 Omnisend 品牌。 每个连接可以指向不同的 Figma 文件和同步页面。
我可以将多个 Figma 文件或页面同步到一个 Omnisend 品牌吗？
否 每个连接支持一个 Figma 文件和一个页面。
如果我断开与 Figma 的连接会发生什么？
如果您从 Omnisend 中断开 Figma，现有的图像将保留在您的 Omnisend 图像库 中。 新的或更新的 Figma 设计在您重新连接到 Figma 之前将无法同步。
我应该多久同步一次？
您的 Figma 计划和座位类型决定了适合的同步频率：
具有开发或完整席位的组织或企业计划： 每 15-30 分钟可以很好地工作。
具有开发或完整席位的专业计划： 每小时是安全的默认值。
初学者计划，或任何计划上的查看者或协作席位： 推荐每周或每月，因为这些配置的 API 限制较低。
如果您不确定，请从较长的间隔开始，只有在同步可靠工作时再减少。
需要帮助吗？ 通过应用内聊天或电子邮件联系 Omnisend 支持团队。 [email protected]