EmarsysのAPIキーを設定する
EmailifyのFigmaデザインからメールキャンペーンをアップロードするには、EmarsysでWSSEキーを作成して権限を設定し、生成されたAPIキーの認証情報を使ってEmailifyをEmarsysアカウントに接続する必要があります。
EmarsysのWSSEキーを作成する
まず、EmarsysでWSSEキーを作成します(この操作にはアカウントオーナーの権限が必要です)。Management -> Security Settings -> API Credentialsに移動して、WSSEキーを作成してください。
APIキーの権限を設定する
キーを作成し、ユーザー名とキーを安全な場所に保存したら(次の手順でEmailifyのFigmaプラグインに貼り付けます)、API連携が想定どおりに動作するよう、以下のAPIエンドポイントの権限も有効にする必要があります。
campaign.createcampaign.updatecontactlist.list
EmailifyからHTMLをアップロードする
Emailifyのエクスポートパネルで、ドロップダウンリストからEmarsysオプションを選択し、有効なEmarsysのAPI認証情報(前の手順で作成したもの)を貼り付けます。プラグインでEmarsysの認証が完了したら、後でキャンペーンを送信するContact Listと、キャンペーンの送信元となるFrom NameとFrom Emailのアドレスを選択します。
準備ができたらUpload To Emarsysボタンをクリックします。Figmaで選択したメールのHTMLエクスポートが始まり、Emarsysのキャンペーンに自動でアップロードされます。
EmailifyからアップロードしたEmarsysテンプレートを更新する
アップロードのたびに新しいテンプレートを作成するのではなく、Emarsysのテンプレートを自動で更新したい場合は、プラグインのエクスポート設定で(Emarsysオプションを選択した状態で)Enable Updatable Templatesトグルを必要に応じて有効にします。
これにより、アップロードしたFigmaフレームのレイヤー名にemarsysTemplateIdの値が自動で追加され、次回プラグインからエクスポートする際に同じフレームをAPI経由でEmarsysに再アップロードすると、そのIDが再利用されます。
この機能を使うには、EmarsysのWSSEキーでcampaign.update権限を有効にする必要があります。
最初のテンプレートをアップロードする前に 、 Enable Updatable Templatesトグルも有効にしておく必要があります。これにより、Emarsysにアップロードした元のテンプレートのEmarsys Template IDがFigmaのフレーム名に追加されます。以降の再アップロードではこのIDが使われ、(毎回新しいテンプレートを作成する代わりに)Emarsysアカウント内の同じテンプレートが更新されます。ただし、* Enable Updatable Templates*トグルを有効にしたままにしておく必要があります。