KakaoTalk渠道推送
本文介绍如何在 AE 中连接 Infobip、创建 KakaoTalk Brand Message 通道，并完成测试发送、正式推送和结果排查。
发送时段：KakaoTalk 消息仅在北京时间 07:00（含）至 19:00（不含）发送，对应韩国时间 08:00（含）至 20:00（不含）。请将任务触发时间安排在该时段内。
1. 功能概览
KakaoTalk 渠道通过 Infobip 向符合营销授权条件的韩国用户发送 Brand Message。完整链路包括：配置 Infobip 授权、创建并启用通道、选择目标受众范围、编辑并测试消息、正式推送，以及查看送达和点击结果。
通道支持消息预览、测试发送以及系统触达漏斗。开启触达漏斗后，系统会自动记录计划推送、实际推送、推送成功、实际到达和点击推送五个步骤，无需手工创建触达事件。
2. 接入前准备
开始配置前，请确认 Infobip 侧和 AE 用户数据已准备完成，并确保当前账号具有查看、编辑运营通道的权限。
| 准备项 | 要求 |
|---|---|
| Infobip 账号 | 账号已开通 KakaoTalk Brand Message 能力，并具备发送权限。 |
| 连接信息 | 准备有效的 HTTPS API Base URL 和 API Key。API Key 属于敏感凭证，仅在应用授权弹窗中填写。 |
| KakaoTalk Sender | Sender 已在 Infobip 中配置并可用于 Brand Message。创建通道时需要填写该 Sender。 |
| 手机号属性 | AE 中已存在用于保存韩国手机号的用户属性，属性类型为字符串或数值。 实际发送号码应为 +82 加 10 位号码，例如 +821012345678。 |
| 营销授权 | 接收人已满足业务所需的营销同意条件，并可按频道好友、非频道好友或全部已同意营销用户进行选择。 |
Kakao 与 Infobip 侧检查：用于发送 Brand Message 的 KakaoTalk 账号应完成 Business Channel 认证；频道名称、头像等信息应与提交的企业资料一致，并在 KakaoTalk Channel Manager 中补全客户中心联系方式。还需确认 Infobip 已关联该频道及 Sender，API Key 包含所需的 KakaoTalk API 权限且未过期。实际配置以 KakaoTalk 与 Infobip 控制台为准。
前往您的 Infobip 控制面板，然后收集以下信息。
API keys和base URL
- 在 Infobip 门户中，选择“开发者工具” > “API 密钥”。
- 在API keys页面上，复制API base URL。
- 选择“创建 API 密钥”。
- 输入名称，选择到期日期，然后选择 KakaoTalk 所需的 API 权限范围。这些权限范围控制您的密钥可以执行哪些 Infobip API 操作。
- 在channel中选择KakaoTalk，点击“申请Sender”
3. 配置 Infobip 应用授权
- 进入运营 > 运营设置 > 通道设置 > 三方平台。
- 展开KakaoTalk - Brand Message，在应用授权区域单击添加应用。
- 填写授权名称、API Base URL 和 API Key。
- 单击连接并保存。连接成功后，该授权可用于创建 KakaoTalk 通道。
- 在应用授权弹窗中配置 Infobip 连接信息，如下图所示。
| 字段 | 填写说明 |
|---|---|
| 授权名称 | 填写便于团队识别的名称，建议包含业务或环境信息。 |
| Provider | 固定为 Infobip，无需修改。 |
| API Base URL | 在 Infobip Portal 的 Developer Tools > API Keys 页面复制 API Base URL；填写完整的 HTTPS 服务地址。 |
| API Key | 在 Infobip Portal 的 Developer Tools > API Keys 页面创建或复制密钥。创建时设置便于识别的名称、合理的过期时间，并授予 KakaoTalk 所需 API 权限。编辑已有授权时，如不更换密钥，可保留原密钥。 |
- 保存时，系统会主动连接 Infobip 校验凭证。
- API Key 会加密保存，后续页面不会回显；编辑已有授权时留空即可沿用原密钥。
- 授权名称在当前项目内不可重复。
- 连接失败时，请依次检查 Base URL 是否为有效的 HTTPS 地址、API Key 是否正确且未过期、账号是否具有 KakaoTalk 权限，以及当前网络能否访问 Infobip。已被通道引用的授权不能直接删除，应先处理关联通道。
4. 创建并启用 KakaoTalk 通道
- 在KakaoTalk - Brand Message区域单击新建通道。
- 填写通道名称，选择连接正常的授权应用，填写 KakaoTalk Sender，并选择手机号属性。
- 按需开启触达漏斗设置，然后单击创建通道。
- 返回通道列表并启用该通道。启用时系统会再次校验授权、Sender 和手机号属性。
新建通道时需要完成以下配置，如下图所示。
| 字段 | 填写说明 |
|---|---|
| 通道名称 | 项目内用于识别该通道的名称。 |
| 选择授权应用 | 仅选择状态正常、已连接成功的 Infobip 授权。 |
| KakaoTalk Sender | 在 Infobip Portal 的 Channels and Numbers > Channels > Senders 中确认并填写已启用的 Sender。同一项目下，同一授权不能重复使用相同 Sender 创建多个通道。 |
| 手机号属性 | 选择保存韩国手机号的字符串或数值型用户属性。 |
| 触达漏斗设置 | 开启后，系统自动记录五个固定触达步骤。系统步骤不可修改。 |
启用中的通道不能直接修改配置。如需调整授权、Sender、手机号属性或触达漏斗，请先停用通道，完成修改后再重新启用。
5. 编辑消息并发送测试
- 在通道列表的操作列单击发送测试。
- 输入测试手机号，并选择目标受众范围：频道好友、非频道好友或全部已同意营销用户。
- 选择一种消息类型，填写正文、图片、按钮、商品、优惠券或视频等页面要求的内容。
- 在右侧消息预览中检查展示效果，确认无误后单击确认发送。
测试发送页集中展示受众范围、八种消息类型、内容编辑区和客户端预览，如下图所示。
目标受众范围说明
目标受众范围为必选项，用于声明 Kakao 允许触达的用户类型。它不会替代 AE 中的目标人群筛选；接收人需要同时满足任务人群条件和 Kakao 的受众授权条件。
| 目标受众范围 | 可触达用户 | 选择建议 |
|---|---|---|
| 频道好友 | 已将当前 KakaoTalk 频道添加为好友，并满足 Kakao 相应授权条件的用户。 | 默认值，适合仅面向已关注频道的用户发送。该范围不支持“添加频道”按钮。 |
| 非频道好友 | 未将当前频道添加为好友，但已通过 Kakao 订阅或同意接收营销消息的用户。 | 适合触达尚未关注频道的合规受众；可使用“添加频道”按钮引导用户关注。 |
| 全部已同意营销用户 | 同时覆盖符合条件的频道好友和非频道好友，即已具备相应营销授权的最大可触达范围。 | 适合以合规前提下的覆盖面为优先目标；可使用“添加频道”按钮。 |
Kakao 会在投递时校验接收人是否符合所选范围；不符合条件的用户不会收到消息。因此，测试和正式发送应选择与实际营销授权一致的范围。
| 消息类型 | 代码 | 主要内容限制 | 按钮与补充规则 |
|---|---|---|---|
| 文本型 | FT | 正文必填，最多 1300 字、99 次换行。 | 最多 5 个按钮；使用优惠券时最多 4 个。按钮名称最多 14 字。 |
| 图片型 | FI | 图片和正文必填；正文最多 1300 字、99 次换行。 | 按钮与优惠券限制同文本型；图片链接须为 HTTP/HTTPS 地址。 |
| 宽幅图片型 | FW | 图片和正文必填；正文最多 76 字、5 次换行。 | 最多 2 个按钮，按钮名称最多 8 字；“添加频道”按钮放在末位。 |
| 项目列表型 | FL | 标题最多 20 字且不可换行；包含 3～4 个条目。 | 最多 2 个按钮，按钮名称最多 8 字；“添加频道”按钮放在末位。 |
| 轮播信息流型 | FC | 包含 2～6 张内容卡片；每张卡片须配置图片和文案。 | 每张卡片 1～2 个按钮；整组最多 1 张优惠券、1 个“添加频道”按钮。 |
| 电商型 | FM | 商品和图片必填；商品标题最多 30 字，价格为 0～99999999 的整数。 | 1～2 个按钮，按钮名称最多 8 字；“添加频道”按钮放在末位。 |
| 轮播电商型 | FA | 最多 6 张商品卡片；无头卡时至少 2 张，有头卡时至少 1 张。 | 每张卡片 1～2 个按钮；整组最多 1 张优惠券、1 个“添加频道”按钮。 |
| 高级视频型 | FP | 视频必填且仅支持 tv.kakao.com 地址；正文最多 76 字、5 次换行。 | 最多 1 个按钮，按钮名称最多 8 字。 |
通用规则：当前仅支持 URL 和“添加频道”两类按钮。URL 按钮必须填写移动端链接，PC 端链接可选；图片和链接须使用可访问的 HTTP/HTTPS 地址。
“添加频道”按钮不支持“频道好友”受众，且在不同消息类型中的位置要求不同。消息类型的完整必填项和长度限制以页面实时校验为准。正式任务中可插入用户属性，实现按接收人动态替换内容。
图片素材建议：优先使用 JPEG 或 PNG，建议宽度不低于 500 px，并在不影响清晰度的前提下控制文件大小；常见支持比例为 2:1、16:10、3:2、4:3、1:1 或 3:4。
发布前应确认 URL 可公开访问、无需登录、不会过期，并通过测试发送检查最终裁切和展示效果。
测试手机号请按页面格式输入，目前支持如下三种形式输入：
01012345678
010 1234 5678
010-1234-5678
系统会在发送时自动转换为符合韩国 E.164 格式，例如 +821012345678。
系统只有在 Infobip 返回终端送达结果后才提示测试成功；请求已受理但 30 秒内仍未获得送达结果时，会提示继续等待或稍后排查。
6. 正式推送与结果排查
创建运营任务或流程时，选择已启用的 KakaoTalk 通道，设置目标人群、目标受众范围和消息内容，并在允许发送的时段内发布。系统会按用户属性替换动态内容；同一任务中的不同用户可能得到不同的最终文案。
结果口径：Infobip 接受请求只表示消息已进入服务商处理，不等于用户已经收到。
开启触达漏斗后，可按计划推送、实际推送、推送成功、实际到达和点击推送查看结果；其中“实际到达”以 Infobip 返回终端送达为准，“点击推送”以点击回调为准。
| 现象 | 排查方法 |
|---|---|
| 授权不可选或连接失败 | 检查 Base URL 是否为完整的 HTTPS 地址、API Key 是否有效、账号是否具有 KakaoTalk 权限，以及当前网络能否访问 Infobip。403 通常表示权限不足，401 通常表示密钥无效。 |
| 通道无法启用 | 确认授权连接正常、Sender 有效且未在同一授权下重复使用，并确认手机号属性为字符串或数值类型。 |
| 手机号格式错误 | 确认最终号码为 +82 加 10 位数字，例如 +821012345678；去除空格、短横线和其他符号，国家码后的首位不能为 0。 |
| 消息未在计划时间发送 | 确认触发时间位于北京时间 07:00（含）至 19:00（不含）。系统会在提交发送前再次检查，超出时段不会向 Infobip 发起请求。 |
| 内容校验失败或被拒绝 | 根据页面提示检查必填项、文字长度、图片或卡片数量、按钮顺序和链接。当前仅支持 URL 与“添加频道”两类按钮；URL 按钮必须填写移动端链接。 |
| 请求已受理但测试未成功 | 测试发送只有收到终端送达结果才算成功。系统最多等待 30 秒；若仍为处理中，请在 Infobip 检查号码状态、内容审核、账号额度和服务状态。 |
| 显示投递失败 | 查看 Infobip 返回的拒绝、不可送达或过期原因，重点核对目标受众范围、营销授权、Sender、号码状态和消息内容。 |
| 服务限流或临时异常 | 稍后重新发送。系统不会自动重试 Infobip 发送请求；若持续失败，请结合返回信息联系平台管理员或 Infobip 支持。 |
发布前检查：确认通道已启用、目标人群满足营销授权、手机号属性可用、消息预览正确、链接可访问，并将触发时间安排在允许发送的时段内。