Skip to main content Execute Fireflies.ai production deployment checklist and rollback procedures.
Use when deploying Fireflies.ai integrations to production, preparing for launch,
or implementing go-live procedures.
Trigger with phrases like "fireflies production", "deploy fireflies",
"fireflies go-live", "fireflies launch checklist".
npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill fireflies-prod-checklist ai automation claude-code devops mcp ai-agents
Fireflies.ai Production Checklist
Overview
Complete checklist for deploying Fireflies.ai integrations to production. Covers API key management, webhook setup, health checks, and monitoring.
Prerequisites
Staging environment tested
Production API key from Fireflies dashboard
Webhook endpoint with HTTPS and signature verification
Monitoring infrastructure ready
Pre-Deployment Checklist
API & Auth
Code Quality
require_ai_credits
Webhook Configuration
Health Check Endpoint // /api/health
export async function GET() {
const checks: Record<string, any> = {};
// Fireflies API connectivity
try {
const start = Date.now();
const res = await fetch("https://api.fireflies.ai/graphql", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${process.env.FIREFLIES_API_KEY}`,
},
body: JSON.stringify({ query: "{ user { email } }" }),
signal: AbortSignal.timeout(5000),
});
const json = await res.json();
checks.fireflies = {
status: json.errors ? "error" : "healthy",
latencyMs: Date.now() - start,
error: json.errors?.[0]?.code,
};
} catch (err) {
checks.fireflies = { status: "unreachable", error: (err as Error).message };
}
const allHealthy = Object.values(checks).every((c: any) => c.status === "healthy");
return Response.json(
{ status: allHealthy ? "healthy" : "degraded", checks },
{ status: allHealthy ? 200 : 503 }
);
}
Monitoring & Alerting
Alerting Thresholds Alert Condition Severity Auth failure Any auth_failed error P1 -- API key may be revoked Rate limited 429 errors > 5/min P2 -- backoff or upgrade plan API unreachable Health check fails 3x P1 -- check Fireflies status Webhook backlog Queue > 100 events P3 -- scale webhook processor
Deployment Steps
Step 1: Pre-flight set -euo pipefail
# Verify staging passes
curl -f https://staging.example.com/api/health | jq '.checks.fireflies'
# Verify production API key works
curl -s -X POST https://api.fireflies.ai/graphql \
-H "Authorization: Bearer $FIREFLIES_API_KEY_PROD" \
-H "Content-Type: application/json" \
-d '{"query": "{ user { email is_admin } }"}' | jq .
Step 2: Deploy set -euo pipefail
# Deploy with your platform
# Vercel: vercel --prod
# Docker: docker push && kubectl apply
# Fly.io: fly deploy --app production
# Verify health immediately
curl -f https://production.example.com/api/health | jq .
Step 3: Post-Deploy Verification set -euo pipefail
# Verify webhook is registered
curl -s -X POST https://api.fireflies.ai/graphql \
-H "Authorization: Bearer $FIREFLIES_API_KEY_PROD" \
-H "Content-Type: application/json" \
-d '{"query": "{ user { email } }"}' | jq .
# Test webhook delivery (upload a short audio file)
curl -s -X POST https://api.fireflies.ai/graphql \
-H "Authorization: Bearer $FIREFLIES_API_KEY_PROD" \
-H "Content-Type: application/json" \
-d '{
"query": "mutation($input: AudioUploadInput) { uploadAudio(input: $input) { success message } }",
"variables": { "input": { "url": "https://example.com/test.mp3", "title": "Deploy Test" } }
}' | jq .
Rollback set -euo pipefail
# Immediate rollback
# Platform-specific: revert deployment to previous version
# Verify rollback
curl -f https://production.example.com/api/health | jq '.checks.fireflies'
Error Handling Issue Cause Solution Auth fails post-deploy Wrong API key in production secrets Update secret, redeploy Webhook not firing URL not saved in Fireflies dashboard Re-register at app.fireflies.ai/settings Rate limiting in prod Burst traffic on deploy Enable request queuing Missing transcripts Bot not joining meetings Verify calendar integration is connected
Output
Production deployment with verified health checks
Webhook endpoint receiving and verifying events
Monitoring and alerting configured
Rollback procedure tested
Resources
Next Steps For version upgrades, see fireflies-upgrade-migration.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
