Biz Message 問題

Classic/VPC環境で利用できます。

Simple & Easy Notification Serviceの利用中に次のような問題が発生することがあります。問題ごとの原因と解決方法を確認し、適切に対処してください。

カカオトークチャンネル登録エラー

カカオトークチャンネルがコンソールに登録されません。
「リクエストされたチャンネルとテンプレート機能を処理できるステータスではありません。ステータスを確認し、再試行をお願いします。」というエラーメッセージが表示されます。
「カカオトークチャンネルのステータスをご確認ください」というエラーメッセージが表示されます。

原因

カカオトーク チャンネルの設定が間違っている場合、当該エラーが発生することがあります。
既存に作成した検索用 IDと新しく作成した検索用 IDが同じである場合、当該エラーが発生することがあります。
以前に使用したベンダーと Simple & Easy Notification Serviceの内部中継会社が同じである場合、発生することがあります。

解決方法

カカオトークチャンネルの設定が間違っている場合
カカオチャンネル管理者センターで、次を確認します。

• 検索用チャンネル IDの情報が正しいかを確認します。
• チャンネルが公開ステータスであるかを確認します。
• ビジネスチャンネルとして登録されているかを確認します。
• チャンネルのサポートセンター情報が入力されているかを確認します。
  • サポートセンター情報の入力を参照
• 他のアカウントで登録して使用中のチャンネルではないかを確認します。

検索用 IDが同じである場合
以前に Simple & Easy Notification Serviceに登録した検索用 IDを持つチャンネルであるかを確認します。検索用 IDが重複しないように変更します。

以前に使用したベンダーと内部中継会社が同じである場合
以前に利用したベンダー名とチャンネル名をサポートまでご連絡ください。中継会社を通じて二重登録の可否を確認し、プロジェクトを手動で登録できます。手動登録の場合、営業日基準で3∼4日かかる場合があります。
ただし、状況によってはチャンネル登録できなかったり、チャンネルの移行が必要になる場合があります。また、以前のベンダーで利用中のテンプレートコードを再使用できない場合があり、テンプレートの移行は不可です。

サポート情報の入力

チャンネルを作成する際、「登録したい送信プロファイルチャンネルのサポートセンター情報の入力が必要です。」というエラーメッセージが表示されます。
「リクエストされたチャンネルタスクを実行できません。」というエラーメッセージが表示されます。
サポートセンター情報の入力場所が見つかりません。

原因

2023年6月22日より KISAガイドラインに従い、新規送信プロファイル(チャンネル)を登録する際、サポートセンター情報の入力が義務化されました。チャンネル作成および登録前に、サポートセンター情報を入力する必要があります。

解決方法

サポートセンター情報を入力する方法は、次の通りです。

1. カカオトークのチャンネル管理者センターにアクセスします。
2. プロファイル > チャンネルホーム設定をクリックします。
3. 基本情報項目のサポートセンター入力フィールドにサポートセンター情報を入力します。

チャンネル登録不可

チャンネルが登録されません。
チャンネル削除履歴があるため、登録不可というメッセージが表示されます。

原因

以前にチャンネルとして登録して削除したカカオトークチャンネルは復元できません。また、他のアカウントでも Simple & Easy Notification Serviceに再登録できません。

解決方法

この現象はシステムの正常な動作であり、削除されたカカオトークチャンネルは復元できず、同じチャンネルを再登録することもサポートしません。したがって、現在のステータスでは同じチャンネルを再登録できません。詳細は、カカオトークチャンネル削除をご参照ください。

チャンネル削除の遅延

チャンネルの削除が遅延しています。

原因

チャンネル削除時に検収が必要なため、即時削除されません。

解決方法

チャンネルの削除は、中継会社の精算処理などの理由により、最大1か月かかる場合があります。削除が完了するまで待機してください。削除リクエスト中のチャンネルは、削除のキャンセルができません。

• カカオトークチャンネル削除
• カカオトーク チャンネルの移行(同じアカウント)

通知トーク受信失敗

通知トークの送信リクエストは成功しましたが、受信ステータスが失敗と表示されます。
APIレスポンス結果には「COMPLETED」ステータスと表示されますが、通知が送信されません。

原因

サービスの利用環境によっては、様々な原因が考えられます。

• 受信者の通知設定に問題がある場合
• 受信者の情報が正しく設定されていない場合
• テンプレートに問題があるか、送信内容にマルチバイト絵文字が含まれている場合

解決方法

次の項目を確認します。

通知設定を確認

• 受信者のカカオトーク受信設定を確認します。
• 受信者が通知トークの受信を許可しているかを確認します。
• 通知トークブロックの有無を確認します。

受信者情報を確認

• 受信者の電話番号が正しい国際電話番号形式(例: +82-10-1234-5678)で入力されているかを確認します。
• 送信に使用されたプラス友達 IDが正しいか、当該プラス友達のアカウントが正しく登録されているかを確認します。
• 受信者がカカオトークに登録した番号と実際の電話番号が一致しているか、番号が有効なステータスであるかを確認します。

