この記事を使ってFinの4つの事前構築済みShopifyデータコネクターテンプレートを設定し、サポート会話中にチームメイトが介入せずに返金見積もり、ストアクレジット発行、ギフトカードの確認や無効化を行えるようにします。
Data connectorsは、会話中にFinが外部API(application programming interfaces)を呼び出してライブデータを取得または更新できる機能です。Shopifyテンプレートは、Shopify Admin REST APIを代理で呼び出す事前設定済みコネクターです。API scopesは、コネクターがそのデータを読み書きする前にShopifyストアが付与する必要がある特定の権限です。
各Shopify補償テンプレートの機能
Fin向けの4つのShopifyデータコネクターテンプレートは以下の通りで、それぞれ補償ワークフローの異なる部分をカバーしています。
Calculate Shopify Refund
返金見積もりを行います。返金可能な送料、税金、支払い取引ごとの最大返金額を含みますが、実際に資金は動きません。これはドライランの操作で、返金が発生する前に見積もりを計算します。Finが処理前に顧客と金額を確認したい場合は、Create Shopify Refundアクションと組み合わせて使用します。Shopifyへの書き込みは行いません。
Issue Shopify Gift Card
Shopifyギフトカードとしてストアクレジットを発行します。Shopifyがコードを直接顧客にメール送信し、引き換えコードはFinに返されず会話内で表示されません。FinはカードのID、残高、通貨、有効期限、最後の4文字のみを確認できます。このテンプレートはShopifyに書き込みます。
Get Shopify Gift Card Balance
顧客のShopifyギフトカードの残高、初期値、有効期限を確認します。顧客が残高を尋ねたりカードが使用済みかどうかを確認したい時に使用します。Shopifyへの書き込みは行いません。
Disable Shopify Gift Card
誤って発行されたギフトカード(例えば、誤った金額、誤った顧客への送付、誤発行)を無効化します。カードは即座に使用不可になります。
重要:この操作は元に戻せません。Shopifyには無効化されたギフトカードを再有効化する方法がありません。誤ってカードを無効化した場合は、Issue Shopify Gift Cardテンプレートを使って代替カードを発行してください。
テンプレートの追加方法
Shopifyセクションで追加したいテンプレートを見つけます。
Shopifyストア接続を接続(または再利用)します。アクションのURLはワークスペースが接続しているストアを自動的にターゲットにします。アクションごとのdomain設定は不要です。
事前入力されたパラメーター、説明、Finの使用ガイダンスを確認します。Set liveをクリックしてテンプレートを有効化します。Settings > Integrations > Data connectorsでコネクターが有効としてリストされているのが確認できます。
注意:各テンプレートはワークスペースごとに有効化されます。有効化後は実際の会話でコネクターをテストしてください。Finのプレビューモードはライブのデータコネクター呼び出しを行いません。
Shopifyに必要な権限
ギフトカードテンプレートを追加する前に、Shopifyストアはread_gift_cardsとwrite_gift_cardsのスコープを持っている必要があります。これらはデフォルトで付与されておらず、マーチャント管理者がShopifyサポートにリクエストする必要があります。
重要:3つのギフトカードテンプレート(Issue Shopify Gift Card、Get Shopify Gift Card Balance、Disable Shopify Gift Card)は、これらのスコープが付与されるまで認証エラーを返します。これは初回失敗の最も一般的な原因です。Shopifyサポートがスコープを付与したら、Settings > Integrations > Data connectorsに戻り、ギフトカードテンプレートを追加または再テストしてください。Shopifyアプリの再インストールは不要です。
Calculate Shopify Refundテンプレートには別の要件があります。ordersまたはmarketplace_ordersスコープが必要で、これはShopifyがデフォルトで付与します。
既知の制限事項
以下の制限はFin向け4つのShopifyデータコネクターテンプレートに適用されます。各制限は影響を受けるテンプレートを示しています。
Calculate Shopify Refund — 注文レベルおよび送料レベルの見積もりのみ対応。このテンプレートは商品ごとの見積もりをサポートしていません。通貨パラメーターは注文の通貨と完全に一致する必要があり、そうでないとShopifyがリクエストを拒否します。
Disable Shopify Gift Card — この操作は取り消せません。Shopifyには無効化されたカードを再有効化するAPIエンドポイントがありません。誤ってカードを無効化した場合は、Issue Shopify Gift Cardテンプレートを使って代替カードを発行してください。
Issue Shopify Gift Card — ギフトカードコードは会話内で表示されません。Finがこのテンプレートを使うと、Shopifyがコードを直接顧客にメール送信します。顧客が受け取っていないと言った場合は、Shopify Adminの顧客レコードのメールアドレスとShopifyの通知ログを確認してください。
4つのテンプレートすべて — 応答フィールドは各テンプレートの設定に記載されたものに限定されます。テンプレートに明示的に記載された応答属性のみFinが読み取れ、その他のShopifyフィールドは非表示で利用できません。
よくある質問
Finは会話内でギフトカードコードを顧客に表示しますか?
Finは会話内でギフトカードコードを顧客に表示しますか?
いいえ。Finは会話内でギフトカードコードを顧客に表示しません。Issue Shopify Gift Cardテンプレートを使ってギフトカードを発行すると、Shopifyがコードを直接顧客にメール送信します。引き換えコードはFinに返されず、会話内で表示されません。FinはカードのID、残高、通貨、有効期限、最後の4文字のみを確認できます。
Finは実際に返金を発行する前に見積もりを出せますか?
Finは実際に返金を発行する前に見積もりを出せますか?
はい。Finは実際に返金を発行する前に見積もりを出せます。Calculate Shopify Refundテンプレートは、返金可能な送料、税金、最大返金額を含む返金見積もりを返しますが、資金は動きません。Finに見積もりを先に出させてから確認し発行したい場合は、既存のCreate Shopify Refundアクションと併用してください。
ギフトカードが無効化されたらどうなりますか?
ギフトカードが無効化されたらどうなりますか?
Disable Shopify Gift Cardテンプレートでギフトカードが無効化されると、カードは即座に使用不可となり復元できません。Shopifyには無効化カードを再有効化するエンドポイントがありません。誤って無効化した場合は、Issue Shopify Gift Cardテンプレートで代替カードを発行してください。
これらのテンプレートはどのShopify APIバージョンを使用していますか?
これらのテンプレートはどのShopify APIバージョンを使用していますか?
4つのShopify補償データコネクターテンプレートはすべてShopify Admin REST API(application programming interface)バージョン2025-04を使用しています。






