WhatsAppマーケティング同意をAPIで管理可能に

8月 06, 2026

API CHANGE

WhatsAppマーケティング同意をAPIで管理できるようになりました

Admin API・Customer Account API 両対応 ― 顧客の同意状態を取得・更新するmutationが登場

2026年6月17日以降、ShopifyのAdmin APIおよびCustomer Account APIを通じて、顧客のWhatsAppマーケティング同意を取得・更新できるようになりました。新しいcustomerWhatsAppMarketingConsentUpdate mutationと、CustomerPhoneNumberオブジェクトのwhatsAppMarketingConsentフィールドにより、EC事業者と開発者はWhatsApp同意管理をシステムに組み込めます。

OVERVIEW

01変更内容の全体像

USE CASES

02業務で活かせる3つのユースケース

課題: CRMやMAツールにWhatsApp同意状態を反映したいが、Shopify側のデータと乖離が生じてしまう
打ち手: Admin APIのcustomerWhatsAppMarketingConsentUpdate mutationを使い、外部ツールでの同意変更イベントをトリガーにShopify側の同意状態をリアルタイムで同期する
効果: 同意の二重管理が解消され、法令遵守（GDPR等）に必要な正確な同意記録を一元管理できる
技術メモ: 同意値の読み取りはCustomerPhoneNumber.whatsAppMarketingConsentフィールドで取得可能。バックエンドのワークフロー（Flowなど）と組み合わせると処理を自動化しやすい

課題: マイページ（顧客アカウント）でWhatsApp通知の受信設定を自分で変更したいが、現状では手段がない
打ち手: Customer Account APIのcustomerWhatsAppMarketingConsentUpdate mutationをHeadless/カスタムアカウントページに組み込み、顧客自身が同意オン/オフを切り替えられるUIを実装する
効果: 顧客が自分の通知設定をセルフサービスで管理でき、オプトアウト対応の工数削減とUX向上を同時に実現する
技術メモ: Customer Account APIはログイン済みの顧客セッションが必要。顧客トークンの取り扱いに関しては公式リファレンスを確認すること

課題: WhatsAppマーケティングキャンペーン開始前に、同意済み顧客の数と電話番号を正確に把握したい
打ち手: Admin APIで顧客リストを取得する際、CustomerPhoneNumber.whatsAppMarketingConsentフィールドを参照して同意済み顧客のみをフィルタリングし、配信対象リストを作成する
効果: 未同意の顧客への誤配信リスクを排除し、WhatsAppビジネスポリシーへの準拠を担保したキャンペーン設計が可能になる
技術メモ: フィルタリングロジックはAPI側・アプリ側のどちらで実装するかを検討し、レスポンスのページネーションにも注意すること

FOR DEVELOPERS