> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# NotiflyでSMSなどのテキストメッセージを配信する

> 韓国国内向けのテキストメッセージの送信元番号を登録します。テスト配信と、Webhookで配信結果を受け取る方法も説明します。

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

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

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

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

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

> [!NOTE]
>
> 通信サービスの契約証明書は、電話番号の契約名義を確認するための書類です。契約先の通信事業者に電話して、発行を依頼してください。

> [!NOTE]
>
> | 通信事業者 | 書類名 | 連絡先 |
> | - | - | - |
> | KTカスタマーセンター | 加入証明書（가입증명원） | 1588-0114 |
> | LG U+ | 加入確認書（가입사실 확인서） | 1544-0001 |
> | SKT | 利用契約証明書（이용계약증명서） | 080-8282-123 |
> | セジョンテレコム | | 1699-1000 |
> | 韓国ケーブルテレコム（KCT） | | 070-8188-0114 |
> | Hello Mobile（KT回線） | | 1855-1144 |
> | Hello Mobile（SKT回線） | | 070-8188-0114 |

> [!WARNING]
>
> 1. 証明書に記載された契約名義は、**事業者またはその代表者**である必要があります。
> 2. **発行から3か月以内**で、記載内容を隠していない証明書を提出してください。

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

* [Grey Boxの利用承諾書](https://notifly-content.s3.ap-northeast-2.amazonaws.com/common-files/%E1%84%8C%E1%85%A5%E1%86%AB%E1%84%92%E1%85%AA%E1%84%87%E1%85%A5%E1%86%AB%E1%84%92%E1%85%A9+%E1%84%8B%E1%85%B5%E1%84%8B%E1%85%AD%E1%86%BC%E1%84%89%E1%85%B3%E1%86%BC%E1%84%82%E1%85%A1%E1%86%A8%E1%84%89%E1%85%A5+%E1%84%8B%E1%85%A3%E1%86%BC%E1%84%89%E1%85%B5%E1%86%A8.docx)をダウンロードし、必要事項を記入します。
* アカウント名義情報（`계정 명의자 정보`）欄には `주식회사 그레이박스` と入力してください。

#### 3. 事業者登録証

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

1. Notiflyにログインします。電話番号の認証が済んでいない場合は、先に認証を完了してください。**設定 > チャネル設定 > メッセージ (SMS, LMS, MMS)** を開きます。初めて送信元番号を登録する場合は、**登録**をクリックします。登録済みの番号がある場合は、配信プラットフォームの横にあるプラスアイコンをクリックします。

   ![テキストメッセージのチャネル設定にある送信元番号の登録ボタン](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/text-message/text-message-register.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=0bb2d80c623fd7435720a9d6c8f90e6d)
2. プラットフォームに**Notifly**を選択します。**個人情報処理委託契約書の作成 (必須)** を開き、必要事項を入力します。
3. 手順1-1で用意した書類と、フォームで必須の**在職証明書**をPDFで添付します。**保存**をクリックして提出します。

![送信元番号の登録フォーム](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/text-message/register-notifly-platform-for-text-message.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=83fb86eca27be07fbae030750f10ee14)

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

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

* テキストメッセージには絵文字を使えません。詳しくは[テキストメッセージの形式に関するFAQ](https://docs.notifly.tech/ja/user-guide/faq.md#1-%E3%83%A1%E3%83%83%E3%82%BB%E3%83%BC%E3%82%B8%E5%BD%A2%E5%BC%8F)を参照してください。
* 通信事業者が迷惑メッセージと判定した場合は、通信事業者の迷惑メッセージ対策サービスを確認してください。メッセージが届かず、端末の迷惑メッセージフォルダーにも表示されないことがあります。詳しくは[通信事業者ごとの迷惑メッセージ対策（韓国語）](https://www.smsko.co.kr/info_law/law_spamx.html)を参照してください。

## 3. 配信停止用の080番号を設定する（任意）

080番号は、韓国で受信者が無料で電話をかけて広告メッセージの配信停止を申し込むための番号です。韓国で広告目的のテキストメッセージを送る場合は、法律で定められた同意を取得してください。本文の先頭に `(광고)` と記載し、送信者情報と無料で配信を停止できる方法を案内します。[韓国インターネット振興院（KISA）の迷惑メッセージ対策ガイド（韓国語）](https://spam.kisa.or.kr/spam/na/ntt/selectNttInfo.do?bbsId=1002\&mi=1020\&nttSn=3001)を参照してください。080番号の発行をご希望の場合は、[contact@notifly.tech](mailto:contact@notifly.tech)またはお客様専用のSlackチャンネルまでお問い合わせください。

* 080番号を申し込む前に、1番号あたりの月額料金を確認してください。
* 080番号の発行には通常3～4営業日かかります。
* **広告メッセージかどうか**をオンにしたテキストメッセージには、Notiflyが080の配信停止リストを適用します。
  * カカオの代替配信で080の配信停止リストが適用される範囲は、プロジェクトごとに確認してください。
* 080の配信停止リストは、APIでも管理できます。[配信停止番号の一覧取得、追加、削除](https://docs.notifly.tech/ja/api-reference/list-080-block-recipients.md)を参照してください。
  * 配信停止リストに番号が登録されたときにWebhookで通知することもできます。

    ![080の配信停止番号の登録を通知するWebhookの設定](https://mintcdn.com/notifly/ZSWJJOaZ4UmG3tpK/images/i18n/ja/text-message/080-webhook.png?fit=max\&auto=format\&n=ZSWJJOaZ4UmG3tpK\&q=85\&s=50a82a2d6ded381db579ddaf5d6ab4a3)

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

標準のテキストメッセージでは、リンクのクリック数を集計できません。計測する場合は、追加機能の**トラッキングリンク**を使います。

> [!TIP]
>
> トラッキングリンクを利用する前に、プロジェクトに適用されるクリック単価を確認してください。

> [!NOTE]
>
> トラッキングリンクを使用できるのはLMSとMMSのみです。

> [!WARNING]
>
> ユーザージャーニーではトラッキングリンクを使用できません。

> [!WARNING]
>
> トラッキングリンクを含むメッセージは、**テスト送信**では確認できません。リンクの動作を確認するには、予約配信またはイベントベースのテスト用キャンペーンを作成し、**送信対象**で**ユーザーグループ設定**を選んで**テストモード**をオンにします。
>
> **テスト対象者リスト**に、社内テスターの外部ユーザー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チャンネルか[サポート窓口](mailto:contact@notifly.tech)に、プロジェクトIDと受信先のURLを伝えて設定を依頼します。

次の例は、プロジェクトの`text_message_delivery_result_webhook`の設定形式を示しています。公開APIのリクエスト本文としては使用できません。

```json theme={null}
{
  "text_message_delivery_result_webhook": {
    "url": "https://example.com/webhooks/notifly/text-message",
    "method": "POST",
    "headers": {
      "Content-Type": "application/json"
    }
  }
}
```

ペイロードにはユーザーIDや電話番号が含まれる場合があります。本番環境ではHTTPSを使用してください。WebhookはURLが設定されている場合に送信されます。設定を解除するには、コンソールでURLを空欄にして保存するか、連携担当者に依頼してください。設定はキャッシュされるため、変更が反映されるまでに時間がかかることがあります。

### 発生するイベント

| `eventName` | 発生条件 |
| - | - |
| `send_success` | 配信結果の収集処理、または配信事業者のコールバックで配信成功を確認しました。 |
| `send_failure` | 配信リクエストの拒否が確定した場合、最終的に配信に失敗した場合、または配信ポリシーの確認処理に失敗した場合。 |
| `skipped__fatigue_management` | イベントベースのキャンペーンで、配信頻度を抑えるための制限により配信をスキップしました。 |
| `skipped__excluded_user_filter` | イベントベースのキャンペーンで、ユーザーが除外条件に該当した場合。 |
| `skipped__global_frequency_limit_filter` | 全体の配信回数制限により配信をスキップしました。 |
| `skipped__campaign_delivery_stopped` | 単発の予約配信キャンペーンで、配信が停止されていることを確認しました。 |
| `skipped__forbidden_timing_filter` | 配信禁止時間帯のルールにより配信をスキップしました。 |
| `skipped__forbidden_timing_requeue_failed` | 禁止時間帯が終わった後の時刻に配信を再予約できなかった場合。 |

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

配信に失敗し、失敗理由が取得できる場合は、`failureReason`に含まれます。

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

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `version` | string | 必須 | スキーマのバージョンです。現在は`"1.0"`です。 |
| `projectId` | string | 必須 | NotiflyプロジェクトのIDです。 |
| `messageId` | string | 必須 | 配信結果に対応するメッセージのIDです。 |
| `userId` | stringまたはnull | 必須 | お客様のサービスで使用するユーザーIDです。取得できない場合は`null`です。 |
| `phoneNumber` | stringまたはnull | 必須 | 受信者の電話番号です。取得できない場合は`null`です。 |
| `resourceType` | string | 必須 | `"campaign"`または`"user_journey"`です。 |
| `campaignId` | string | キャンペーンで必須 | キャンペーンIDです。ユーザージャーニーでは省略します。 |
| `userJourneyId` | string | ユーザージャーニーで必須 | ユーザージャーニーIDです。キャンペーンでは省略します。 |
| `userJourneyNodeId` | string | 任意 | ユーザージャーニーのノードIDです。取得できる場合のみ含まれます。 |
| `sessionId` | string | 任意 | 実行セッションIDです。取得できる場合のみ含まれます。 |
| `eventName` | string | 必須 | 上記のイベント表を参照してください。 |
| `failureReason` | string | 任意 | 失敗理由の文字列がある場合のみ含まれます。 |
| `timestamp` | number | 必須 | 結果処理時に記録したUnixタイムスタンプ（ミリ秒）です。取得できない場合は、Webhookデータの生成時刻です。 |
| `channelType` | string | 必須 | `"text-message"`です。 |
| `metadata` | object | 必須 | テキストメッセージの種類と、代替配信かどうかを示します。 |
| `metadata.subtype` | string | 必須 | `"sms"`、`"lms"`、`"mms"`のいずれかです。 |
| `metadata.isFailover` | boolean | 必須 | 通常の配信は`false`、対応するカカオの代替配信は`true`です。 |

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

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

```json theme={null}
{
  "version": "1.0",
  "projectId": "project-example",
  "messageId": "550e8400-e29b-41d4-a716-446655440000",
  "userId": "user-example",
  "phoneNumber": "01000000000",
  "resourceType": "campaign",
  "campaignId": "campaign-example",
  "eventName": "send_success",
  "timestamp": 1789106667000,
  "channelType": "text-message",
  "metadata": {
    "subtype": "sms",
    "isFailover": false
  }
}
```

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

カカオのメッセージと代替メッセージの配信結果は、チャネルごとに個別に届きます。代替配信の結果を特定するには、`channelType`と`metadata.isFailover`の両方を確認してください。

```json theme={null}
{
  "version": "1.0",
  "projectId": "project-example",
  "messageId": "550e8400-e29b-41d4-a716-446655440001",
  "userId": "user-example",
  "phoneNumber": "01000000000",
  "resourceType": "user_journey",
  "userJourneyId": "journey-example",
  "userJourneyNodeId": "node-example",
  "sessionId": "session-example",
  "eventName": "send_success",
  "timestamp": 1789106667000,
  "channelType": "text-message",
  "metadata": {
    "subtype": "lms",
    "isFailover": true
  }
}
```

> [accordion] 複数の送信元番号を登録できますか？
>
> はい。1つのプロジェクトに複数の送信元番号を登録できます。番号を追加するたびに、必要書類を提出してください。

> [accordion] 他社で発行した配信停止用の080番号を使えますか？
>
> 他社で発行した080番号もNotiflyで使用できます。以下の点に注意してください。
>
> * 広告目的のテキストメッセージとその代替配信では、外部の配信停止リストは自動で適用されません。カスタムユーザー属性を使い、配信対象を絞り込んでください。
> * メッセージ本文に韓国語の広告表記 `(광고)` と配信停止用の080番号を記載してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.