连接 Zoom 和 Braze 的过程

最新推荐文章于 2024-09-26 15:35:41 发布

前端无冕之王

最新推荐文章于 2024-09-26 15:35:41 发布

阅读量660

点赞数 24

文章标签： swift 开发语言服务器

本文链接：https://blog.csdn.net/m0_64036296/article/details/142130107

版权

以下是更加详细的步骤，包括在连接 Zoom 和 Braze 的过程中每一个细小步骤所需的技术，并说明了可能遇到的挑战和解决方案。

第1步：创建 Zoom API 凭证并获取 API 数据

1.1 登录 Zoom Marketplace

访问 Zoom Marketplace。
点击 Sign In，使用你的 Zoom 账号登录。

技术需求：

需要一个有效的 Zoom 账号，并且拥有 Zoom Meeting 访问权限。

1.2 创建一个 API 应用

登录后，点击右上角的 Develop 按钮。
选择 Build App，并在弹出的选项中选择 JWT（用于简单应用开发和测试）或 OAuth（推荐用于生产环境）。
如果选择 OAuth，你需要指定 重定向 URI（redirect URI），这是 Zoom 认证流程的一部分，完成 OAuth 后会跳转到该 URL。
填写 App Name 和 基本信息，并完成应用创建。

技术需求：

OAuth：需要掌握 OAuth 2.0 认证流程，特别是了解如何使用授权码或客户端凭证流（需要后端编程语言支持，如 Python、Node.js、Java 等）。
JWT：可以直接生成 API Key 和 API Secret，便于后续进行 API 调用。

1.3 配置应用权限

在应用设置中，选择 Scopes，确保为 API 应用分配足够的权限，例如：
- meeting:read（读取会议详情）
- user:read（读取用户信息）
- report:read（读取报告数据，包含参与者信息）

技术需求：

需要了解 Zoom 的权限模型，以确保 API 调用有足够权限。
Zoom API 文档参考：https://marketplace.zoom.us/docs/api-reference

1.4 生成 API 凭证

如果使用 JWT，系统将直接生成 API Key 和 API Secret。
如果使用 OAuth，需要保存 Client ID 和 Client Secret，并配置 Redirect URI。

技术需求：

OAuth 应用开发需要后端技术支持，适用于需要复杂用户权限管理的生产环境。
JWT 适用于快速开发和测试，无需复杂的重定向流程。

1.5 测试 API 调用

打开你的代码编辑器或 Postman，开始测试 Zoom API 调用。

示例：获取会议参与者列表（通过 JWT）

GET https://api.zoom.us/v2/metrics/meetings/{meetingId}/participants

Python 代码示例：

import requests zoom_token = "YOUR_ZOOM_JWT_TOKEN" meeting_id = "YOUR_MEETING_ID" headers = { "Authorization": f"Bearer {zoom_token}" } url = f"https://api.zoom.us/v2/metrics/meetings/{meeting_id}/participants" response = requests.get(url, headers=headers) if response.status_code == 200: data = response.json() print(data) else: print(f"Failed to fetch meeting data. Status Code: {response.status_code}")

技术需求：

需要基础的 HTTP 请求 知识（GET 请求），以及掌握 Python 或 Postman 等工具来调用 API。
注意处理 401 Unauthorized 或 403 Forbidden 错误，通常与权限配置或凭证错误有关。

可能问题：

API 调用失败：确保 API Key 或 OAuth token 有效。
速率限制：Zoom 对 API 调用有速率限制，超出限额时可能会遇到 429 Too Many Requests 错误。

第2步：处理 Zoom 数据

2.1 提取 Zoom API 返回的数据

从 Zoom API 返回的 JSON 数据中提取关键信息。需要解析并提取具体字段，如：

用户邮箱（user_email）
姓名（name）
加入时间（join_time）
离开时间（leave_time）

Python 数据处理示例：

participants = response.json().get("participants", []) for participant in participants: email = participant.get("user_email") name = participant.get("name") join_time = participant.get("join_time") leave_time = participant.get("leave_time") duration = participant.get("duration") # 以秒为单位 print(f"{name} ({email}) joined at {join_time} and left at {leave_time}")

技术需求：

需要熟悉 JSON 数据解析，以及使用 Python 处理字典和列表。
需要掌握 时间处理，特别是计算时差（如通过 join_time 和 leave_time 计算参与时间）。

可能问题：

如果 API 调用成功，但返回空数据，确保会议 ID 是正确的，且会议结束后允许访问参与者数据。

第3步：创建 Braze API 凭证并上传数据

3.1 创建 Braze API Key

登录 Braze Dashboard。
在右上角，点击 Developer Console，选择 Create New API Key。
为 API Key 分配合适的权限：
- users.track（用于创建和更新用户数据）
- events.track（用于记录用户事件）

技术需求：

需要了解 Braze 的权限设置，并且确保 API Key 拥有正确的权限。

3.2 上传 Zoom 数据到 Braze

你可以使用 Braze 的 /users/track API，将从 Zoom 获取的用户信息和会议参与记录上传到 Braze。

Python 代码示例：

import requests import json braze_api_key = "YOUR_BRAZE_API_KEY" braze_url = "https://YOUR_BRAZE_REST_ENDPOINT/users/track" # 从 Zoom 中提取的示例数据 zoom_data = { "email": "john@example.com", "name": "John Doe", "meeting_start_time": "2024-09-10T10:00:00Z", "meeting_end_time": "2024-09-10T11:00:00Z", "duration": 3600 } # 创建 Braze API Payload payload = { "api_key": braze_api_key, "attributes": [ { "external_id": zoom_data['email'], "first_name": zoom_data['name'], "meeting_start_time": zoom_data['meeting_start_time'], "meeting_end_time": zoom_data['meeting_end_time'], "meeting_duration": zoom_data['duration'] } ] } # 发送请求 headers = { "Content-Type": "application/json" } response = requests.post(braze_url, headers=headers, data=json.dumps(payload)) if response.status_code == 201: print(f"Data for {zoom_data['email']} successfully sent to Braze") else: print(f"Failed to send data. Status Code: {response.status_code}")