> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/zh/marketing/smart-message.md).

# 智能发送

### 什么是智能发送

智能发送是会同时考虑发送对象（细分群组）和发送时点，并自动优化的推送·通知发送工具。它不只是简单的一次性发送，而是由 AI 预测下面两项，自动运营活动。

* 服务高参与用户：利用所设置细分群组的 pCTR（预测点击率）来预测服务高参与用户。
* 高点击可能发送时间：利用用户行为模式，预测更容易产生点击的时间段。

#### 工作方式

**1）测试发送**

这不是合作方的测试，而是为了 AI 学习在内部进行的自动发送。

* 基于 pCTR 预测服务高参与用户。
* 根据预测结果探索最优用户和发送时点。
* 测试发送最长可进行 7 天。
* 满足点击 25 次或发送 2,500 次中的任一条件后，正式发送就会立即开始。

**2）正式发送**

会根据测试结果自动优化活动并发送。

#### 推送和通知的概念

* 推送：即使没有打开 App 也能收到的操作系统（OS）通知。会同时显示 App 名称和 logo。
* 通知：是点击 Toss App 右上角铃铛图标后可以查看的 App 内消息。

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FyL7gYaNc3oBWxYwBlK80%2Fimage.png?alt=media&#x26;token=cdc5c74c-6bf1-43be-af7a-819c360f57d1" alt=""><figcaption></figcaption></figure>

#### 消息类型

可根据消息内容选择发送广告性消息或功能性消息。

* **广告性消息：** 这是用于折扣、活动、新品介绍等营销目的的消息。
* **功能性消息：** 这是用于传达订单、支付、配送、帖子发布等服务使用过程中产生的必要信息的消息。

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FcpHX5nMpjuRogLzdWFVV%2Fimage.png?alt=media&#x26;token=eea3a942-0de4-471f-8d2c-f0f83ee68260" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
如果包含促销购买、引导使用服务、优惠介绍、留存等营销目的内容，就不能以功能性发送。&#x20;

