メインコンテンツにスキップ

Fin向けShopify補償テンプレート

Finの4つの事前構築済みデータコネクターテンプレートを追加・使用して、Shopifyからの返金見積もり、ギフトカード、残高確認を処理する方法。

対応者:Dawn

この記事を使ってFinの4つの事前構築済みShopifyデータコネクターテンプレートを設定し、サポート会話中にチームメイトが介入せずに返金見積もり、ストアクレジット発行、ギフトカードの確認や無効化を行えるようにします。

Intercomの設定ページでData connectorsが開かれ、Shopifyテンプレートピッカーのモーダルが重なっています。モーダルには「Calculate Shopify Refund」「Disable Shopify Gift Card」「Get Shopify Gift Card Balance」の3つの利用可能なテンプレートが短い説明付きでリストされています。矢印の注釈が左側ナビゲーションのData connectors項目からモーダルを指しています。

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への書き込みは行いません。

IntercomのData connectors設定にあるCalculate Shopify Refundテンプレート詳細モーダル。この説明は、送料を含む返金額を見積もるドライランの操作で、取引は作成しないことを示しています。例として、顧客からの質問「この注文でいくら返金されますか?」「返金額を教えてもらえますか?」「送料も返金されますか?」「この注文で最大いくら返金できますか?」が挙げられています。

Issue Shopify Gift Card

Shopifyギフトカードとしてストアクレジットを発行します。Shopifyがコードを直接顧客にメール送信し、引き換えコードはFinに返されず会話内で表示されません。FinはカードのID、残高、通貨、有効期限、最後の4文字のみを確認できます。このテンプレートはShopifyに書き込みます。

IntercomのData connectors設定にあるIssue Shopify Gift Cardテンプレート詳細モーダル。この操作は善意のクレジットや補償としてShopifyギフトカードを発行し、コードはShopifyが直接顧客にメール送信するため、エージェントに完全な引き換えコードは表示されません。例として、顧客からの質問「このトラブルのためにストアクレジットをもらえますか?」「返金の代わりにギフトカードが欲しい」「配送遅延のためのクレジットを送ってもらえますか?」「前回の注文で補償を受けると聞きました」が挙げられています。

Get Shopify Gift Card Balance

顧客のShopifyギフトカードの残高、初期値、有効期限を確認します。顧客が残高を尋ねたりカードが使用済みかどうかを確認したい時に使用します。Shopifyへの書き込みは行いません。

IntercomのData connectors設定にあるGet Shopify Gift Card Balanceテンプレート詳細モーダル。この操作は顧客のShopifyギフトカードの残高を確認します。例として、顧客からの質問「ギフトカードの残高はいくらですか?」「このギフトカードの残高を確認してもらえますか?」「このギフトカードは使われていますか?」「ギフトカードの有効期限はいつですか?」が挙げられています。

Disable Shopify Gift Card

誤って発行されたギフトカード(例えば、誤った金額、誤った顧客への送付、誤発行)を無効化します。カードは即座に使用不可になります。

IntercomのData connectors設定にあるDisable Shopify Gift Cardテンプレート詳細モーダル。この操作は誤発行されたギフトカードを無効化します。例として、顧客からの質問「間違ってギフトカードをもらったのでキャンセルできますか?」「このギフトカードは誤った金額で発行されたので無効にしてください」「今送ったギフトカードを無効にできますか?」「このクレジットはもう必要ないのでキャンセルしてください」が挙げられています。下部の警告には「この操作は元に戻せず、無効化されたギフトカードを再有効化する方法はありません」と記載されています。

重要:この操作は元に戻せません。Shopifyには無効化されたギフトカードを再有効化する方法がありません。誤ってカードを無効化した場合は、Issue Shopify Gift Cardテンプレートを使って代替カードを発行してください。


テンプレートの追加方法

  1. Shopifyセクションで追加したいテンプレートを見つけます。

  2. Shopifyストア接続を接続(または再利用)します。アクションのURLはワークスペースが接続しているストアを自動的にターゲットにします。アクションごとのdomain設定は不要です。

  3. 事前入力されたパラメーター、説明、Finの使用ガイダンスを確認します。Set liveをクリックしてテンプレートを有効化します。Settings > Integrations > Data connectorsでコネクターが有効としてリストされているのが確認できます。

注意:各テンプレートはワークスペースごとに有効化されます。有効化後は実際の会話でコネクターをテストしてください。Finのプレビューモードはライブのデータコネクター呼び出しを行いません。


Shopifyに必要な権限

ギフトカードテンプレートを追加する前に、Shopifyストアはread_gift_cardswrite_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は会話内でギフトカードコードを顧客に表示しません。Issue Shopify Gift Cardテンプレートを使ってギフトカードを発行すると、Shopifyがコードを直接顧客にメール送信します。引き換えコードはFinに返されず、会話内で表示されません。FinはカードのID、残高、通貨、有効期限、最後の4文字のみを確認できます。

Finは実際に返金を発行する前に見積もりを出せますか?

はい。Finは実際に返金を発行する前に見積もりを出せます。Calculate Shopify Refundテンプレートは、返金可能な送料、税金、最大返金額を含む返金見積もりを返しますが、資金は動きません。Finに見積もりを先に出させてから確認し発行したい場合は、既存のCreate Shopify Refundアクションと併用してください。

ギフトカードが無効化されたらどうなりますか?

Disable Shopify Gift Cardテンプレートでギフトカードが無効化されると、カードは即座に使用不可となり復元できません。Shopifyには無効化カードを再有効化するエンドポイントがありません。誤って無効化した場合は、Issue Shopify Gift Cardテンプレートで代替カードを発行してください。

これらのテンプレートはどのShopify APIバージョンを使用していますか?

4つのShopify補償データコネクターテンプレートはすべてShopify Admin REST API(application programming interface)バージョン2025-04を使用しています。

こちらの回答で解決しましたか?