Skip to main content

🔧 Shopify Webhook設定リファレンス（コピペ用）

Partner Dashboard設定時の正確なEvent名・URL一覧
Contents Print Integration App用の完全設定リスト

📋 現在設定済みWebhook（5個）​

1. 注文作成​

Event: Order creation
URL: https://api.contents-print.jp/webhooks/shopify/orders/create
Format: JSON

2. 決済完了​

Event: Order payment
URL: https://api.contents-print.jp/webhooks/shopify/orders/paid
Format: JSON

3. 注文更新​

Event: Order updates  
URL: https://api.contents-print.jp/webhooks/shopify/orders/updated
Format: JSON

4. 配送完了​

Event: Order fulfillment
URL: https://api.contents-print.jp/webhooks/shopify/orders/fulfilled
Format: JSON

5. 新規顧客​

Event: Customer creation
URL: https://api.contents-print.jp/webhooks/shopify/customers/create
Format: JSON

✅ 追加設定完了Webhook（4個）​

6. 注文キャンセル ✅ 設定済み​

Event: Order cancellation
URL: https://api.contents-print.jp/webhooks/shopify/orders/cancelled
Format: JSON
Priority: 🔴 Critical - 材料ロス防止
Status: ✅ 2025-08-24 設定完了

7. 顧客情報更新 ✅ 設定済み​

Event: Customer updates
URL: https://api.contents-print.jp/webhooks/shopify/customers/update
Format: JSON
Priority: 🟡 High - 配送先変更対応
Status: ✅ 2025-08-24 設定完了

8. 返金処理 ✅ 設定済み​

Event: Order refund
URL: https://api.contents-print.jp/webhooks/shopify/orders/refunded
Format: JSON
Priority: 🟡 High - 会計整合性
Status: ✅ 2025-08-24 設定完了

9. 商品更新 ✅ 設定済み​

Event: Product updates
URL: https://api.contents-print.jp/webhooks/shopify/products/update
Format: JSON
Priority: 🟡 Medium - 価格・仕様同期
Status: ✅ 2025-08-24 設定完了

⏸️ Phase 2: 将来検討（一人会社では不要）​

アプリ削除（設定不要）​

Event: App uninstalled
理由: 一人会社運営のため不要
- 自分しかアプリ削除しない
- 誤操作リスクなし
- セキュリティ監視不要
Status: ⏸️ 設定不要と判定

📊 Partner Dashboard Event名対照表​

内部TopicPartner Dashboard表示名代替表示名
orders/createOrder creation-
orders/paidOrder paymentOrder transactions create
orders/updatedOrder updates-
orders/fulfilledOrder fulfillmentFulfillment creation
orders/cancelledOrder cancellation-
orders/refundedOrder refundRefunds create
customers/createCustomer creation-
customers/updateCustomer updates-
products/updateProduct updates-
app/uninstalledApp uninstalled-

🔧 Partner Dashboard設定手順​

アクセス先​

https://partners.shopify.com/organizations/[YOUR-ORG-ID]/apps/[APP-ID]/edit

設定手順​

  1. Webhooks セクションに移動
  2. "Add webhook" または "Create webhook" クリック
  3. 下記設定をコピペして入力

📝 設定用コピペテンプレート​

基本設定（全Webhook共通）​

Format: JSON
API Version: 2025-07
Webhook Secret: 417ac888673c93ec75f614903515ddcd952cba42a79e0392f5a2def0609e503f

Base URL​

https://api.contents-print.jp/webhooks/shopify

🚨 緊急追加Webhook詳細​

Priority 1: 今日中に追加​

orders/cancelled（注文キャンセル）​

Event選択: Order cancellation
URL入力: https://api.contents-print.jp/webhooks/shopify/orders/cancelled
Format選択: JSON
理由: 材料ロス防止（月間10-15万円節約）

app/uninstalled（アプリ削除）​

Event選択: App uninstalled  
URL入力: https://api.contents-print.jp/webhooks/shopify/app/uninstalled
Format選択: JSON
理由: セキュリティ侵害防止・GDPR対応

Priority 2: 今週中に追加​

customers/update（顧客更新）​

Event選択: Customer updates
URL入力: https://api.contents-print.jp/webhooks/shopify/customers/update
Format選択: JSON
理由: 配送先住所変更対応（月間5万円節約）

orders/refunded（返金処理）​

Event選択: Order refund
URL入力: https://api.contents-print.jp/webhooks/shopify/orders/refunded
Format選択: JSON
理由: 会計整合性・在庫復帰

products/update（商品更新）​

Event選択: Product updates
URL入力: https://api.contents-print.jp/webhooks/shopify/products/update
Format選択: JSON  
理由: 価格・仕様変更の即座反映

✅ 設定完了確認チェックリスト​

Phase 1: 設定完了（全9個）✅​

  • orders/create ✅ 2025-08-24
  • orders/paid ✅ 2025-08-24
  • orders/updated ✅ 2025-08-24
  • orders/fulfilled ✅ 2025-08-24
  • customers/create ✅ 2025-08-24
  • orders/cancelled ✅ 2025-08-24
  • customers/update ✅ 2025-08-24
  • orders/refunded ✅ 2025-08-24
  • products/update ✅ 2025-08-24

Phase 2: 将来検討（一人会社では不要）​

  • app/uninstalled ⏸️ 設定不要

設定後確認項目​

  • 全Webhook Status: "Active"
  • URL形式正確性確認
  • Secret設定確認
  • Test送信成功確認

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

Event名が見つからない場合​

orders/fulfilled が見つからない場合:
  - "Order fulfillment" を探す
  - "Fulfillment creation" を探す
  - "Fulfillments create" を探す
  
orders/paid が見つからない場合:
  - "Order payment" を探す
  - "Order transactions create" を探す

URL入力時の注意点​

正しい形式:
  ✅ https://api.contents-print.jp/webhooks/shopify/orders/create
  
間違った形式:
  ❌ https://api.contents-print.jp/webhooks/orders/create (shopify部分不足)
  ❌ http://api.contents-print.jp/webhooks/shopify/orders/create (HTTPSでない)

Secret設定確認​

Webhook Secret確認:
  設定値: 417ac888673c93ec75f614903515ddcd952cba42a79e0392f5a2def0609e503f
  文字数: 64文字
  形式: 英数字のみ

📞 設定サポート​

設定でエラーが出た場合​

  1. URL形式確認: https://api.contents-print.jp/webhooks/shopify/[endpoint]
  2. Event名確認: 対照表から正確な名前を選択
  3. Secret確認: 64文字の英数字文字列
  4. API Version確認: 2025-07

完了報告項目​

設定完了後、以下を確認して報告してください：

  • 作成完了Webhook数
  • エラーの有無
  • Test送信結果
  • Active状態確認

🎯 重要: orders/cancelled と app/uninstalled は事業運営・セキュリティに直結します。最優先で設定してください。

📅 更新日: 2025-08-24
バージョン: 1.0 - コピペ対応版