如果在为消息文案发愁 [UX 写作文档](https://developers-apps-in-toss.toss.im/design/consumer-ux-guide#ux)以及下面的消息撰写指南，请参考。
{% endhint %}

***

### 智能发送的优点

* 可以自动向用户传递他们真正需要的消息。
* 从功能性通知到营销消息，都可以按目的灵活使用。
* 即使用户没有打开迷你应用，也能让他们不错过重要信息。
* 通过合适时机的消息，可以自然地衔接服务使用流程。
* 可以根据发送结果持续优化消息内容。

#### 请务必参考

* 要发送推送·通知，需要审核消息模板文案。（广告性消息会自动审核。）
* 填写推送内容后，会自动反映到通知消息中。
* 每个工作区（商户）最多可发送 10 万条。
* 如果功能性消息中包含引导使用服务、优惠介绍、留存等广告目的内容，就必须作为广告性消息发送。
* 要发送功能性消息，必须事先获得用户同意接收该用途通知。
* 建议提供让用户取消通知接收的功能，并清楚说明取消方法。

<details>

<summary>Toss App → 全部标签页 → 设置按钮 → 通知 → 各服务通知中，可直接控制是否接收通知。</summary>

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FeR5t52wqNrftZBu4DHj7%2Fimage.png?alt=media&#x26;token=d8668c28-2385-4e27-a0b0-cc9d845c935c" alt=""><figcaption></figcaption></figure>

</details>

***

### 在控制台中设置

访问方法：App in Toss 控制台 → 选择工作区 → 选择迷你应用 → 左侧菜单选择“智能发送”

#### 1. 广告性活动

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2F0UStKoLELQWf1dLL4AZR%2Fimage.png?alt=media&#x26;token=36115944-da3c-49cd-a8d3-716f7a40c203" alt=""><figcaption></figcaption></figure>

广告性活动由两种目标分组构成。

* 引导新用户进入：引导尚未使用过迷你应用的用户首次进入。默认对象是所有尚未使用过迷你应用的用户。若要进一步缩小对象，可添加条件。
* 引导回访：引导近期使用减少的用户再次访问。默认对象是所有近期使用减少的用户。若要进一步缩小对象，可添加条件。

**素材**

* 每个分组最多可登记 2 个素材（A 方案、B 方案）。
* 广告性活动不能使用动态变量（例如： `#{姓名}`, `#{金额}`这类在发送时替换的值）。
* 详细撰写方法请参考消息撰写指南。

**点击时跳转的页面 URL**

* 请输入点击推送或通知后要跳转的 URL。
* 同一个活动中不能为不同素材设置不同 URL。若要使用不同 URL，需要新建活动。
* 请务必确认实际可以正常访问。

**发送时点**

请选择开始发送的时间点。

* 注册后立即发送：审核通过后会立刻开始发送。
* 设置发送期间：指定开始日和结束日。若要在没有结束日的情况下持续发送，可选择“无结束日”。

**发送对象**

可在默认对象基础上添加条件，调整发送范围。

* 包含用户：向满足所设全部条件的用户发送。
* 排除用户：将满足所设全部条件的用户排除在发送对象之外。
* **不过，若是引导回访发送，则发发送开始日前 30 天内的用户必须达到 100 人以上才能发送。**

#### 2. 功能性活动

功能性活动是用于传达服务使用所直接需要信息的消息。必须是收件人请求的信息，或是为履行服务所必需的消息。如果包含引导使用服务、优惠介绍、留存等广告目的内容，就必须作为广告性活动发送。

<details>

<summary>允许的示例</summary>

* 支付完成、退款、积分到账等交易相关消息
* 配送开始、配送完成、预约确认等服务进度消息
* 定期扣费即将发生、服务即将到期等使用期限·状态通知

</details>

<details>

<summary><mark style="color:$danger;">不允许的示例</mark></summary>

* “这类商品怎么样？”、“今天限时折扣。”——促销·广告目的
* “面向以前购买用户的推荐商品”——附加营销信息
* “参与活动领取优惠吧。”——活动宣传类消息

</details>

**2-1. 直接通过 API 发送**

可以在合作方服务器上于想要的时间点发送。

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2Fk7om6S42RmDrgXYPQD4M%2Fimage.png?alt=media&#x26;token=0cda12d0-d35e-4ebb-94bb-c2f09af72cd2" alt=""><figcaption></figcaption></figure>

可以在合作方服务器上于想要的时间点发送。发送 API 的详细规格可在“功能性消息发送”文档中查看。

* 活动标题：请起一个能让人一眼看出该活动用途的标题。
* 标题：请写在 7 个字以内（含空格），并使用名词形式。若写成“\~하기”形式，可能会被误解为引导用户行动的用途。
* 内容：请写在 25 个字以内（含空格），并使用“\~요.”语气。变量按 2 个字计算。通过 API 发送时，变量需要自行开发。
* 跳转 URL：请设置点击推送或通知后要跳转的页面。请务必确认可访问。
* 通知同意文案：如果在文案审核中被判定需要通知同意文案并被驳回，请务必先补充通知同意文案后再申请复审。

**2-2. 请求 Toss 发送**

可选择一次性发送或定期发送。

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FPeKBN4f5ZWaW1WjVxkqG%2Fimage.png?alt=media&#x26;token=6c2fbb20-8879-42ba-8a42-533443d39684" alt=""><figcaption></figcaption></figure>

无需服务器也可以选择一次性发送或定期发送。

* 活动标题：请起一个能让人一眼看出该活动用途的标题。
* 标题：请写在 7 个字以内（含空格），并使用名词形式。
* 内容：请写在 25 个字以内（含空格），并使用“\~요.”语气。请求 Toss 代发时，只能使用姓名变量。变量按 2 个字计算。
* 跳转 URL：请设置点击推送或通知后要跳转的页面。请务必确认可访问。
* 通知同意文案：通过请求 Toss 代发时，必须提供通知同意文案。
* 发送类型：可在一次性发送和定期发送中选择。
  * 一次性发送：指定某个日期和时间，仅发送一次。
  * 定期发送：可设置重复发送周期。（每天：每天在指定时间发送 / 每周：选择想要的星期和时间发送）设置开始日和结束日，若选择“无结束日”，则会持续发送，直到手动停止。

**通知同意文案**

发送功能性消息时可能需要通知同意文案。通知同意文案是为了让用户在服务使用过程中同意接收通知而提供的说明文案。如果是向用户获取“将在某个特定时点接收通知”的同意，则必须使用通知同意文案。

<details>

<summary>需要通知同意文案的情况</summary>

申请补货通知、活动开始通知、价格变动通知、预约开启通知

</details>

<details>

<summary>不需要通知同意文案的情况</summary>

支付完成、配送开始、配送完成、退款完成、信息变更通知、条款变更通知

</details>

如果是需要通知同意文案的消息却没有登记同意文案，就无法保存功能性消息模板。

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FZiL8M4U1TrIslpw4RTU2%2Fimage.png?alt=media&#x26;token=8210c1a0-cccb-4b03-9880-895ab0992ba9" alt=""><figcaption></figcaption></figure>

**设置通知同意文案**

* 通知同意文案名称：请起一个能让人看出在迷你应用服务中会在什么场景使用该同意文案的名称。
* 通知发送时点：请写明同意后何时发送。
  * 通过 API 发送时：请写明何时发送。（例如：当收藏商品降价时、每天接收天气通知时、服务内被暂停的功能重新激活时等）
  * 请求 Toss 代发时：请连同发送时点一起清楚写明何时发送。（例如：每周二下午 5 点发送次日天气时等）

<details>

<summary>通知同意文案中包含的内容</summary>

* 服务名称和服务说明（会从迷你应用信息中自动带入）
* 通知发送时点（创建模板时输入的触发条件）
* 取消通知同意的路径
* 客服联系方式（会从迷你应用信息中自动带入）

</details>

**通知发送方法**

* 满足特定条件：请填写在什么条件满足时发送通知。（例如：收藏商品降价、被暂停的功能重新激活等）
* 固定星期和时间：请填写发送周期和类型。（例如：每日天气通知、签到提醒等）

若要在迷你应用中向用户展示通知接收同意 UI， [请参考通知同意文案请求文档](https://developers-apps-in-toss.toss.im/documentation/common/growth/smart-message#id-4.-requestnotificationagreement)。

{% hint style="info" %}
调用通知同意文案时的 templateCode

在迷你应用中调用通知同意文案时使用的 `templateCode`，是与该通知同意文案关联的功能性消息发送代码。可在控制台 → 智能发送 → “功能性”标签页中查看。
{% endhint %}

***

### 消息撰写指南

请以“这是向所有使用 Toss 的用户首次介绍我的 App”的心态来撰写。用户会在“Toss”这款金融 App 的语境下接收这条推送。请写得像 Toss 一样自然，并让人容易理解。

#### 基本规则

* 所有推送·通知都要用“\~요”语气写。正文请使用句子形式（“\~요.”），并在句末加句号。这是为了保持统一语气风格的规则。
* 句号只用于正文。标题中不要使用句号。
* 标题请写成“\~하기”或名词形式。（功能性请用名词形式。）
* 不能使用“토스 + 服务名”的写法。
* 字数限制为标题 7 字、正文 25 字以内（含空格）。这是即使将字体放大也不会被截断的标准。（在 Android 上，放大到 1.3 倍以上的大字号占整体的 24%。）
* 请务必检查拼写和空格。

#### 1）标题和内容要自然衔接。

<details>

<summary><mark style="color:$danger;">不好的</mark> 示例</summary>

* \[用辣炒年糕吗？] 在 Toss 上进行 MBTI 心理测试诊断。→ 标题是食物，内容却是 MBTI，无法对应
* \[负余额账户] 可用于公募股申购。→ 不清楚是要办账户，还是在通知申购消息。

</details>

<details>

<summary>好的示例</summary>

* \[拼图挑战] 在 Toss 上拼好拼图领取积分吧。
* \[签到礼物] 连续 3 天签到方块游戏，送 20 韩元。
* \[财运到达] 在 Toss 上免费查看运势吧。

</details>

#### 2）标题本身必须是完整的单词或句子。

<details>

<summary><mark style="color:$danger;">不好的</mark> 示例</summary>

* \[用句子卡] 在 Toss 上挑选 39 种卡片吧。
* \[比短视频更] 在 Toss 上挑选 39 种卡片吧。

</details>

<details>

<summary>好的示例</summary>

* \[句子卡] 在 Toss 上选择名言并挑选想要的设计。
* \[方块游戏] 来挑战这款让人忘记时间的游戏吧。

</details>

#### 3）如果是游戏服务，要明确写“游戏”。

用户在点击之前就应该知道这是游戏。只写服务名或游戏内术语，用户可能看不出来。

* <mark style="color:$danger;">不好的</mark> 示例：\[竞争拼图] 拼好拼图，还能装扮我的家。
* 好的示例：\[拼图游戏] 拼好拼图，还能装扮我的家。

#### 4）以下表达不能使用。

**只能看懂一部分的黑话·梗·流行语**

<details>

<summary><mark style="color:$danger;">不好的</mark> 示例</summary>

* \[徽章登场] 今天新上线了装备内容。
* \[运动休闲好店] 在 J.X.X 通过 Toss 付款可减 4,000 韩元。

</details>

<details>

<summary>好的示例</summary>

* \[新道具] 今天新出了一个游戏道具。
* \[J.X.X 优惠] 使用 Toss Pay 付款最高可减 4,000 韩元。

</details>

**特定人的名字**

* <mark style="color:$danger;">不好的</mark> 示例：\[我的理想型] 是张元英还是安宥真？
* 好的示例：\[理想型世界杯] 在 Toss 上挑选更接近你理想型的偶像吧。

**夸张的广告性表达**

* 广告性表达：马上就能！、超低价！、史无前例、紧急！、太爆了
* 制造不安：错过会后悔，现在不做就来不及了
* 过度符号：感叹号、emoji

**刺激性题材**

请避开政治、犯罪、死亡等敏感题材。

不要制造不安感。不要使用“错过会后悔”之类的语气，也不要使用让用户过度焦虑的词。请只平静地传达情况。

<details>

<summary><mark style="color:$danger;">不好的</mark> 示例</summary>

* \[外遇指数] 在 Toss 上当作娱乐测试一下吧。
* \[今日提示] 怀孕期间丈夫去世时，继承顺位会怎样？
* \[还没试过吗？] 即使预算总超支也没关系吗？
* \[有效期快结束了] 真的要错过优惠吗？

</details>

**省略空格**

为了凑字数，不要省略空格。

* <mark style="color:$danger;">不好的</mark> 示例：\[我的打字准确度是] 闭着眼睛打句子挑战一下吧
* 好的示例：\[我的打字水平] 在 Toss 上试试闭眼打句子的测试吧。

**别扭的表达**

虽然语法没错，但表达不自然。大声读出来就能很快发现。

* <mark style="color:$danger;">不好的</mark> 示例：\[属于我的小说] 也请试试选择其他类型。Toss 免费。→ 因为少了助词，所以显得别扭。读起来会像“使用 Toss 服务是免费的”。
* 好的示例：\[属于我的小说] 可以在 Toss 上免费制作。

#### 5）如果使用游戏类型，请参考以下内容。

* 不能使用由特定游戏名称衍生的类型。（例如：类 Rogue、类银河恶魔城、类魂系、类吸血鬼幸存者等）
* 请使用用户可以直观理解的类型名称。

| 类型            | 可                 |
| ------------- | ----------------- |
| **放置型 RPG**   | **放置型游戏或 RPG 游戏** |
| **休闲 MMORPG** | **休闲游戏**          |
| **开放世界动作**    | **动作游戏**          |
| **三消益智**      | **益智游戏**          |
| **回合制策略 RPG** | **策略游戏或 RPG 游戏**  |
| **2D 横版动作**   | **动作游戏**          |

<details>

<summary>不要组合或细分类型。</summary>

<table data-search="false"><thead><tr><th>类型</th><th>意思</th><th>替代方向</th></tr></thead><tbody><tr><td><strong>MMORPG</strong></td><td>Massively Multiplayer Online RPG</td><td><strong>RPG 游戏</strong></td></tr><tr><td><strong>ARPG</strong></td><td>Action RPG</td><td><strong>RPG 游戏或动作游戏</strong></td></tr><tr><td><strong>SRPG</strong></td><td>Simulation/Strategy RPG</td><td><strong>RPG 游戏或策略游戏</strong></td></tr><tr><td><strong>JRPG</strong></td><td>Japanese RPG</td><td><strong>日本 RPG 游戏</strong></td></tr><tr><td><strong>FPS</strong></td><td>First-Person Shooter</td><td><strong>射击游戏</strong></td></tr><tr><td><strong>TPS</strong></td><td>Third-Person Shooter</td><td><strong>射击游戏</strong></td></tr><tr><td><strong>MOBA</strong></td><td>Multiplayer Online Battle Arena</td><td><strong>策略游戏</strong></td></tr><tr><td><strong>RTS</strong></td><td>Real-Time Strategy</td><td><strong>策略游戏</strong></td></tr></tbody></table>

</details>

<details>

<summary>不能使用游戏相关专业术语。</summary>

<table data-search="false"><thead><tr><th>类型</th><th>意思</th><th>替代方向</th></tr></thead><tbody><tr><td><strong>Hack and Slash</strong></td><td>Hack and Slash</td><td><strong>动作游戏</strong></td></tr><tr><td><strong>Deck Building</strong></td><td>Deck Building</td><td><strong>卡牌游戏</strong></td></tr><tr><td><strong>Auto Battler</strong></td><td>Auto Battler</td><td><strong>策略游戏</strong></td></tr><tr><td><strong>Bullet Hell</strong></td><td>Bullet Hell</td><td><strong>射击游戏</strong></td></tr><tr><td><strong>Run and Gun</strong></td><td>Run and Gun</td><td><strong>动作游戏 &#x26; 体育游戏</strong></td></tr><tr><td><strong>Hyper Casual</strong></td><td>Hyper Casual</td><td><strong>休闲游戏</strong></td></tr><tr><td><strong>Sandbox</strong></td><td>Sandbox（游戏语境）</td><td><strong>模拟游戏</strong></td></tr></tbody></table>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers-apps-in-toss.toss.im/guide/zh/marketing/smart-message.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.