メインコンテンツへスキップ
このガイドは、韓国国内向けのSMS、LMS、MMSが対象です。他の国や地域への配信については、設定前にNotiflyにお問い合わせください。

1. 送信元番号を事前登録する

韓国では、発信番号の偽装防止と利用者保護を定める電気通信事業法第84条の2に基づき、送信元番号の事前登録制度が設けられています。通信事業者の迷惑メッセージ対策により、配信前に送信元番号を登録する必要があります。

1-1. 必要書類を用意する

1. 通信サービスの契約証明書

通信サービスの契約証明書は、電話番号の契約名義を確認するための書類です。契約先の通信事業者に電話して、発行を依頼してください。
  1. 証明書に記載された契約名義は、事業者またはその代表者である必要があります。
  2. 発行から3か月以内で、記載内容を隠していない証明書を提出してください。

2. 電話番号の利用承諾書

  • Grey Boxの利用承諾書をダウンロードし、必要事項を記入します。
  • アカウント名義情報(계정 명의자 정보)欄には 주식회사 그레이박스 と入力してください。

3. 事業者登録証

1-2. Notiflyに送信元番号を登録する

  1. Notiflyにログインします。電話番号の認証が済んでいない場合は、先に認証を完了してください。設定 > チャネル設定 > メッセージ (SMS, LMS, MMS) を開きます。初めて送信元番号を登録する場合は、登録をクリックします。登録済みの番号がある場合は、配信プラットフォームの横にあるプラスアイコンをクリックします。 テキストメッセージのチャネル設定にある送信元番号の登録ボタン
  2. プラットフォームにNotiflyを選択します。個人情報処理委託契約書の作成 (必須) を開き、必要事項を入力します。
  3. 手順1-1で用意した書類と、フォームで必須の在職証明書をPDFで添付します。保存をクリックして提出します。
送信元番号の登録フォーム

2. テキストメッセージをテスト配信する

キャンペーンの作成画面からテスト配信を行い、設定が正しく完了していることを確認してください。

3. 配信停止用の080番号を設定する(任意)

080番号は、韓国で受信者が無料で電話をかけて広告メッセージの配信停止を申し込むための番号です。韓国で広告目的のテキストメッセージを送る場合は、法律で定められた同意を取得してください。本文の先頭に (광고) と記載し、送信者情報と無料で配信を停止できる方法を案内します。韓国インターネット振興院(KISA)の迷惑メッセージ対策ガイド(韓国語)を参照してください。080番号の発行をご希望の場合は、contact@notifly.techまたはお客様専用のSlackチャンネルまでお問い合わせください。
  • 080番号を申し込む前に、1番号あたりの月額料金を確認してください。
  • 080番号の発行には通常3~4営業日かかります。
  • 広告メッセージかどうかをオンにしたテキストメッセージには、Notiflyが080の配信停止リストを適用します。
    • カカオの代替配信で080の配信停止リストが適用される範囲は、プロジェクトごとに確認してください。
  • 080の配信停止リストは、APIでも管理できます。配信停止番号の一覧取得、追加、削除を参照してください。
    • 配信停止リストに番号が登録されたときにWebhookで通知することもできます。 080の配信停止番号の登録を通知するWebhookの設定

4. メッセージ内のリンクのクリックを計測する

標準のテキストメッセージでは、リンクのクリック数を集計できません。計測する場合は、追加機能のトラッキングリンクを使います。
トラッキングリンクを利用する前に、プロジェクトに適用されるクリック単価を確認してください。
トラッキングリンクを使用できるのはLMSとMMSのみです。
ユーザージャーニーではトラッキングリンクを使用できません。
トラッキングリンクを含むメッセージは、テスト送信では確認できません。リンクの動作を確認するには、予約配信またはイベントベースのテスト用キャンペーンを作成し、送信対象でユーザーグループ設定を選んでテストモードをオンにします。テスト対象者リストに、社内テスターの外部ユーザーID(ユーザー一覧のユーザーID)を1行に1件ずつ入力します。実行前に、リストにIDが1件以上あり、社内テスターのIDだけが含まれていることを確認してください。テスターはキャンペーンの配信対象条件も満たす必要があります。メッセージだけをテストする場合は、トラッキングリンクを含まないメッセージまたはテンプレートを使います。

トラッキングリンクを設定する

  1. キャンペーンを作成し、配信タイミングと配信対象を設定します。メッセージとアクションでトラッキングリンクをクリックします。
  2. リンク先のURLを入力します。
  3. 링크 추가(リンクを追加)をクリックして、計測用のリンクを本文に挿入します。
  4. Notiflyはリンク先のURLの代わりに、短縮した計測用URLを配信します。正しく計測するため、生成されたURLはそのまま使用してください。

5. 配信結果をWebhookで受け取る

NotiflyがNHN経由で送信したSMS、LMS、MMSの配信結果を、Webhookで受け取れます。キャンペーンやユーザージャーニーで対象のイベントが発生すると、Notiflyはメッセージごとに配信の成功、失敗、スキップをJSONで通知します。 カカオとの直接連携で配信に失敗し、Notiflyのテキストメッセージで代替配信した場合も対象です。他の配信プラットフォームや配信事業者による代替配信は対象外です。080の配信停止番号の登録を通知するWebhookは別機能です。

Webhookを設定する

  1. JSONを本文に含むPOSTリクエストを受け取れるよう、外部からアクセス可能なHTTPSエンドポイントを用意します。
  2. 設定 > チャネル設定 > メッセージ (SMS, LMS, MMS) を開きます。SMS配信結果のWebhook URLが表示されていれば、受信先のURLを入力して保存します。
  3. 設定項目が表示されない場合は、お客様専用のSlackチャンネルかサポート窓口に、プロジェクトIDと受信先のURLを伝えて設定を依頼します。
次の例は、プロジェクトのtext_message_delivery_result_webhookの設定形式を示しています。公開APIのリクエスト本文としては使用できません。
ペイロードにはユーザーIDや電話番号が含まれる場合があります。本番環境ではHTTPSを使用してください。WebhookはURLが設定されている場合に送信されます。設定を解除するには、コンソールでURLを空欄にして保存するか、連携担当者に依頼してください。設定はキャッシュされるため、変更が反映されるまでに時間がかかることがあります。

発生するイベント

pendingと、再予約が成功したことを表すrequeued__forbidden_timingは送信しません。再予約の失敗はskipped__forbidden_timing_requeue_failedとして送信します。また、メッセージIDやキャンペーンまたはユーザージャーニーの識別情報などがない結果は対象外です。内部エラーや配信対象からの除外の一部のみがWebhookで通知されます。 配信に失敗し、失敗理由が取得できる場合は、failureReasonに含まれます。

リクエスト本文のスキーマ

メッセージ本文は含まれません。timestampは結果の処理時刻またはWebhookデータの生成時刻で、受信者の閲覧時刻は記録しません。

キャンペーンでテキストメッセージの送信に成功した例

ユーザージャーニーで代替配信に成功した例

カカオのメッセージと代替メッセージの配信結果は、チャネルごとに個別に届きます。代替配信の結果を特定するには、channelTypeとmetadata.isFailoverの両方を確認してください。
はい。1つのプロジェクトに複数の送信元番号を登録できます。番号を追加するたびに、必要書類を提出してください。
他社で発行した080番号もNotiflyで使用できます。以下の点に注意してください。
  • 広告目的のテキストメッセージとその代替配信では、外部の配信停止リストは自動で適用されません。カスタムユーザー属性を使い、配信対象を絞り込んでください。
  • メッセージ本文に韓国語の広告表記 (광고) と配信停止用の080番号を記載してください。