> ## 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.

# Send text messages with Notifly

> Register a sender number and send text messages through Notifly in South Korea.

This guide covers SMS, LMS, and MMS sent to recipients in South Korea. Contact Notifly before setting up text messaging for another country or region.

## 1. Register a sender number

> [!NOTE]
>
> South Korean carriers require you to register your sender number before you send text messages as part of their spam prevention policy. The registration system is based on Article 84-2 of the Telecommunications Business Act, which addresses false caller ID and user protection.

### 1-1. Prepare the required documents

#### 1. Telecom service subscription certificate

> [!NOTE]
>
> The certificate confirms who is registered to use the phone number. Call your carrier to request it.

> [!NOTE]
>
> | Carrier | Document name | Contact |
> | - | - | - |
> | KT customer center | Proof of subscription (가입증명원) | 1588-0114 |
> | LG U+ | Confirmation of subscription (가입사실 확인서) | 1544-0001 |
> | SKT | Proof of service agreement (이용계약증명서) | 080-8282-123 |
> | Sejong Telecom | | 1699-1000 |
> | Korea Cable Telecom (KCT) | | 070-8188-0114 |
> | Hello Mobile on KT | | 1855-1144 |
> | Hello Mobile on SKT | | 070-8188-0114 |

> [!WARNING]
>
> 1. The certificate must list **the business or its representative** as the subscriber.
> 2. The certificate must be unredacted and must have been issued **within the past three months**.

#### 2. Authorization to use the phone number

* [Download the authorization form from 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) and fill in the required information.
* Enter `주식회사 그레이박스` as the account holder in the `계정 명의자 정보` field.

#### 3. Business registration certificate

### 1-2. Register the sender number in Notifly

1. Sign in to Notifly and verify your phone number if needed. Open **Settings > Channel Settings > Text Message (SMS, LMS, MMS)**. To register your first sender number, click **Register**. If you already have a registered number, click the plus icon next to the sending platform.

   ![Register button in the text message channel settings](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/text-message/text-message-register.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=47c28f165abc3a618ee3827d7b55c28b)
2. Select **Notifly** as the platform. Open **Personal Information Processing Consignment Contract (Required)** and complete the form.
3. Attach the documents from section 1-1 as PDFs. Also attach a **Certificate of Employment**, which is required by the form. Click **Save** to submit.

![Sender number registration form](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/text-message/register-notifly-platform-for-text-message.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=6dd986d6a9d682f1239e4929a4ce54de)

## 2. Send a test text message

When creating a campaign, send a test text to check that you can send messages with your registered number.

