WhatsAppメッセージの送信および配信は、無効なテンプレートやGupshup側での古いユーザーオプトインステータスなど、さまざまな理由で失敗する可能性があります。ここに最も頻繁に発生するエラーとその理由があります:
内部エラー
WhatsAppメッセージを送信中に、内部システムによって生成されるいくつかのエラーがあります:
Error | Description |
---|---|
パーソナライズに失敗しました | メッセージのパーソナライズに失敗し、フォールバックメッセージが設定されていない場合に発生します。システムはユーザーにメッセージを送信せず、Personalization Failedエラーを生成します。 |
無効な携帯電話番号 |
次のシナリオで発生します:
|
Users removed due to Global Control Group | ユーザーがグローバルコントロールグループの一部である場合に発生し、そのためMoEngageはユーザーにメッセージを送信しませんでした。 |
拒否されました。DNDのため。 | ユーザーが設定されたDND時間中にイベントトリガーメッセージの資格を得ると発生します。MoEngageはその場合、ユーザーにメッセージを送信しません。 |
キャンペーンレベルの最小遅延のため送信されませんでした | ユーザーが2つのメッセージまたは同じキャンペーンからのメッセージに該当する場合に発生しますが、キャンペーンの最小遅延設定のためにメッセージが送信されない場合です。 |
BSP/WSP エラー
メッセージは、MoEngageがWhatsAppメッセージをWSPに引き渡してエンドユーザーに配信する際に、WhatsAppサービスプロバイダー(WSP)によって認識されたエラーのために配信に失敗する可能性があります。
以下はエラーのリストです:
info |
情報 このリストは網羅的ではありません。例外が見られ、さらなる情報が必要な場合は、ベンダーのアカウントマネージャーに連絡してください。 Infobipについては、ドキュメントを参照してください こちら 。 |
エラーメッセージ | Description | 解決 |
---|---|---|
メッセージがWhatsApp HSMテンプレートと一致しないか、インタラクティブボタンテンプレートが一致しません。 | テンプレートデータの問題が原因で発生します。テンプレートに送信されたパラメータが期待されていないか、MoEngageに追加したテンプレートがベンダー側で承認されたものと一致していません。 | MoEngageのテンプレートを確認し、ベンダーポータルで承認されたテンプレートに更新してください。 |
認証に失敗しました。無効なユーザーIDまたはパスワードです。 | Gupshupの送信者をMoEngageに追加する際に、無効なユーザーIDまたはパスワードを追加した場合に発生します。Gupshupチームに連絡して、同じことを確認してください。 |
送信者を追加するために提供されたユーザーIDとパスワードを確認してください。
注意: WABA 設定には常にユーザー ID を追加してください (Gupshup ポータルのログイン詳細ではありません)。ユーザー ID は通常、2xxxxxxxxx パターンです。 |
UNKNOWN_SUBSCRIBER: 不明/無効な番号/WhatsAppまたは電話番号に存在しないか、購読されていません | ユーザーの番号が MoEngage に保存されている番号が WhatsApp 番号でない場合に発生します。 |
携帯番号が有効かどうか、またその携帯番号がWhatsAppに存在するかどうかを確認してください。
今後のキャンペーンからそのようなユーザーを除外するには、MoEngageプラットフォームでOPTINステータスをFalseに更新してください。 |
メソッド「SENDMESSAGE」はサポートされていません | MoEngageに送信者として保存されているWhatsApp電話番号が有効な番号でない場合に発生します。Gupshupチームに詳細をお問い合わせください。 | 送信者番号、つまりWABAビジネス番号を確認してください。同じであれば、ベンダーに連絡してください。 |
「INTERNATIONAL_PHONE」サービスはあなたのために無効になっています。このアクションを使用する前に、サービスを有効にしてください | 国際番号にメッセージを送信しようとしているが、サービスがあなたのWhatsAppビジネス番号に対して有効になっていない場合に発生します。Gupshupに連絡して、国際サービスを有効にしてください。 | アカウントの国際サービスを有効にするために、ベンダーに連絡してください。 |
メッセージの長さが超過しました。 TEMPLATEの最大制限は1024です | 本文の長さが1024文字の規定された制限を超えたため、発生します。 | 本文を 1024 文字未満に減らしてください。 |
WhatsAppコネクタAPI一般的な失敗 | InfobipのWhatsApp送信者の詳細に有効なURLを追加しなかった場合に発生します。 |
InfobipのURLが
https://
プレフィックスで始まっているか確認してください。
|
Gupshupからの一般的なエラー | ベンダーによって正確なエラーの詳細が共有されない場合に発生します。 | ベンダーに連絡して、正確なエラーを確認してください。 |
無効な資格情報 | 認証情報が無効な場合に発生します。 | 認証情報を確認し、問題がまだ解決しない場合は、ベンダーにお問い合わせください。 |
無効な電話番号または無効な携帯電話番号 | MoEngageに保存されているユーザーの番号が有効な携帯電話番号または有効なWhatsApp番号でない場合に発生します。 |
モバイル番号が有効かどうか、またそのモバイル番号がWhatsAppに存在するかどうかを確認してください。 |
モバイル番号はオプトインされていません | ユーザーの番号がMoEngageに保存されているが、WhatsAppメッセージの受信にオプトインしていない場合に発生します。 |
ユーザーの同意がある場合は、MoEngageおよびビジネスサービスプロバイダー(BSP)でオプトインステータスを更新してください。 |
あなたのSMSパックの有効期限が切れました | 送信者IDまたはWABA番号のSMSまたはWhatsAppの有効期限が切れた場合に発生します。 |
パックの有効期限を延長するために、ベンダーに連絡してください。 |
WA互換性 | WhatsAppの古いバージョンを使用している場合、または電話番号がWhatsAppに登録されていない場合に発生します。 |
これは、ユーザーが最新バージョンのWhatsAppに更新した後、自動的に解決されます。 |
ユーザー実験の一部 | WhatsAppのユーザーごとのマーケティングテンプレートメッセージ制限により、メッセージが配信されない場合に発生します。 |
高品質な体験を作成するには、 こちら に記載されているいくつかの実践を使用できます。 |
無効な宛先ソース | あなたのWhatsApp BSP/WSP側でIPがホワイトリストに登録されていない場合に発生します。 |
静的IPを設定するには、 こちら を参照してください。 |
info |
Note WSPに関するエラーについては、さらなる支援やガイダンスが必要な場合は、WSPに連絡することをお勧めします。 |
FAQs
WhatsAppメッセージに動的ボタンリンクを設定するには、次の手順を実行します:
- 必要なパートナーポータル(Gupshup、Infobip、Karix、Kaleyra、Exotel、AiSensy、Value First、Route Mobile、Gallabox)に移動し、ボタンリンクを動的または動的リンクトラッキングオプションとしてテンプレートを作成し、承認のためにテンプレートを提出します。
- テンプレートが承認されたら、MoEngageのテンプレート作成画面に移動し、動的または動的リンクトラッキングオプションを使用してテンプレートを追加します。
-
キャンペーンを作成する際の手順:
- 動的: ボタンのエンドユーザーのURLが moengage.com/landingpage=whatsapp である場合、承認のために提出されたURLが moengage.com/landingpage={{1}} である場合、必要なユーザーの値として WhatsApp または SMS を選択するユーザー属性のみを選択します。
- 動的リンクトラッキング: このオプションを使用すると、完全なURLを入力して、短縮して追跡URLをクリックできます。これらのリンクのクリックは、キャンペーン分析のクリックトラッキングセクションに表示されます。
MoEngageは、配信および読取の詳細を受け取るためにパートナーに依存しています。パートナー側で配信またはDLRコールバックが必要なウェブフックURLに設定されているか確認してください。
アカウントのDLRウェブフックは、WhatsApp送信者の詳細セクションにあります。
info |
Information キャンペーン分析が表示されるまで最大30分かかる場合があります。 |
MoEngageは、クリックの詳細を受け取るためにパートナーに依存しています。メッセージまたは受信コールバックがパートナー側で必要なWebhook URLに設定されているか確認してください。
受信Webhook URLは、DLRコールバックWebhook URLと同じです。あなたのアカウントの受信Webhook URLは、WhatsApp送信者の詳細セクションにあります。
info |
Information キャンペーン分析が表示されるまで最大30分かかる場合があります。 |