テンプレートとコンテンツを確認

• 使用されたテンプレートコードが正確であるか、テンプレートが正しく設定されているかを確認します。
• SMS(subject、content)の場合、エンコードは EUC-KR基準で送信されます。サポートしない絵文字が含まれていないかを確認します。通知トーク送信時に failoverConfig.contentを通じて内容を変更できます。

テンプレートに接続されたチャンネルの変更

テンプレートの承認を受けるチャンネルを間違って設定しました。
複数のチャンネルを運用中ですが、承認されたテンプレートに接続されたチャンネルを変更したいです。

原因

テンプレートに接続されたチャンネルは変更できません。

解決方法

テンプレートを新しく登録し、再度承認をリクエストします。

通知トークテンプレートの登録時にプロジェクトページに移動

通知トークテンプレートの登録時にプロジェクトページに移動します。

原因

通知トークサービスを利用するには、Biz Messageサービスが含まれたプロジェクトが必要です。

解決方法

Biz Messageサービスを含まれたプロジェクトを作成します。

テンプレート承認の遅延

テンプレートの検収をリクエストしましたが、まだ進行中です。
テンプレートの承認が完了しません。

原因

テンプレートの検収と承認はカカオで行われます。NAVERクラウドプラットフォームでは、テンプレートの承認処理は行いません。

解決方法

テンプレートの検収と承認はカカオで行われるため、NAVERクラウドプラットフォームでは処理の遅延に関してサポートできません。

「テンプレートボタン形式が無効です」というエラーメッセージ

「テンプレートボタン形式が無効です」というエラーメッセージが表示されます。
既存に登録されたテンプレートと同じように適用したにもかかわらず、エラーが発生します。

原因

同じカカオトークチャンネル内では、テンプレートコードとテンプレート名が重複できません。

解決方法

テンプレートコードとテンプレート名が重複しないように変更し、再登録します。
詳細は、通知トークテンプレート登録をご参照ください。

メッセージプレビュー不可

セキュリティテンプレートとして登録していないにもかかわらず、メッセージ受信時にプレビューが表示されません。

原因

テンプレートに次の情報が含まれている場合、テンプレートの検収時にセキュリティテンプレートとして分類されることがあります。

• OTP
• 認証番号
• パスワード(再設定、仮パスワードなど)
• 信用情報の変更(信用格付けの変更)

解決方法

セキュリティテンプレートに分類されると、メッセージのプレビューが表示されません。原因で説明したように、特定情報が含まれている場合、セキュリティテンプレートに分類されるため、テンプレートに含まれる情報を確認します。

チャンネル名に韓国語を入力した際のエラー

APIパラメータにチャンネル名を韓国語で入力した際に401 認証エラーが発生します。

原因

ハングルエンコードの問題により発生するエラーです。

解決方法

チャンネル名の呼び出し時には、encodeURIのようなライブラリを使用して呼び出します。

String requestUrl = "/alimtalk/v2/services/{serviceid}/templates?channelId=@" + URLEncoder.encode("NAVERクラウドプラットフォーム", StandardCharsets.UTF_8);

通知トークの変更および削除不可

登録された通知トークを変更または削除しようとしても、当該ボタンが無効になっています

原因

検収が完了して送信に使用されたことのある通知トークのテンプレートを変更したり削除できません。

解決方法

• 検収中のテンプレートのステータスが待機中、処理中、拒否の場合、検収リクエストをキャンセルし、検収待機ステータスに変更してからテンプレートを変更できます。
• 検収が完了したものの、送信に使用されなかったテンプレートの場合、承認をキャンセルし、検収待機ステータスに変更してからテンプレートを変更できます。
• 検収が完了して送信に使用されたテンプレートは変更および削除できないので、必要な場合は新しいテンプレートを登録します。

3016エラーコード、「メッセージ内容がテンプレートと一致しません」というエラーメッセージ

3016エラーコードが表示されます。
「メッセージの内容がテンプレートと一致しません」というエラーメッセージが表示されます。
リクエストは成功しましたが、受信が失敗と表示されます。

原因

メッセージ内容がテンプレートと一致しない場合に発生します。

解決方法

Request Bodyおよび使用したテンプレートの内容と設定した内容が一致するかを確認します。ボタンの順番は登録された順番と一致する必要があります。
通知トークエラーコードに関する詳細は、通知トーク受信結果コードをご参照ください。

3018エラーコード、「メッセージを送信できません」というエラーメッセージ

3018エラーコードが表示されます。
「メッセージを送信できません」というエラーメッセージが表示されます。

原因

3018エラーコードは、受信者側に問題がある場合に発生します。

• カカオの会員でない場合
• カカオトークチャンネルをブロックした場合
• USIM番号が一致しない場合

解決方法

3018エラーコードは受信側の問題であり、送信元である NAVERクラウドプラットフォームでは原因を確認して措置できません。 受信者がカカオまたは通信会社を通じて原因を確認します。