Zoom General
OpenAIOfficialCreated by ZoomDistributed by OpenAI
- Skill
- Tool integration
- Automation and integrations
- MIT
- Medium risk
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
Zoom General serves as a strategic starting point for developers and architects to navigate the Zoom ecosystem. It provides a structured workflow to classify integration requirements, identify the correct Zoom product surface (such as APIs, SDKs, or webhooks), and determine the necessary authentication model. By guiding users through a decision-making process, it ensures that developers select the right tool for their specific use case before routing to more specialized skills.
What it does
- Classifies integration jobs based on desired outcomes like embedding meetings or automating resources.
- Maps requirements to specific Zoom surfaces including REST APIs, WebSockets, and various SDKs.
- Provides guidance on selecting the correct authentication and scope model for an integration.
- Facilitates routing to specialized skills once the product context is established.
- Offers comparative context for tasks that span multiple Zoom product boundaries.
When to use it
- When you are in the early stages of planning a Zoom integration and need to choose the right app type.
- When you need to compare different Zoom surfaces to determine which fits your technical requirements.
- When a task involves multiple Zoom products and requires a high-level architectural approach.
- When you need to confirm the correct authentication flow for a specific integration scenario.
Advantages
- Prevents premature selection of tools by enforcing a structured classification process.
- Clarifies the distinction between user-level OAuth, account-level OAuth, and SDK signatures.
- Reduces complexity by routing users to narrow, specialized skills after initial planning.
- Provides a clear decision matrix for choosing between General Apps, Server-to-Server OAuth, and Webhook Only apps.
Usage examples
- “I want to build an app that automates meeting reports. Which Zoom app type should I use?”
- The agent will guide you to classify the job as backend automation, leading to the recommendation of Server-to-Server OAuth for its lack of user interaction requirements.
- “Should I use the Meeting SDK or the Video SDK for my project?”
- The agent will help you compare the two based on your specific embedding needs and surface requirements, ensuring you choose the correct SDK for your use case.
Install
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/openai/zoom-general/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip zoom-general.zip -d .agents/skills
Documentation by Zoom
Zoom General
Use this skill for cross-product platform context after the user’s goal is understood. For first-step routing, prefer start, plan-zoom-product, or plan-zoom-integration.
Workflow
Classify the job by outcome: embed meetings, custom video, automate resources, consume events, process media, use meeting intelligence, or publish a Marketplace app.
Choose the Zoom surface that owns the behavior: REST API, webhooks, WebSockets, Meeting SDK, Video SDK, Zoom Apps SDK, Phone, Contact Center, Virtual Agent, Scribe, Rivet, or Cobrowse.
Confirm auth and scope model before implementation; Zoom surfaces differ on user-level OAuth, account-level OAuth, and SDK signatures.
Route to the narrow skill once the surface is chosen rather than keeping broad guidance in context.
Use the preserved guide only when a task crosses product boundaries or needs detailed comparison tables.
References
Full preserved guide: references/full-guide.md
App types: references/app-types.md
Authentication: references/authentication.md
Scopes: references/scopes.md
Marketplace: references/marketplace.md
Query routing playbook: references/query-routing-playbook.md
Files
- ATTRIBUTION.mdAdded by AutoGineer866 B
- LICENSELicence file added by AutoGineer1.1 KiB
- RUNBOOK.md2.4 KiB
- SKILL.md1.4 KiB
- agents/openai.yaml133 B
- references/app-types.md2.6 KiB
- references/authentication.md2.0 KiB
- references/authorization-patterns.md21.2 KiB
- references/automatic-skill-chaining-rest-webhooks.md5.5 KiB
- references/community-repos.md9.1 KiB
- references/distributed-meeting-fallback-architecture.md14.0 KiB
- references/environment-variables.md3.0 KiB
- references/full-guide.md5.3 KiB
- references/interview-answer-routing.md796 B
- references/known-limitations.md2.5 KiB
- references/marketplace.md1.6 KiB
- references/meeting-webhooks-oauth-refresh-orchestration.md5.3 KiB
- references/query-routing-playbook.md2.7 KiB
- references/routing-implementation.md3.7 KiB
- references/scopes.md3.4 KiB
- references/sdk-logs-troubleshooting.md5.7 KiB
- references/sdk-upgrade-guide.md4.1 KiB
- references/sdk-upgrade-workflow.md3.5 KiB
- use-cases/ai-companion-integration.md9.8 KiB
- use-cases/ai-integration.md7.2 KiB
- use-cases/backend-automation-s2s-oauth.md4.9 KiB
- use-cases/collaborative-apps.md2.6 KiB
- use-cases/contact-center-app-lifecycle-and-context-switching.md1.2 KiB
- use-cases/contact-center-integration.md1.1 KiB
- use-cases/custom-meeting-ui-web.md2.8 KiB
- use-cases/custom-video.md5.6 KiB
- use-cases/customer-support-cobrowsing.md12.5 KiB
- use-cases/electron-meeting-embed.md1020 B
- use-cases/embed-meetings.md4.8 KiB
- use-cases/enterprise-app-deployment.md1.0 KiB
- use-cases/flutter-video-sessions.md910 B
- use-cases/form-completion-assistant.md15.3 KiB
- use-cases/hd-video-resolution.md8.8 KiB
- use-cases/high-volume-meeting-platform.md1.9 KiB
- use-cases/immersive-experiences.md2.9 KiB
- use-cases/in-meeting-apps.md7.4 KiB
- use-cases/marketplace-publishing.md9.2 KiB
- use-cases/meeting-automation.md6.1 KiB
- use-cases/meeting-bots.md10.6 KiB
- use-cases/meeting-details-with-events.md20.8 KiB
- use-cases/meeting-links-vs-embedding.md988 B
- use-cases/minutes-calculation.md22.5 KiB
- use-cases/native-meeting-sdk-multi-platform.md1.5 KiB
- use-cases/native-video-sdk-multi-platform.md1.2 KiB
- use-cases/prebuilt-video-ui.md12.4 KiB
- use-cases/probe-sdk-preflight-readiness-gate.md1.2 KiB
- use-cases/qss-monitoring.md2.7 KiB
- use-cases/raw-recording.md5.1 KiB
- use-cases/react-native-meeting-embed.md1.0 KiB
- use-cases/react-native-video-sessions.md953 B
- use-cases/real-time-media-streams.md5.4 KiB
- use-cases/recording-download-pipeline.md8.7 KiB
- use-cases/recording-transcription.md7.2 KiB
- use-cases/retrieve-meeting-and-subscribe-events.md32.9 KiB
- use-cases/rivet-event-driven-api-orchestrator.md1.3 KiB
- use-cases/saas-app-oauth-integration.md4.8 KiB
- use-cases/scribe-transcription-pipeline.md1.8 KiB
- use-cases/sdk-size-optimization.md5.0 KiB
- use-cases/sdk-wrappers-gui.md18.4 KiB
- use-cases/server-to-server-oauth-with-webhooks.md1.7 KiB
- use-cases/team-chat-llm-bot.md6.7 KiB
- use-cases/testing-development.md7.2 KiB
- use-cases/token-and-scope-troubleshooting.md2.4 KiB
- use-cases/transcription-bot-linux.md14.3 KiB
- use-cases/usage-reporting-analytics.md8.5 KiB
- use-cases/user-and-meeting-creation.md16.9 KiB
- use-cases/video-sdk-bring-your-own-storage.md6.9 KiB
- use-cases/virtual-agent-campaign-web-mobile-wrapper.md1.4 KiB
- use-cases/virtual-agent-knowledge-base-sync-pipeline.md1.1 KiB
- use-cases/web-sdk-embedding.md4.5 KiB
- use-cases/zoom-phone-smart-embed-crm.md876 B
use-cases/minutes-calculation.md
Minutes Calculation for Billing
Calculate usage minutes for Video SDK sessions and Meeting SDK meetings for billing and cost management.
Overview
Zoom SDKs are billed based on participant-minutes. This guide covers how to track and calculate usage for accurate billing projections and cost optimization.
Skills Needed
zoom-rest-api - Reports API
webhooks - Real-time tracking
zoom-video-sdk - Session Quality API
Billing Models
| SDK | Billing Unit | Calculation |
|---|---|---|
| Video SDK | Participant-minutes | Sum of (each participant's session duration) |
| Meeting SDK | Host minutes | Based on meeting duration, not participant count |
Example: A 30-minute Video SDK session with 4 participants = 120 participant-minutes.
Video SDK Usage Tracking
Method 1: Session Quality API (Recommended)
Most accurate method using Zoom's built-in analytics.
const axios = require('axios');
// Get session details including participant minutes
async function getSessionUsage(sessionId) {
const response = await axios.get(
`https://api.zoom.us/v2/videosdk/sessions/${sessionId}`,
{
headers: { 'Authorization': `Bearer ${accessToken}` }
}
);
return {
sessionName: response.data.session_name,
startTime: response.data.start_time,
endTime: response.data.end_time,
totalMinutes: response.data.duration, // Total session minutes
participantCount: response.data.participant_count
};
}
// Get participant-level breakdown
async function getSessionParticipants(sessionId) {
const response = await axios.get(
`https://api.zoom.us/v2/videosdk/sessions/${sessionId}/participants`,
{
params: { page_size: 300 },
headers: { 'Authorization': `Bearer ${accessToken}` }
}
);
// Calculate participant-minutes
const participants = response.data.participants.map(p => {
const joinTime = new Date(p.join_time);
const leaveTime = new Date(p.leave_time);
const durationMinutes = (leaveTime - joinTime) / 1000 / 60;
return {
name: p.user_name,
joinTime: p.join_time,
leaveTime: p.leave_time,
durationMinutes: Math.round(durationMinutes * 100) / 100
};
});
const totalParticipantMinutes = participants.reduce(
(sum, p) => sum + p.durationMinutes, 0
);
return {
participants,
totalParticipantMinutes: Math.round(totalParticipantMinutes * 100) / 100
};
}
// Get all sessions in date range
async function getSessionsInRange(from, to) {
const response = await axios.get(
'https://api.zoom.us/v2/videosdk/sessions',
{
params: { from, to, page_size: 300 },
headers: { 'Authorization': `Bearer ${accessToken}` }
}
);
return response.data.sessions;
}
// Calculate monthly usage
async function calculateMonthlyUsage(year, month) {
const from = `${year}-${String(month).padStart(2, '0')}-01`;
const lastDay = new Date(year, month, 0).getDate();
const to = `${year}-${String(month).padStart(2, '0')}-${lastDay}`;
const sessions = await getSessionsInRange(from, to);
let totalParticipantMinutes = 0;
const sessionDetails = [];
for (const session of sessions) {
const participants = await getSessionParticipants(session.id);
totalParticipantMinutes += participants.totalParticipantMinutes;
sessionDetails.push({
sessionId: session.id,
sessionName: session.session_name,
date: session.start_time,
participantMinutes: participants.totalParticipantMinutes
});
}
return {
period: `${year}-${String(month).padStart(2, '0')}`,
totalSessions: sessions.length,
totalParticipantMinutes: Math.round(totalParticipantMinutes),
sessions: sessionDetails
};
}Method 2: Real-Time Webhook Tracking
Track usage in real-time as sessions happen.
const express = require('express');
const app = express();
// In-memory storage (use database in production)
const activeSessions = new Map();
const usageRecords = [];
app.post('/webhook', express.json(), (req, res) => {
const { event, payload } = req.body;
switch (event) {
case 'session.started':
handleSessionStarted(payload);
break;
case 'session.ended':
handleSessionEnded(payload);
break;
case 'session.participant_joined':
handleParticipantJoined(payload);
break;
case 'session.participant_left':
handleParticipantLeft(payload);
break;
}
res.status(200).send();
});
function handleSessionStarted(payload) {
const { object } = payload;
activeSessions.set(object.id, {
sessionId: object.id,
sessionName: object.session_name,
startTime: new Date(object.start_time),
participants: new Map()
});
}
function handleSessionEnded(payload) {
const { object } = payload;
const session = activeSessions.get(object.id);
if (session) {
// Calculate final usage for any remaining participants
const endTime = new Date(object.end_time);
let totalMinutes = 0;
session.participants.forEach((participant, participantId) => {
if (!participant.leaveTime) {
participant.leaveTime = endTime;
}
const duration = (participant.leaveTime - participant.joinTime) / 1000 / 60;
totalMinutes += duration;
});
// Record usage
usageRecords.push({
sessionId: object.id,
sessionName: session.sessionName,
startTime: session.startTime,
endTime: endTime,
totalParticipantMinutes: Math.round(totalMinutes * 100) / 100,
participantCount: session.participants.size
});
activeSessions.delete(object.id);
}
}
function handleParticipantJoined(payload) {
const { object } = payload;
const session = activeSessions.get(object.session_id);
if (session) {
session.participants.set(object.participant.participant_id, {
name: object.participant.user_name,
joinTime: new Date(object.participant.join_time),
leaveTime: null
});
}
}
function handleParticipantLeft(payload) {
const { object } = payload;
const session = activeSessions.get(object.session_id);
if (session) {
const participant = session.participants.get(object.participant.participant_id);
if (participant) {
participant.leaveTime = new Date(object.participant.leave_time);
}
}
}
// Get current month usage
app.get('/usage/current-month', (req, res) => {
const now = new Date();
const startOfMonth = new Date(now.getFullYear(), now.getMonth(), 1);
const monthlyRecords = usageRecords.filter(r =>
new Date(r.startTime) >= startOfMonth
);
const totalMinutes = monthlyRecords.reduce(
(sum, r) => sum + r.totalParticipantMinutes, 0
);
res.json({
period: `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`,
totalSessions: monthlyRecords.length,
totalParticipantMinutes: Math.round(totalMinutes),
records: monthlyRecords
});
});Method 3: Client-Side Tracking
Track locally in your SDK application.
// React Native / JavaScript SDK tracking
class UsageTracker {
constructor() {
this.sessionStart = null;
this.participants = new Map();
}
onSessionJoin() {
this.sessionStart = new Date();
}
onUserJoin(user) {
this.participants.set(user.id, {
name: user.name,
joinTime: new Date(),
leaveTime: null
});
}
onUserLeave(user) {
const participant = this.participants.get(user.id);
if (participant) {
participant.leaveTime = new Date();
}
}
calculateUsage() {
const now = new Date();
let totalMinutes = 0;
this.participants.forEach(participant => {
const endTime = participant.leaveTime || now;
const duration = (endTime - participant.joinTime) / 1000 / 60;
totalMinutes += duration;
});
return {
sessionDuration: (now - this.sessionStart) / 1000 / 60,
totalParticipantMinutes: Math.round(totalMinutes * 100) / 100,
participantCount: this.participants.size
};
}
// Send to your backend periodically
async reportUsage() {
const usage = this.calculateUsage();
await fetch('/api/usage', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(usage)
});
}
}// Windows/C++ SDK tracking
class UsageTracker : public IZoomVideoSDKDelegate {
private:
std::chrono::system_clock::time_point sessionStart;
struct ParticipantUsage {
std::wstring name;
std::chrono::system_clock::time_point joinTime;
std::chrono::system_clock::time_point leaveTime;
bool hasLeft = false;
};
std::map<std::wstring, ParticipantUsage> participants;
public:
void onSessionJoin() override {
sessionStart = std::chrono::system_clock::now();
}
void onUserJoin(IZoomVideoSDKUserHelper* helper,
IVideoSDKVector<IZoomVideoSDKUser*>* users) override {
for (int i = 0; i < users->GetCount(); i++) {
auto user = users->GetItem(i);
ParticipantUsage usage;
usage.name = user->getUserName();
usage.joinTime = std::chrono::system_clock::now();
participants[user->getUserID()] = usage;
}
}
void onUserLeave(IZoomVideoSDKUserHelper* helper,
IVideoSDKVector<IZoomVideoSDKUser*>* users) override {
for (int i = 0; i < users->GetCount(); i++) {
auto user = users->GetItem(i);
auto it = participants.find(user->getUserID());
if (it != participants.end()) {
it->second.leaveTime = std::chrono::system_clock::now();
it->second.hasLeft = true;
}
}
}
double calculateTotalMinutes() {
auto now = std::chrono::system_clock::now();
double totalMinutes = 0;
for (const auto& [id, participant] : participants) {
auto endTime = participant.hasLeft ? participant.leaveTime : now;
auto duration = std::chrono::duration_cast<std::chrono::minutes>(
endTime - participant.joinTime
);
totalMinutes += duration.count();
}
return totalMinutes;
}
};Meeting SDK Usage Tracking
Reports API for Past Meetings
// Get meeting usage from Reports API
async function getMeetingUsage(meetingId) {
// Note: Double-encode UUID if it contains / or //
const encodedId = meetingId.includes('/')
? encodeURIComponent(encodeURIComponent(meetingId))
: meetingId;
const [meeting, participants] = await Promise.all([
axios.get(
`https://api.zoom.us/v2/report/meetings/${encodedId}`,
{ headers: { 'Authorization': `Bearer ${accessToken}` }}
),
axios.get(
`https://api.zoom.us/v2/report/meetings/${encodedId}/participants`,
{
params: { page_size: 300 },
headers: { 'Authorization': `Bearer ${accessToken}` }
}
)
]);
// Calculate participant-minutes
const participantMinutes = participants.data.participants.map(p => {
const duration = p.duration; // Already in seconds
return {
name: p.name,
email: p.user_email,
durationMinutes: Math.round(duration / 60 * 100) / 100
};
});
const totalParticipantMinutes = participantMinutes.reduce(
(sum, p) => sum + p.durationMinutes, 0
);
return {
meetingId: meetingId,
topic: meeting.data.topic,
startTime: meeting.data.start_time,
endTime: meeting.data.end_time,
hostMinutes: meeting.data.duration, // Meeting duration in minutes
totalParticipantMinutes: Math.round(totalParticipantMinutes),
participantCount: participants.data.participants.length,
participants: participantMinutes
};
}
// Get daily usage summary
async function getDailyUsageSummary(year, month) {
const response = await axios.get(
'https://api.zoom.us/v2/report/daily',
{
params: { year, month },
headers: { 'Authorization': `Bearer ${accessToken}` }
}
);
// Aggregate daily data
const summary = response.data.dates.reduce((acc, day) => {
acc.totalMeetings += day.meetings;
acc.totalMinutes += day.meeting_minutes;
acc.totalParticipants += day.participants;
return acc;
}, { totalMeetings: 0, totalMinutes: 0, totalParticipants: 0 });
return {
period: `${year}-${String(month).padStart(2, '0')}`,
...summary,
dailyBreakdown: response.data.dates
};
}
// Get user-specific meeting report
async function getUserMeetingReport(userId, from, to) {
const response = await axios.get(
`https://api.zoom.us/v2/report/users/${userId}/meetings`,
{
params: { from, to, page_size: 300 },
headers: { 'Authorization': `Bearer ${accessToken}` }
}
);
const totalMinutes = response.data.meetings.reduce(
(sum, m) => sum + m.duration, 0
);
return {
userId,
period: { from, to },
totalMeetings: response.data.meetings.length,
totalHostMinutes: totalMinutes,
meetings: response.data.meetings
};
}Webhook-Based Tracking
// Meeting SDK webhook events
app.post('/meeting-webhook', express.json(), (req, res) => {
const { event, payload } = req.body;
switch (event) {
case 'meeting.started':
handleMeetingStarted(payload);
break;
case 'meeting.ended':
handleMeetingEnded(payload);
break;
case 'meeting.participant_joined':
handleMeetingParticipantJoined(payload);
break;
case 'meeting.participant_left':
handleMeetingParticipantLeft(payload);
break;
}
res.status(200).send();
});
// Store in database for billing
async function handleMeetingEnded(payload) {
const { object } = payload;
await db.meetings.insert({
meetingId: object.id,
uuid: object.uuid,
topic: object.topic,
hostId: object.host_id,
startTime: object.start_time,
endTime: object.end_time,
durationMinutes: object.duration,
participantCount: object.participant_count
});
}Cost Estimation
Video SDK Cost Calculator
// Pricing tiers (example - check current Zoom pricing)
const PRICING_TIERS = [
{ upTo: 10000, pricePerMinute: 0.0050 },
{ upTo: 50000, pricePerMinute: 0.0040 },
{ upTo: 100000, pricePerMinute: 0.0030 },
{ upTo: Infinity, pricePerMinute: 0.0025 }
];
function estimateMonthlyCost(participantMinutes) {
let remaining = participantMinutes;
let totalCost = 0;
let previousLimit = 0;
for (const tier of PRICING_TIERS) {
const tierMinutes = Math.min(remaining, tier.upTo - previousLimit);
if (tierMinutes <= 0) break;
totalCost += tierMinutes * tier.pricePerMinute;
remaining -= tierMinutes;
previousLimit = tier.upTo;
}
return {
participantMinutes,
estimatedCost: Math.round(totalCost * 100) / 100,
currency: 'USD'
};
}
// Project usage for the month
function projectMonthlyUsage(currentUsage, dayOfMonth, daysInMonth) {
const dailyAverage = currentUsage / dayOfMonth;
const projectedTotal = dailyAverage * daysInMonth;
return {
currentUsage,
dailyAverage: Math.round(dailyAverage),
projectedMonthlyUsage: Math.round(projectedTotal),
projectedCost: estimateMonthlyCost(projectedTotal)
};
}Year-to-Date (YTD) Usage
Calculate cumulative usage from the start of the year.
// Calculate YTD usage for Video SDK
async function getYTDUsage() {
const now = new Date();
const year = now.getFullYear();
const currentMonth = now.getMonth() + 1;
// Fetch all months in parallel
const monthPromises = [];
for (let month = 1; month <= currentMonth; month++) {
monthPromises.push(calculateMonthlyUsage(year, month));
}
const monthlyResults = await Promise.all(monthPromises);
// Aggregate YTD totals
const ytdTotals = monthlyResults.reduce((acc, month) => {
acc.totalSessions += month.totalSessions;
acc.totalParticipantMinutes += month.totalParticipantMinutes;
return acc;
}, { totalSessions: 0, totalParticipantMinutes: 0 });
// Monthly breakdown for trending
const monthlyBreakdown = monthlyResults.map(m => ({
period: m.period,
sessions: m.totalSessions,
participantMinutes: m.totalParticipantMinutes
}));
// Calculate month-over-month growth
const growthRates = [];
for (let i = 1; i < monthlyBreakdown.length; i++) {
const prev = monthlyBreakdown[i - 1].participantMinutes;
const curr = monthlyBreakdown[i].participantMinutes;
growthRates.push({
period: monthlyBreakdown[i].period,
growthRate: prev > 0 ? ((curr - prev) / prev * 100).toFixed(1) + '%' : 'N/A'
});
}
return {
year,
asOfDate: now.toISOString().split('T')[0],
ytdTotals: {
totalSessions: ytdTotals.totalSessions,
totalParticipantMinutes: Math.round(ytdTotals.totalParticipantMinutes),
estimatedCost: estimateMonthlyCost(ytdTotals.totalParticipantMinutes)
},
monthlyBreakdown,
growthRates,
averageMonthlyUsage: Math.round(ytdTotals.totalParticipantMinutes / currentMonth)
};
}
// Calculate YTD usage for Meeting SDK (via Reports API)
async function getMeetingSDKYTDUsage() {
const now = new Date();
const year = now.getFullYear();
const currentMonth = now.getMonth() + 1;
// Fetch daily reports for each month
const monthPromises = [];
for (let month = 1; month <= currentMonth; month++) {
monthPromises.push(getDailyUsageSummary(year, month));
}
const monthlyResults = await Promise.all(monthPromises);
// Aggregate YTD
const ytdTotals = monthlyResults.reduce((acc, month) => {
acc.totalMeetings += month.totalMeetings;
acc.totalMinutes += month.totalMinutes;
acc.totalParticipants += month.totalParticipants;
return acc;
}, { totalMeetings: 0, totalMinutes: 0, totalParticipants: 0 });
return {
year,
asOfDate: now.toISOString().split('T')[0],
ytdTotals,
monthlyBreakdown: monthlyResults.map(m => ({
period: m.period,
meetings: m.totalMeetings,
minutes: m.totalMinutes,
participants: m.totalParticipants
})),
averageMonthly: {
meetings: Math.round(ytdTotals.totalMeetings / currentMonth),
minutes: Math.round(ytdTotals.totalMinutes / currentMonth),
participants: Math.round(ytdTotals.totalParticipants / currentMonth)
}
};
}
// Compare YTD to previous year
async function getYTDComparison() {
const now = new Date();
const currentYear = now.getFullYear();
const currentMonth = now.getMonth() + 1;
// Get current YTD
const currentYTD = await getYTDUsage();
// Get same period last year (Jan through current month)
const lastYearPromises = [];
for (let month = 1; month <= currentMonth; month++) {
lastYearPromises.push(calculateMonthlyUsage(currentYear - 1, month));
}
const lastYearResults = await Promise.all(lastYearPromises);
const lastYearTotal = lastYearResults.reduce(
(sum, m) => sum + m.totalParticipantMinutes, 0
);
const yearOverYearChange = lastYearTotal > 0
? ((currentYTD.ytdTotals.totalParticipantMinutes - lastYearTotal) / lastYearTotal * 100)
: null;
return {
currentYear: {
year: currentYear,
totalParticipantMinutes: currentYTD.ytdTotals.totalParticipantMinutes
},
previousYear: {
year: currentYear - 1,
totalParticipantMinutes: Math.round(lastYearTotal),
note: `Same period (Jan-${currentMonth})`
},
yearOverYearChange: yearOverYearChange !== null
? yearOverYearChange.toFixed(1) + '%'
: 'N/A (no prior year data)'
};
}
// Project full year usage based on YTD
function projectAnnualUsage(ytdMinutes, currentMonth) {
const monthsRemaining = 12 - currentMonth;
const monthlyAverage = ytdMinutes / currentMonth;
const projectedRemaining = monthlyAverage * monthsRemaining;
const projectedAnnual = ytdMinutes + projectedRemaining;
return {
ytdMinutes: Math.round(ytdMinutes),
projectedAnnualMinutes: Math.round(projectedAnnual),
projectedAnnualCost: estimateMonthlyCost(projectedAnnual),
monthlyAverage: Math.round(monthlyAverage),
confidence: currentMonth >= 6 ? 'high' : currentMonth >= 3 ? 'medium' : 'low'
};
}Usage Dashboard
// Build a usage dashboard
async function getUsageDashboard() {
const now = new Date();
const year = now.getFullYear();
const month = now.getMonth() + 1;
const dayOfMonth = now.getDate();
const daysInMonth = new Date(year, month, 0).getDate();
// Get current month usage
const usage = await calculateMonthlyUsage(year, month);
// Calculate projections
const projection = projectMonthlyUsage(
usage.totalParticipantMinutes,
dayOfMonth,
daysInMonth
);
// Get previous month for comparison
const prevMonth = month === 1 ? 12 : month - 1;
const prevYear = month === 1 ? year - 1 : year;
const previousUsage = await calculateMonthlyUsage(prevYear, prevMonth);
return {
currentMonth: {
period: usage.period,
totalSessions: usage.totalSessions,
totalParticipantMinutes: usage.totalParticipantMinutes,
estimatedCost: estimateMonthlyCost(usage.totalParticipantMinutes)
},
projection: {
projectedMinutes: projection.projectedMonthlyUsage,
projectedCost: projection.projectedCost,
dailyAverage: projection.dailyAverage
},
previousMonth: {
period: previousUsage.period,
totalParticipantMinutes: previousUsage.totalParticipantMinutes,
monthOverMonthChange: (
(usage.totalParticipantMinutes - previousUsage.totalParticipantMinutes) /
previousUsage.totalParticipantMinutes * 100
).toFixed(1) + '%'
},
topSessions: usage.sessions
.sort((a, b) => b.participantMinutes - a.participantMinutes)
.slice(0, 10)
};
}Best Practices
Accurate Tracking
Use webhooks for real-time: More accurate than periodic API polling
Handle reconnections: Participants may disconnect and rejoin
Account for time zones: Store all times in UTC
Deduplicate participants: Same user may rejoin multiple times
Cost Optimization
Monitor daily usage: Set up alerts for unusual spikes
Track by use case: Identify which features consume most minutes
Optimize session duration: Encourage efficient meetings
Review participant patterns: Identify inactive participants
Data Retention
| Data Source | Retention Period |
|---|---|
| Session Quality API | 30 days |
| Reports API (meetings) | 12 months |
| Reports API (participants) | 1 month |
| Webhook events | Store your own |
Related Resources
Video SDK Session Quality: https://developers.zoom.us/docs/video-sdk/session-quality/
Reports API: https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Reports
Usage reporting guide: See
usage-reporting-analytics.mdWebhooks reference: See
webhooksskill
Requirements and compatibility
Written for: OpenAI Codex
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
What our scanner noticed· Medium risk
- Possible data-exfiltration endpoints
- Instructions that use the network
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- Zoom
- Publisher
- OpenAI (Official)
- Distributed by
- OpenAI
- Source
- openai/plugins · plugins/zoom/skills/general · commit d420d13
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from plugins/zoom/LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Zoom or OpenAI.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download zoom-general.zip