WhatsAppキャンペーンの一般的なエラーのトラブルシューティング

SparkTG経由でWhatsAppキャンペーンを送信する際、メッセージが配信されないエラーが発生することがあります。そのほとんどは、Meta(WhatsApp)のポリシー、テンプレートの設定上の問題、またはアカウントレベルの制限によるものです。このガイドでは、エラーの種類ごとに、その意味と具体的な解決方法を説明します。

1. メッセージが配信されない:配信不能な番号

キャンペーンのメッセージが失敗し、ログに特定の連絡先の配信失敗が表示されている場合、受信者の番号に次のいずれかの問題がある可能性が高いです。

• 番号がWhatsAppに登録されていない、またはその番号に紐づくWhatsAppアカウントが無効化されている。
• 連絡先リストで、国コード(インドは+91など)が欠けているか誤っている。
• 受信者が古いバージョンのWhatsAppを使用しており、Business APIからのメッセージを受信できない。
• 受信者が最新のWhatsApp利用規約に同意していない。メッセージが配信される前に、WhatsAppを開いて更新された規約に同意する必要があります。

1. 1

   連絡先の形式を確認する

   SparkTG → Contactsで、該当の連絡先を開き、番号にスペースや特殊文字を含まない完全な国コードが含まれていることを確認します。例:919876543210(09876543210ではありません)。

2. 2

   キャンペーンから無効な番号を除外する

   キャンペーンを送信する前に、Validate Numbersオプションを使用します。SparkTGが、WhatsAppに登録されていない番号にフラグを付けるので、送信前に除外できます。

3. 3

   受信者にWhatsAppの更新を依頼する

   別のチャネルで連絡が取れる場合は、WhatsAppアプリを更新し、最新の利用規約に同意するよう依頼し、その後メッセージを再試行します。

2. Metaの品質制限によりマーケティングメッセージがブロックされる

Metaは、Business API経由で送信されるマーケティングメッセージの品質を積極的に監視しています。テンプレートの品質評価が低い場合(通常は、受信者がメッセージをブロックまたは報告したことが原因)、Metaは一時的に配信を制限し、クールダウン期間の後に再試行するよう求めます。

• テンプレートの内容を見直します。受信者にとって関連性があり、パーソナライズされ、期待されるものであることを確認してください。
• 連絡先リストを監査します。貴社からのWhatsAppメッセージの受信に明示的にオプトインしていない連絡先を削除します。
• キャンペーンを再試行する前に、クールダウン期間(通常24~48時間)が過ぎるのを待ちます。
• Meta Business Manager → WhatsApp Manager → Message Templatesで、テンプレートの品質評価を確認します。

3. 連絡先に到達できない:Metaの実験による制限

2023年半ば以降、Metaは継続的な実験を行っており、一部のWhatsAppユーザーは、ユーザー側が先に会話を開始していない限り、企業からのマーケティングテンプレートメッセージを受信しません。SparkTGのキャンペーンログでは、これは特定の連絡先に対する配信失敗として表示されます。

• 影響を受けるのは、マーケティングカテゴリのテンプレートのみです。ユーティリティおよび認証テンプレートは影響を受けません。
• 連絡先がこの実験の対象となっている場合、その連絡先にマーケティングメッセージを送る唯一の方法は、先に相手から受信メッセージを受け取ることです。
• 相手からメッセージが届くと、マーケティングを含むあらゆるテンプレートメッセージを送信できる24時間のウィンドウが開きます。
• 影響を受けた連絡先には、別のチャネル(メール、SMS、電話)で連絡を取り、WhatsAppでメッセージを送ってセッションを開始してもらうよう依頼してください。

4. キャンペーンが一時停止:メッセージ送信上限に到達

WhatsAppは、すべてのBusiness APIアカウントに、ティア制の1日あたりのメッセージ送信上限を適用しています。24時間あたり1,000 → 10,000 → 100,000件のユニークな連絡先です。キャンペーンが現在のティアの上限を超えると、24時間のウィンドウがリセットされるまでメッセージは送信されなくなります。

1. 1

   現在のメッセージ送信ティアを確認する

   SparkTG Dashboard → WhatsApp → Channel Status。ここに、現在の上限と、直近24時間のローリングウィンドウでの使用状況が表示されます。

2. 2

   ウィンドウのリセットを待つ

   24時間のウィンドウはローリング式で、固定の深夜0時にリセットされるわけではありません。上限に空きが出ると、自動再試行が有効になっている場合、一時停止中のキャンペーンは自動的に再開されます。

3. 3

   時間をかけてメッセージ送信ティアを引き上げる

   Metaは、安定した大量送信と良好な品質評価に基づいて、自動的にティアを引き上げます。手動のアップグレード申請はありません。高い配信率と低いブロック率を維持することで、より早くティアアップできます。

5. Metaによりアカウントがブロックまたは制限された

WhatsApp Business Account(WABA)がポリシー違反としてフラグを付けられると、Metaがアカウントを制限、または完全に無効化することがあります。この場合、SparkTGはすべてのキャンペーンでアカウントレベルのエラーを表示します。

