业务平台 · 加好友开场白 API

配置用户添加企微好友后自动发送的欢迎语（企微 send_welcome_msg）。 发送由 chatbot 在收到 add_external_contact 回调时自动完成；本 API 仅管理文案。 鉴权：X-Chatbot-Webhook-Secret（与用户同步相同）。

解析优先级：渠道 state → channel_code → 员工 follow_userid → 全局默认

全局默认（只读）

全局文案在 application.yml / WECOM_WELCOME_ENABLED 配置；业务 API 暂不支持修改。

员工级（A）

{
  "welcome_text": "员工专属开场白…",
  "welcome_payload": {
    "text": "你好，我是健康顾问",
    "attachments": [
      { "msgtype": "image", "asset_id": 12 },
      { "msgtype": "link", "title": "指南", "url": "https://example.com", "picurl": "https://…", "desc": "简介" },
      { "msgtype": "miniprogram", "title": "小程序", "appid": "wx…", "page": "/pages/index", "cover_asset_id": 15 }
    ]
  }
}

须已存在 follow-agent 配置。有 welcome_payload 时优先；否则用 welcome_text。图片素材先在管理端「出站素材」上传，拿 asset_id。

渠道级（B）

{ "welcome_text": "…", "welcome_payload": { "text": "…", "attachments": [] } }

预览解析结果

{ "follow_userid": "zhangsan", "state": "douyin__feed_banner" }

返回 { "text", "source", "welcome_payload", "matched" }，不实际发送消息。

素材与结构化开场白管理

出站素材接口管理 image/video/file；渠道的 welcome-payload 可保存 text 与 attachments，图片、视频和文件以 asset_id 引用。