WooCommerce の注文更新を WhatsApp で送信する

WooCommerce の注文は、どのように WhatsApp メッセージのきっかけになりますか？

WooCommerce の Webhook と受信サーバーを使います。WooCommerce の「設定」、「詳細」、「Webhook」で Webhook を追加し、「注文作成」や「注文更新」といった注文のトピック、配信 URL、シークレットを指定します。以降、該当するイベントが起きるたびに、WooCommerce が注文内容を JSON として配信 URL に POST します。

ペイロードの形式は固定なので、Cloud API に直接向けることはできません。間に受信サーバーを置きます。n8n の Webhook ノード、店舗の PHP 内のルート、小さなサービスなど、何でも使えます。受信サーバーは注文を読み取り、お客様の電話番号とメッセージに必要な情報を取り出して、接続済みの番号の Cloud API メッセージエンドポイントに HTTPS リクエストを 1 回送ります。このとき、その番号のアクセストークンを Bearer トークンとして使います。

order.updated トピックは特定のステータスに限定されません。そのため、受信サーバーは注文の status フィールドを読み取り、送信したい遷移ごとに 1 回だけ送信してください。また、WooCommerce は既定で wp-cron を使ってバックグラウンドで配信するため、メッセージは注文から少し遅れて届くことがあります。

受信サーバーは、リクエストが店舗から届いたものだとどう判断しますか？

WooCommerce の署名で判断します。配信ごとに X-WC-Webhook-Signature ヘッダーが付きます。これは、Webhook に設定したシークレットで生のペイロードから計算した HMAC-SHA256 を base64 エンコードしたものです。受信サーバーは受け取ったボディに対して同じハッシュを計算して比較し、一致しないものは拒否します。

これは店舗自身のシークレットなので、WhatsApp の受信メッセージに付く Meta の署名とは異なり、検証できます。比較は定数時間で行い、ハッシュはフレームワークが解析する前の生のボディに対して計算してください。JSON を再エンコードするとハッシュが変わってしまうためです。

応答はすぐに 2xx で返してください。WooCommerce は 2xx、301、302 以外の応答をすべて失敗と数え、連続で 5 回を超えて失敗すると Webhook を無効にします。デプロイ中でサーバーが止まっていたり、Meta の応答を待ってから返すために遅くなったりすると、誰も気づかないうちに店舗のメッセージ送信が止まることがあります。

店舗は何を、どんなときに送信できますか？

店舗から先に送る場合は、承認済みテンプレートを使います。Meta の 24 時間のカスタマーサービスウィンドウは、お客様がその番号にメッセージを送ったときにしか開きません。注文確認や発送通知は企業側からの送信にあたるため、フリーテキストは拒否されます。更新の種類ごとにユーティリティテンプレートを作成し、承認を待ってから、名前と言語を指定し、注文番号などの情報をパラメータとして渡して送信します。

Meta はオプトインも求めています。お客様が自分の番号を伝え、この企業から WhatsApp で連絡を受けることに同意している必要があります。最も簡単な記録方法は、チェックアウト画面のチェックボックスを注文に保存することです。受信サーバーは送信前にこれを確認してください。

お客様が返信した後は、通常の Coexistence の会話になります。返信は店舗の端末の WhatsApp Business アプリに表示され、ウィンドウが開いているためフリーテキストも送れます。チームはこれまでどおりアプリから返信できます。

よくある間違い

• WooCommerce に応答する前に Cloud API を呼び出してしまう。送信の遅延や失敗が Webhook の失敗として数えられ、5 回を超えると無効になります。
• 解析済みの JSON をハッシュしてしまう。署名が一致せず、正規の配信がすべて拒否されます。
• order.updated の配信のたびに送信してしまう。このトピックは特定のステータスに限定されないため、どの遷移を送信済みか記録していないと、お客様に同じメッセージが重複して届きます。

よくある質問

続きを読む