1. 1

   Meta Business Managerでアカウントの状態を確認する

   business.facebook.com → Settings → WhatsApp Accountsにログインします。制限されている場合は、理由と異議申し立てのオプションが記載されたバナーが表示されます。

2. 2

   Metaに異議申し立てを送信する

   Meta Business ManagerでRequest Reviewをクリックします。審査には通常24~48時間かかります。決定が出ると、メールで通知が届きます。

3. 3

   制限が解除されたのにエラーが続く場合は、SparkTGサポートに連絡する

   Metaが制限を解除してから、SparkTGのプラットフォームに反映されるまで、最大2時間かかることがあります。その時間が過ぎてもエラーが続く場合は、WABA IDを添えてサポートチケットを作成してください。

6. テンプレートのエラー:書式、変数、承認の問題

テンプレートのエラーは、WhatsAppキャンペーンの失敗で最も多いカテゴリです。通常は、変数の欠落、書式の誤り、またはMetaによる一時停止・却下が原因です。

• 空または欠落した変数:テンプレート内のすべての{{variable}}プレースホルダーには、送信時に値が必要です。いずれかの変数が空の場合、メッセージは失敗します。連絡先データを確認し、必須フィールドがすべて入力されていることを確かめてください。
• メディアの欠落または無効:テンプレートに画像、動画、ドキュメントのヘッダーがある場合、送信のたびに有効なメディアファイルを指定する必要があります。ドキュメントヘッダーで対応している形式はPDFのみです。
• 変数内の改行やタブ:テンプレートの変数の値には、改行、タブ、4つを超える連続したスペースを含めないでください。Metaがメッセージを却下します。
• Metaによるテンプレートの一時停止:Metaは、品質評価が低いテンプレートを自動的に一時停止します。WhatsApp Manager → Message Templatesに移動してステータスを確認してください。元のテンプレートが完全に無効化された場合は、内容を新しいテンプレートとして再送信できます。
• テンプレート名が見つからない:SparkTG API経由で送信する場合は、テンプレート名が正確に一致していることを確認してください。大文字・小文字は区別されます。新しく承認されたテンプレートは、APIで利用可能になるまで最大30分かかることがあります。

7. 支払いまたは請求の問題でメッセージが失敗する

WhatsAppは、メッセージ単位ではなく、会話単位で課金します。Metaが支払い方法に請求できない場合、アウトバウンドメッセージは、支払い関連のエラーコードとともにAPIレベルで失敗します。

1. 1

   Meta Business Managerで支払い方法を確認する

   business.facebook.com → Settings → Paymentsに移動します。有効な支払い方法が登録されており、未払いの請求書がないことを確認してください。

2. 2

   SparkTGアカウントの残高を確認する

   SparkTG Dashboard → Billing。キャンペーンの規模に対して、SparkTGアカウントの残高が十分であることを確認してください。アカウントのクレジットが最小しきい値を下回ると、キャンペーンは送信されません。

3. 3

   最近移行した場合は、オンボーディングを再確認する

   最近、他のプロバイダーからSparkTGにWhatsApp番号を移行した場合は、Meta Business ManagerでのBusiness Verificationと支払い設定の手順がすべて完了していることを確認してください。移行が不完全だと、支払いエラーが続くことがあります。

8. メディアのアップロードエラー

テンプレートにメディアヘッダーがあり、アップロードに失敗すると、キャンペーン全体の送信がブロックされます。WhatsAppは、メディアファイルに対して厳格な形式とコーデックの要件を定めています。

• 画像:JPEGまたはPNGで、8ビットカラー、RGBまたはRGBAモードである必要があります。最大ファイルサイズ:5 MB。
• 動画:H.264ビデオコーデックとAACオーディオコーデックを使用する必要があります。オーディオトラックは1つのみ許可されます。最大ファイルサイズ:16 MB。
• ドキュメント:テンプレートメッセージのヘッダーで対応しているのはPDF形式のみです。最大ファイルサイズ:100 MB。
• 動画がサイズ制限を満たしているのに失敗する場合は、コーデックが原因である可能性が最も高いです。HandBrake(H.264 + AAC)などのツールで動画を再エンコードし、もう一度アップロードしてください。

9. メッセージ本文が長すぎる

WhatsAppは、テンプレートの各部分に厳格な文字数制限を設けています。いずれかのセクションが上限を超えると、メッセージは送信されません。

• ヘッダーテキスト:最大60文字。
• 本文テキスト:最大1,024文字。
• フッターテキスト:最大60文字。
• 行動喚起ボタンのURL:最大2,000文字。
• 書式記号(*、_、~)も文字数の上限に含まれます。

10. キャンペーンがブロックされる:クレジット不足

• SparkTG Dashboard → Billingに移動し、利用可能なクレジット残高を確認します。
• キャンペーンを再開する前に、アカウントにチャージします。
• キャンペーンリストのすべての連絡先に有効な国コードがあることを確認します。無効な番号は、配信に失敗した試行でもクレジットを消費します。