如何为Bubble.io应用配置Microsoft Teams API集成及事件创建的API Connector设置？

一、先搞定Azure AD应用注册（核心前置步骤） #

Teams API依赖Microsoft Graph提供服务，必须先在Azure中注册应用获取鉴权凭证：

• 登录Azure门户，找到「Azure Active Directory」→「应用注册」→「新注册」
• 名称自定义，账户支持选项选「任何组织目录中的账户和个人Microsoft账户」，重定向URI选「Web」，填入你的Bubble应用OAuth回调地址（格式：https://[你的Bubble域名]/oauth_redirect）
• 注册完成后，复制「应用程序(客户端)ID」和「目录(租户)ID」留存
• 进入「证书和密码」→「客户端密码」→「新客户端密码」，设置有效期后生成密码，立刻复制密码值（仅显示一次，丢失需重新生成）
• 进入「API权限」→「添加权限」→选择「Microsoft Graph」→「委派权限」，搜索并添加以下权限：
  • Calendars.ReadWrite（创建事件的核心权限）
  • User.Read（读取基础用户信息所需）
• 点击「授予管理员同意」（个人账户可跳过，组织账户必须执行此步骤）

二、Bubble中配置API Connector基础集成 #

打开Bubble应用编辑器，按路径「插件」→「API Connector」→「添加API」操作：

• API名称填写「Microsoft Teams Graph API」，认证类型选择「OAuth2」
• 配置OAuth2参数：
  • 授权URL：https://login.microsoftonline.com/common/oauth2/v2.0/authorize
  • 令牌URL：https://login.microsoftonline.com/common/oauth2/v2.0/token
  • 客户端ID：粘贴Azure中获取的应用程序ID
  • 客户端密钥：粘贴Azure生成的客户端密码
  • 范围：填入Calendars.ReadWrite User.Read
  • 重定向URI：填入之前在Azure中注册的Bubble回调地址
• 点击「连接账户」，使用Microsoft账户登录完成授权，验证是否能成功获取令牌

三、配置创建Teams日历事件的具体API调用 #

在已创建的「Microsoft Teams Graph API」中新增一个API调用：

• 调用名称：「创建Teams会议事件」
• HTTP方法：POST
• URL：https://graph.microsoft.com/v1.0/me/events
• 认证选项：选择「使用OAuth2令牌」（即刚才配置的授权账户）
• 请求体类型：「JSON」
• 请求体内容（示例，可按需修改字段）：

{
  "subject": "项目同步会",
  "start": {
    "dateTime": "2024-10-01T14:00:00",
    "timeZone": "China Standard Time"
  },
  "end": {
    "dateTime": "2024-10-01T15:30:00",
    "timeZone": "China Standard Time"
  },
  "attendees": [
    {
      "emailAddress": {
        "address": "team-member@company.com",
        "name": "张三"
      },
      "type": "required"
    }
  ],
  "body": {
    "contentType": "html",
    "content": "这是通过Bubble应用创建的Teams同步会议"
  },
  "onlineMeetingProvider": "teamsForBusiness"
}

• 点击「检测」，若配置正确会返回创建成功的事件数据，保存此API调用即可

四、在Bubble应用中落地事件创建功能 #

• 打开Bubble工作流，添加「调用API」动作，选择刚才创建的「创建Teams会议事件」
• 将请求体中的静态字段替换为动态数据（比如用户输入的会议标题、选择的时间、填写的参会人邮箱等）
• 新增后续动作，例如给用户弹出通知，告知事件创建成功或失败状态

踩坑提示 #

• 必须确保用户授权时同意了Calendars.ReadWrite权限，否则会返回403权限错误
• 时区需与用户实际时区匹配，避免硬写死导致时间显示混乱
• 测试时使用真实Microsoft账户，覆盖个人和组织账户场景，确保兼容性

内容的提问来源于stack exchange，提问作者salem