Figma コネクタ

​

概要

​

前提条件

• ワークスペースで Custom Agents と Connectors が有効になっていること。
• インポートする Figma ファイルにアクセスできる Figma アカウントを持っていること。
• MoEngage のロールに、メールテンプレートとコンテンツブロックを作成する権限が含まれていること。Custom Agent は、エージェントを実行するユーザーの MoEngage 権限の範囲内で動作します。Custom Agent の基本: 権限とセキュリティを参照してください。

​

Figma を MoEngage に接続する

1. MoEngage ダッシュボードの左側のナビゲーションメニューで、Merlin AI > Connectors に移動します。
2. Figma を選択します。
   
3. Connection details ダイアログで、Figma のツールと利用規約を確認してから、Connect をクリックします。
   
4. 確認画面で Connect をクリックして、Figma の OAuth 2.0 フローを開始します。
   
5. Figma の同意画面で、Figma が MoEngage に付与するアカウントへのアクセス権を確認してから、Allow access をクリックします。別の Figma アカウントを承認するには、アクセスを許可する前に Switch accounts をクリックします。
   
6. Figma から Connectors ページに戻ります。Figma のカードは Connected セクションに移動し、緑色のチェックマークが表示されます。
   
7. 接続済みの Figma カードを選択して Connection details ダイアログを再度開き、個々の Figma ツールを有効化または無効化します。無効化したツールは、あなたが実行するすべてのエージェントで利用できなくなります。

​

ユースケース

• メール全体のデザインハンドオフ。 フレームは通常メール全体を表すため、フレーム全体はデフォルトでメールテンプレートになります。デザインチームから完成したレイアウトを受け取る場合に使用します。
• 再利用可能なモジュールのライブラリ。 フレーム内の名前付きセクションは、プロンプトでそのセクションを指定するとコンテンツブロックになります。ヘッダー、商品カード、プロモーションバナーなど、複数のキャンペーンで再利用するモジュールに使用します。コンテンツブロックには、セクションのテキストと画像がまとめて含まれます。
• 単独の画像アセット。 単独の画像は、その画像を含むコンテンツブロックになります。フレーム内の画像は、その画像またはそれを含むセクションを個別のインポートとして指定しない限り、エージェントがそのフレームから作成するメールテンプレートの一部として扱われます。

​

ツール

​

使用例

​

Figma ファイルを準備する

• Auto Layout を使用する。 エージェントは各フレームの Auto Layout 構造を読み取り、HTML 内でのセクションの配置方法を決定します。固定幅または塗りつぶし幅の Auto Layout を使用したフレームは、手動で配置したレイヤーで構成されたフレームよりも確実に変換されます。
• メールの幅を固定する。 メールデザインでは通常 600 px の幅が使用されます。エージェントが同じ幅の HTML コンテナを作成できるよう、フレームの幅を明示的に設定してください。
• フレームにわかりやすい名前を付ける。 エージェントを実行する際は各フレームを名前で指定し、MoEngage はフレーム名をメールテンプレート名として使用します。times-daily-briefing のように、一貫した命名規則に従ってください。
• セクションと画像レイヤーに名前を付ける。 Masthead and introduction や Top stories のようなわかりやすいレイヤー名は、エージェントが HTML を整理するのに役立ちます。MoEngage はレイヤー名をコンテンツブロック名として使用するため、個別にインポートする予定のセクションにはすべて名前を付けてください。
• 再利用可能なモジュールはそれぞれ独自のレイヤーにまとめる。 ヘッダー、商品カード、プロモーションバナーなど、複数のキャンペーンで再利用するモジュールは、1 つの名前付きグループまたはフレームにまとめてください。これにより、エージェントはテキストと画像を含むモジュール全体を 1 つのコンテンツブロックとしてインポートします。
• テキストはライブテキストレイヤーのままにする。 アウトライン化したテキストや画像に統合したテキストは、MoEngage では画像の一部として取り込まれるため、メールテンプレートでそのテキストを編集できません。

​

インポートエージェントを作成する