* Text messages don't support emoji. See [Text message format FAQ](https://docs.notifly.tech/en/user-guide/faq.md#1-message-formats).
* If the carrier flags a message as spam, check the carrier's spam service. The message might not appear in the phone's spam folder. See [Spam blocking by carrier (Korean)](https://www.smsko.co.kr/info_law/law_spamx.html).

## 3. Set up an 080 opt-out number (optional)

For advertising text messages in South Korea, obtain the consent required by law. Start the message with `(광고)`, identify the sender, and give recipients a free way to opt out. See the [KISA guide to South Korea's anti-spam rules](https://spam.kisa.or.kr/spam/na/ntt/selectNttInfo.do?bbsId=1002\&mi=1020\&nttSn=3001). To request an 080 opt-out number, email [contact@notifly.tech](mailto:contact@notifly.tech) or use your dedicated Slack channel.

* Confirm the current monthly fee for each 080 number before you request one.
* Allow three to four business days to get your 080 number.
* Notifly applies the 080 opt-out list to text messages with **Is Advertising Message** turned on.
  * Confirm which Kakao fallback sends use the 080 list for your project.
* You can also manage the 080 opt-out list through the API. See [List, add, and remove opt-out recipients](https://docs.notifly.tech/en/api-reference/list-080-block-recipients.md).
  * You can receive a webhook when a number is added to the opt-out list.

    ![Webhook settings for new entries on the 080 opt-out list](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/text-message/080-webhook.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=485bc533612544f1288267421c5c07fc)

## 4. Track text message link clicks

Text messages don't report link clicks by default. Use the **Tracking Link** add-on to count clicks.

> [!TIP]
>
> Check the current rate per click for your project before using tracking links.

> [!NOTE]
>
> Tracking links are available for LMS and MMS only.

> [!WARNING]
>
> Tracking links are unavailable in user journeys.

> [!WARNING]
>
> **Send Test** does not support tracking links. To test a tracking link, create a separate scheduled or event-triggered campaign. Under **Delivery Target**, select **User Group Settings** and turn on **Test Mode**.
>
> In **Test Recipients List**, enter the external user IDs of internal testers (the **User ID** in the user list), one per line. Before running the campaign, check that the list contains at least one tester and includes only those testers. Each tester must also meet the campaign's audience conditions.
>
> To test only the message, use a message or template without a tracking link.

### Set up a tracking link

1. Create a campaign and set the send timing and audience. In **Message and Action**, select **Tracking Link**.
2. Enter the destination URL.
3. Click **링크 추가** (Add link) to insert the generated link in your message.
4. Leave the generated link unchanged. Notifly sends the shortened tracking URL in place of the destination URL.

## 5. Receive delivery results through a webhook

Notifly can send your server delivery results for SMS, LMS, and MMS that it sends through NHN. For each reported campaign or user journey event, the webhook sends one JSON payload per message. It reports whether Notifly sent or skipped the message, or whether the send failed. It doesn't report whether the recipient read it.

The webhook also reports results when Notifly sends a text after a direct Kakao integration fails to send a message. It covers only texts sent through Notifly, including these fallbacks. The 080 opt-out registration webhook is separate.

### Set up the webhook

1. Prepare a publicly reachable HTTPS endpoint that accepts a `POST` request with a JSON body.
2. Open **Settings > Channel Settings > Text Message (SMS, LMS, MMS)**. If **Text message delivery result webhook URL** is available, enter the endpoint URL and save it.
3. If the field isn't available, send your project ID and endpoint URL to your dedicated Slack channel or [customer support](mailto:contact@notifly.tech).

The following example shows the project's `text_message_delivery_result_webhook` configuration. The public API doesn't accept it as a request body.

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

The payload can include user IDs and phone numbers. Use HTTPS in production. Notifly sends results only when a webhook URL is configured. To remove the webhook, save an empty URL in the console or contact your integration team. Cached settings can take time to update.

### Events

| `eventName` | When the event occurs |
| - | - |
| `send_success` | Notifly's result processing or a provider callback confirms that the send succeeded. |
| `send_failure` | The send request is definitively rejected, delivery fails, or the send policy check fails. |
| `skipped__fatigue_management` | A fatigue management limit prevents a send in an event-triggered campaign. |
| `skipped__excluded_user_filter` | The recipient matches an exclusion condition in an event-triggered campaign. |
| `skipped__global_frequency_limit_filter` | The global sending frequency limit skips the send. |
| `skipped__campaign_delivery_stopped` | Delivery has been stopped for a one-time scheduled campaign. |
| `skipped__forbidden_timing_filter` | The restricted sending hours policy skips the send. |
| `skipped__forbidden_timing_requeue_failed` | Notifly tries to reschedule the message for after restricted hours but can't save the new schedule. |

Notifly doesn't report `pending` or `requeued__forbidden_timing` (successful rescheduling). If rescheduling fails, it reports `skipped__forbidden_timing_requeue_failed`.

The webhook also leaves out results that lack a message ID or the campaign or user journey identifiers. It therefore reports only some internal errors and exclusions.

When the failure reason is available, Notifly includes it in `failureReason`.

### Request body schema

| Field | Type | Required | Description |
| - | - | - | - |
| `version` | string | Yes | Schema version. The current version is `"1.0"`. |
| `projectId` | string | Yes | Notifly project ID. |
| `messageId` | string | Yes | ID of the text message associated with the result. |
| `userId` | string or null | Yes | User ID in your service, or `null` if unavailable. |
| `phoneNumber` | string or null | Yes | Recipient's phone number, or `null` if unavailable. |
| `resourceType` | string | Yes | `"campaign"` or `"user_journey"`. |
| `campaignId` | string | Required for campaigns | Campaign ID. Omitted for user journeys. |
| `userJourneyId` | string | Required for user journeys | User journey ID. Omitted for campaigns. |
| `userJourneyNodeId` | string | No | User journey node ID, if available. |
| `sessionId` | string | No | Execution session ID, if available. |
| `eventName` | string | Yes | See the event table above. |
| `failureReason` | string | No | Failure reason, if available. |
| `timestamp` | number | Yes | Unix timestamp in milliseconds when Notifly processed the result. If that time is unavailable, the field uses the time Notifly created the webhook payload. |
| `channelType` | string | Yes | `"text-message"`. |
| `metadata` | object | Yes | Text message subtype and fallback indicator. |
| `metadata.subtype` | string | Yes | `"sms"`, `"lms"`, or `"mms"`. |
| `metadata.isFailover` | boolean | Yes | `false` for standard texts and `true` for supported Kakao fallback texts. |

The payload doesn't include the message body.

### Example: Successful text message send in a campaign

```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
  }
}
```

### Example: Successful fallback text send in a user journey

Notifly sends separate channel results for the Kakao message and the fallback text. Use `channelType` and `metadata.isFailover` to identify the fallback result.

```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] Can I register multiple sender numbers?
>
> Yes. Submit the [required documents](#1-1-prepare-the-required-documents) for each sender number you add to the project.

> [accordion] Can I use an 080 opt-out number from another provider?
>
> You can use an externally issued 080 opt-out number in Notifly under the following conditions.
>
> * Notifly doesn't automatically apply an external opt-out list when sending promotional texts, including fallbacks. Use a custom user property to filter recipients yourself.
> * Add the Korean advertising label `(광고)` and your 080 opt-out number to the message.


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