Skip to main content

​
Shopify

ShanoneのShopify連携は、商品、注文、フルフィルメント、顧客、割引、マーケティング、ストアフロントコンテンツにまたがるAdmin REST APIのほぼ全体をカバーする149個のツールをエージェントに提供します——コマース業務をエンドツーエンドで実行できる、最も充実した連携の一つです。

​
はじめに

1

OAuthで接続する

エージェントにShopify関連の作業を依頼(例: 「今月の売れ筋商品トップ10を教えて」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

ストア名を入力する

ShopifyのOAuthフローでは、どのストアを許可するか特定する必要があります——プロンプトが表示されたら、ストア名(.myshopify.comの前の部分)を入力してください。
3

リクエストを再実行する

接続が完了すると、shopify_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはShopify向けに149個のツールを、以下のカテゴリに整理して提供しています。
shopify_list_products, shopify_get_product, shopify_count_products, shopify_create_product, shopify_update_product, shopify_delete_product, shopify_list_variants, shopify_get_variant, shopify_create_variant, shopify_update_variant, shopify_delete_variant, shopify_count_variants, shopify_list_product_images, shopify_get_product_image, shopify_create_product_image, shopify_update_product_image, shopify_delete_product_image, shopify_count_product_images, shopify_list_product_metafields, shopify_get_product_metafield, shopify_create_product_metafield, shopify_update_product_metafield, shopify_delete_product_metafield
shopify_list_collections, shopify_get_custom_collection, shopify_create_custom_collection, shopify_update_custom_collection, shopify_delete_custom_collection, shopify_count_custom_collections, shopify_list_smart_collections, shopify_get_smart_collection, shopify_create_smart_collection, shopify_update_smart_collection, shopify_delete_smart_collection, shopify_count_smart_collections, shopify_list_collects, shopify_get_collect, shopify_create_collect, shopify_delete_collect, shopify_count_collects
shopify_list_orders, shopify_get_order, shopify_count_orders, shopify_close_order, shopify_cancel_order, shopify_create_order, shopify_update_order, shopify_delete_order, shopify_reopen_order, shopify_list_transactions, shopify_get_transaction, shopify_create_transaction, shopify_count_transactions, shopify_list_refunds, shopify_get_refund, shopify_calculate_refund, shopify_create_refund, shopify_list_order_risks, shopify_get_order_risk, shopify_create_order_risk
shopify_list_fulfillments, shopify_get_fulfillment, shopify_create_fulfillment, shopify_update_fulfillment_tracking, shopify_cancel_fulfillment, shopify_count_fulfillments, shopify_list_fulfillment_orders, shopify_get_fulfillment_order, shopify_cancel_fulfillment_order, shopify_move_fulfillment_order, shopify_apply_fulfillment_hold, shopify_release_fulfillment_hold, shopify_list_fulfillment_events, shopify_get_fulfillment_event, shopify_create_fulfillment_event, shopify_delete_fulfillment_event
shopify_list_customers, shopify_get_customer, shopify_search_customers, shopify_create_customer, shopify_update_customer, shopify_delete_customer
shopify_list_price_rules, shopify_get_price_rule, shopify_list_gift_cards, shopify_get_gift_card, shopify_create_gift_card, shopify_update_gift_card, shopify_disable_gift_card, shopify_count_gift_cards, shopify_search_gift_cards
shopify_list_articles, shopify_get_article, shopify_create_article, shopify_update_article, shopify_delete_article, shopify_count_articles, shopify_list_article_authors, shopify_list_article_tags, shopify_list_blogs, shopify_get_blog, shopify_create_blog, shopify_update_blog, shopify_delete_blog, shopify_count_blogs, shopify_list_pages, shopify_get_page, shopify_create_page, shopify_update_page, shopify_delete_page, shopify_count_pages
shopify_list_marketing_events, shopify_get_marketing_event, shopify_create_marketing_event, shopify_update_marketing_event, shopify_delete_marketing_event, shopify_count_marketing_events, shopify_create_marketing_engagements, shopify_list_events, shopify_get_event, shopify_count_events, shopify_list_reports, shopify_get_report
shopify_list_locations, shopify_get_location, shopify_count_locations, shopify_list_inventory_levels_for_location, shopify_list_inventory_items, shopify_get_inventory_item, shopify_update_inventory_item, shopify_list_inventory_levels, shopify_adjust_inventory_level, shopify_set_inventory_level, shopify_connect_inventory, shopify_delete_inventory_level
shopify_list_redirects, shopify_get_redirect, shopify_create_redirect, shopify_update_redirect, shopify_delete_redirect, shopify_count_redirects, shopify_list_policies, shopify_list_webhooks, shopify_get_webhook, shopify_create_webhook, shopify_update_webhook, shopify_delete_webhook, shopify_count_webhooks
shopify_get_shop_info

​
よくあるユースケース

注文フルフィルメントの自動化

未処理の注文を取得し、フルフィルメントを作成して、追跡番号を一括更新する

在庫の同期

ロケーションごとの在庫レベルを確認し、実棚卸し後に在庫を調整する

カスタマーサポート向け検索

メールアドレスで顧客を検索し、注文と返金の履歴をすべて取得する

ストアフロントコンテンツの更新

Shopify管理画面を使わずに、ブログ記事やランディングページを作成・公開する

​
トラブルシューティング

Shopifyは必須項目(タイトル、バリエーションの価格)を厳密に検証します——shopify_create_productのshanone_get_tool_schemaを確認し、価格が設定されたバリエーションを少なくとも1つ含めてください。
ShopifyのAdmin APIはストアごとにリーキーバケット方式のレート制限を課しています。shopify_update_inventory_itemやshopify_create_fulfillmentのような呼び出しを大量に処理する場合は、一度にまとめて実行せず間隔を空けてください。
フルフィルメントや支払いが完了した注文は直接キャンセル/削除できないことが多いです——まずshopify_create_refundとshopify_cancel_fulfillmentを使って注文を巻き戻してください。
shopify_adjust_inventory_levelは現在の在庫数に対する相対的な変更を行い、shopify_set_inventory_levelは絶対値を設定します——どちらを使うか間違えることが、想定外の在庫数になる最も多い原因です。