Marketo 集成 8x8 Connect 短信 API 指南
一、🔍 项目背景与目标
在营销自动化流程中，需要在用户完成特定行为（如填写表单、完成注册）后，自动发送一条短信进行提醒、欢迎或验证。
Marketo 原生不具备短信发送能力，但支持通过 Webhook 集成第三方 API 实现此功能。
本项目选择使用 8x8 Connect 的 Send SMS API，将短信发送能力嵌入 Marketo 自动化流程中。
二、📌 使用场景
-
用户提交表单后发送欢迎短信
-
注册失败后发送提醒短信
-
营销活动触发通知短信（如优惠券、限时促销）
-
多语言短信发送（根据语言字段分支）
三、✅ 推荐 API 方案：使用 Send SMS（单条）API
| 接口 | 地址 |
|---|---|
| Send SMS | POST https://sms.8x8.com/api/v1/subaccounts/{subAccountId}/messages |
🔸 为什么选这个接口？
| 特点 | 描述 |
|---|---|
| ✅ 单条请求 | 每次调用只对应一个用户（适配 Marketo 的单人触发模型） |
| ✅ 支持 Token | 可动态插入用户名、手机号等个性化内容 |
| ✅ 接口简单 | JSON 格式，Webhook 兼容性好 |
| ❌ 批量 API 不适合 | Marketo 无法打包群体数据发起批量请求 |
四、🛠 配置步骤（Step by Step）
✅ 步骤 1：准备 8x8 Connect API 参数
| 参数 | 示例 | 来源 |
|---|---|---|
| subAccountId | 1234567890 | 登录 8x8 后台获取 |
| Bearer Token | eyJxxxxx... | 由 8x8 平台生成的 JWT 令牌 |
| API Endpoint | https://sms.8x8.com/api/v1/subaccounts/{subAccountId}/messages | |
| Sender Name | ULTIMAMKT | 可配置（或使用平台分配号码） |
✅ 步骤 2：在 Marketo 创建 Webhook
-
打开 Marketo → Admin → Webhooks → 点击 “New Webhook”
-
填写如下配置：
基础信息：
| 字段 | 值 |
|---|---|
| Webhook Name | Send_SMS_via_8x8 |
| URL | https://sms.8x8.com/api/v1/subaccounts/1234567890/messages |
| Request Type | POST |
| Request Token Encoding | JSON |
| Response Type | JSON |
✅ 步骤 3：编写 Request Template（JSON 请求体）
{"destination": "{{lead.PhoneNumber}}","country": "GB","encoding": "AUTO","track": "None","message": "Hi {{lead.FirstName}}, welcome to our UK program!"
}
-
destination: 国际手机号，建议确保+44xxxxxx格式 -
country: 使用 ISO 国家代码（如GB,FR,ES） -
message: 可使用 Marketo Token 自定义内容
✅ 步骤 4：添加 HTTP Header（认证）
点击 Webhook 左侧 “Custom Header”，添加：
| Header | Value |
|---|---|
| Authorization | Bearer YOUR_TOKEN |
| Content-Type | application/json |
✅ 步骤 5：在 Smart Campaign 中使用 Webhook
-
创建 Smart Campaign（例如：填写表单后发送短信）
-
Smart List：设置触发条件，如 Fills Out Form、Data Value Changes
-
Flow：
-
Step 1:
Call Webhook→ 选择Send_SMS_via_8x8
-
-
Schedule：激活并测试
五、✅ 注意事项与建议
| 项目 | 建议 |
|---|---|
| 📱 手机号格式 | 推荐使用国际格式（如 +44、+34） |
| 📏 短信长度 | 建议控制在 160 字符以内，避免分段计费 |
| 🗣 多语言支持 | Smart Campaign 中按 Language 字段设置 Flow 分支 |
| 🔁 避免重复发送 | 可加 Constraint 或自定义字段判断是否已发送过 |
| 📄 记录发送历史 | 可用 Interesting Moment 或 Last SMS Sent Date 字段记录 |
六、📋 示例回顾
✅ Webhook URL：
https://sms.8x8.com/api/v1/subaccounts/1234567890/messages✅ Headers：
Authorization: Bearer eyJhbGciOiJIUz...
Content-Type: application/json
✅ Payload：
{"destination": "{{lead.PhoneNumber}}","country": "GB","encoding": "AUTO","track": "None","message": "Hi {{lead.FirstName}}, welcome!"
}
七、📈 后续可扩展方向
| 模块 | 描述 |
|---|---|
| ✅ 多语言版本短信 | 每种语言建一个 Webhook，Smart Campaign 条件分支判断调用 |
| ✅ A/B 测试短信内容 | 配置多个 Webhook，分别测试内容差异 |
| ✅ 发送失败处理 | 使用 8x8 回执 API + Marketo字段记录发送状态 |
| ✅ 归档发送历史 | 记录发送时间、发送状态字段，配合报表查看 |
✅ 总结
通过 Webhook，Marketo 可与 8x8 Connect 的 SMS API 高效集成，实现行为触发式短信通知、营销消息发送，并支持 Token 动态内容、多语言分支等自动化能力。Send SMS 单条 API 是最适合 Marketo 的短信发送方式，配置简单、执行高效、易于追踪和扩展。