快速入门

在五分钟内发送第一条 MorisBox 消息。

1. 获取 API 密钥

MorisBox 沙盒访问权限按合作伙伴授予。您的组织启用后：

登录合作伙伴中心 → https://partner.morisbox.com
打开设置 → API 密钥
创建具有 send 权限范围的密钥（更广泛的集成可使用 full）
一次性复制密钥，因为它仅在创建时显示

切勿将 API 密钥提交到代码仓库。应优先使用环境变量，并且绝不能在不同组织之间共享密钥。

2. 基础 URL

沙盒（合作伙伴集成）：

https://api.morisbox.com/api/v1

3. 发送文本消息

将 $SEED360_API_KEY 替换为合作伙伴中心提供的密钥。

export SEED360_API_BASE="https://api.morisbox.com/api/v1"
export SEED360_API_KEY="sk_…"   # partner key

curl -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "body": "Bienvenue sur MorisBox",
    "priority": "notification"
  }'

请使用已关联到您的合作伙伴组织，或即将关联的真实 E.164 最终用户手机号码。

成功响应

{
  "message_id": 123,
  "ref": "a1b2c3…",
  "phone": "+228XXXXXXXX",
  "content_type": "text",
  "body": "Bienvenue sur MorisBox",
  "state": "delivered"
}

消息会显示在用户客户端应用中的对应合作伙伴下（中心 / 收件箱）。除非使用对话 API，否则它不会变成支持对话。

4. 发送图片

curl -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "content_type": "image",
    "body": "Photo de l’agence",
    "media_url": "https://example.com/photo.jpg",
    "media_filename": "agence.jpg"
  }'

5. 发送 HTML 新闻简报

curl -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "content_type": "html",
    "subject": "Infos · Juillet",
    "html": "<h1>Bonjour</h1><p>Votre newsletter…</p>"
  }'

在移动端，用户可直接从中心列表打开完整新闻简报。

6. 后续阅读

主题	链接
身份验证与权限范围	身份验证
所有内容类型	媒体与内容类型
交互式表单	流程
沙盒主机	沙盒与正式环境
不是合作伙伴？	开发者账户（仅限已批准模板）
错误格式	错误