发布与集成

步骤 1：在 Coze 中配置

1. 1. 进入 Bot 详情页，点击"发布"
2. 2. 选择"微信公众号"
3. 3. 填写公众号的 AppID 和 AppSecret（在微信公众平台获取）
4. 4. 复制 Coze 提供的服务器 URL 和 Token

步骤 2：在微信公众平台配置

1. 1. 登录微信公众平台
2. 2. 进入"开发" → "基本配置"
3. 3. 填入 Coze 提供的服务器 URL 和 Token
4. 4. 点击"启用"，完成验证

步骤 3：测试

关注你的公众号，发送消息，Bot 会自动回复。

步骤 1：创建飞书应用

1. 1. 登录飞书开放平台（open.feishu.cn）
2. 2. 创建企业自建应用
3. 3. 获取 App ID 和 App Secret
4. 4. 开通"机器人"能力

步骤 2：在 Coze 中配置

1. 1. 进入 Bot 详情页，点击"发布"
2. 2. 选择"飞书"
3. 3. 填写飞书应用的 App ID 和 App Secret
4. 4. 复制 Coze 提供的事件订阅 URL

步骤 3：配置飞书应用

1. 1. 在飞书开放平台，进入"事件订阅"
2. 2. 填入 Coze 提供的事件订阅 URL
3. 3. 订阅"接收消息"事件
4. 4. 发布应用版本

步骤

1. 1. 进入 Bot 详情页，点击"发布"
2. 2. 选择"网页"
3. 3. 自定义网页标题、描述、图标
4. 4. 点击"生成链接"
5. 5. 复制链接，分享给用户

方式一：iframe 嵌入

Coze 提供 iframe 代码，可以直接嵌入到你的网站中。

<iframe
  src="https://www.coze.com/s/abc123xyz"
  width="400"
  height="600"
  frameborder="0"
></iframe>

方式二：浮窗插件

在网页右下角显示一个聊天图标，点击后弹出对话窗口。

<script src="https://www.coze.com/widget.js"></script>
<script>
  CozeWidget.init({
    botId: 'abc123xyz',
    position: 'bottom-right'
  });
</script>

1. 1. 进入 Coze 控制台
2. 2. 点击右上角头像 → "API 密钥"
3. 3. 创建新的 API Key
4. 4. 复制并妥善保管（只显示一次）

Node.js

const axios = require('axios');

async function chatWithBot(query) {
  const response = await axios.post(
    'https://api.coze.com/v1/chat',
    {
      bot_id: 'abc123xyz',
      user_id: 'user_001',
      query: query,
      stream: false
    },
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    }
  );

  return response.data.data.content;
}

// 使用
chatWithBot('你好').then(reply => {
  console.log(reply);
});

Python

import requests

def chat_with_bot(query):
    url = 'https://api.coze.com/v1/chat'
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
    data = {
        'bot_id': 'abc123xyz',
        'user_id': 'user_001',
        'query': query,
        'stream': False
    }

    response = requests.post(url, json=data, headers=headers)
    return response.json()['data']['content']

# 使用
reply = chat_with_bot('你好')
print(reply)

步骤

1. 1. 确保 Bot 功能完善，提示词清晰
2. 2. 准备 Bot 的介绍、截图、使用说明
3. 3. 进入 Bot 详情页，点击"发布到商店"
4. 4. 填写 Bot 信息（名称、分类、标签、描述）
5. 5. 提交审核（通常 1-3 个工作日）

1. 用户身份管理

在调用 API 时，传入唯一的 user_id，这样 Bot 可以记住每个用户的对话历史。

2. 错误处理

API 调用可能失败（网络问题、限流、Bot 错误），需要做好错误处理：

• • 捕获异常，给用户友好的提示
• • 实现重试机制（如 3 次重试）
• • 记录错误日志，方便排查问题

3. 性能优化

• • 使用流式响应，提升用户体验
• • 缓存常见问题的答案，减少 API 调用
• • 设置超时时间（如 30 秒），避免长时间等待

4. 成本控制

Coze API 按调用次数或 token 数量计费，需要控制成本：

• • 限制每个用户的调用频率（如每分钟 10 次）
• • 过滤无效请求（如空消息、重复消息）
• • 监控 API 使用量，设置预警

5. 安全防护

• • API Key 存储在环境变量中，不要硬编码
• • 在后端调用 API，不要在前端暴露 Key
• • 验证用户身份，防止恶意调用
• • 对用户输入做过滤，防止注入攻击

Q1: 发布后，Bot 回复很慢？

Q2: API 调用失败，返回 401？

Q3: 微信公众号接入后，Bot 不回复？

Q4: 如何统计 Bot 的使用数据？