1. 左側のナビゲーションメニューで、Merlin AI > Custom Agents に移動します。
2. + New custom agent をクリックし、Create from scratch をクリックします。MoEngage が Agent Builder を開きます。
3. Merlin AI Assistant で、目的を平易な言葉で説明します。たとえば、Import email templates from Figma のように入力します。
4. Merlin AI Assistant からの 4 つの質問に回答します。各質問は、エージェントの動作の一部を決定します。

5. 下書きされたエージェントを確認します。Merlin AI Assistant が Instructions エディターに入力し、推奨ツールのセットを提示します。ワークフローに合わせて、指示と推奨ツールの両方を編集します。
6. Files セクションで、ブランドガイドラインや推奨する HTML 構造のサンプルなど、エージェントが毎回の実行で参照するファイルを添付します。各エージェントには最大 5 つのファイルを添付できます。

​

指示の例

## Role
You are an email template importer. You convert Figma frames into MoEngage email templates that are responsive, accessible, and email-client-safe.

## Objective
In each run, import the Figma frames or images that the user names, and create or update the matching MoEngage assets.

## Rules
- Always read the Auto Layout structure of the frame before you build the HTML.
- Always build the HTML with table-based, fluid-hybrid layout and inline styles.
- Always keep text as live, editable HTML text. Never convert text to images.
- Always add alt text to images and use bulletproof buttons for calls to action.
- Always use the Figma layer name as the template or content block name.
- Never modify the Figma file.
- Never import frames or images that the user did not name.

## Steps
1. Parse the request. Identify the Figma file, the names of the frames, sections, and images to import, and whether each one becomes an email template or a content block.
2. Locate each frame, section, or image in the Figma file.
3. For each frame, extract headings, text, buttons, and images. Export the images as URLs.
4. Build the email HTML.
5. If an email template with the same name exists, update that template. Otherwise, create a new template as a draft.
6. For each section or image that becomes a content block, create an HTML content block named after the layer. Keep the text of the section as live HTML text, and give every image alt text, width, and height.
7. Send a test email of each template to <test-email-address>.

## Output format
Return a table with the columns: Frame name, Mode, Action, Template or content block ID, Test sent. Below the table, list every frame or image you skipped and the reason you skipped it.

​

エージェントをテストして実行する

1. Agent Builder の右下にあるアクションバーで Test agent をクリックします。
2. Figma ファイルとインポートするアセットを指定するプロンプトを入力します。例:
   • Import the frame times-daily-briefing from the Times Figma file as an email template.
   • Import the section Top stories from times-daily-briefing as a content block.
   • Import the standalone images only.
3. テストパネルで、ツールの呼び出し、エージェントの推論、最終出力を確認します。エージェントが誤ったアセットをインポートしたり、誤った HTML 構造を作成したりした場合は、Instructions エディターに戻り、該当するステップをより具体的にします。
4. テスト実行で期待どおりの出力が得られたら、Make live をクリックします。チームメイトは All custom agents ページからエージェントを開くか、ハブのコンポーザーでエージェントを選択して実行できます。エージェントセッションを実行・管理するを参照してください。

​

結果を確認する

1. MoEngage で各メールテンプレートを開き、レイアウト、フォント、リンクを確認します。生成された HTML を調整するには、カスタム HTML エディターでコンテンツを作成するを参照してください。
2. 指定した受信トレイでテストメールを開き、オーディエンスが最もよく使用するメールクライアントでテンプレートがどのように表示されるかを確認します。メールキャンペーンをテストするを参照してください。
3. テンプレート内のプレースホルダーリンクをキャンペーンの URL に置き換え、キャンペーンに必要なパーソナライズと Jinja を追加します。メールコンテンツをパーソナライズするを参照してください。

​

関連ページ

• 外部アプリを Custom Agents に接続する
• Custom Agents: 概要
• Custom Agents を作成・管理する
• エージェントセッションを実行・管理する
• マルチエージェントワークフローを構築する
• コンテンツブロック
• テンプレート

​

よくある質問