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

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

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

対応者:Dawn Perrott

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

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

Data connectorsは、会話中にFinが外部APIを呼び出してライブデータを取得または更新できる機能です。Shopifyテンプレートは、Shopify Admin REST APIを代理で呼び出す事前設定済みコネクターです。API scopesは、コネクターがデータを読み書きする前にShopifyストアが付与する必要がある特定の権限です。

ヒント:これら4つの補償テンプレートは、注文検索、注文変更、割引コード、Storefront商品検索とカートを含むShopifyデータコネクターテンプレートの大きなセットの一部です。完全なリストはUse Data connector templatesでご覧ください。


各Shopify補償テンプレートの機能

Fin向けの4つのShopifyデータコネクターテンプレートは以下の通りで、それぞれ補償ワークフローの異なる部分をカバーしています。

Calculate Shopify Refund

返金見積もりを行います。返金可能な送料、税金、支払い取引ごとの最大返金額を含みますが、実際に資金は動きません。これはドライランアクションで、返金が発生する前に見積もりを計算します。Finが処理前に顧客に金額を確認する場合は、Create Shopify Refundアクションと組み合わせて使用します。Shopifyへの書き込みは行いません。

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

Issue Shopify Gift Card

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

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

Get Shopify Gift Card Balance

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

Intercomのデータコネクター設定にあるGet Shopify Gift Card Balanceテンプレート詳細モーダル。この説明は、顧客のShopifyギフトカードの残高を確認するアクションであることを示しています。例として「ギフトカードの残高はいくらですか?」「このギフトカードの残高を確認してもらえますか?」「このギフトカードは使われていますか?」「ギフトカードの有効期限はいつですか?」などの顧客質問が挙げられています。

Disable Shopify Gift Card

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

Intercomのデータコネクター設定にある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_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つのテンプレートすべて — 応答フィールドは各テンプレートの設定に記載されたものに限定されます。テンプレートに明示的に記載されていないShopifyのフィールドはすべてマスクされ、Finからは利用できません。


よくある質問

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バージョン2025-04を使用しています。

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