Deploy Fireflies.ai webhook receivers and GraphQL clients to Vercel, Docker, and Cloud Run. Use when deploying Fireflies.ai-powered applications to production, configuring platform-specific secrets, or hosting webhook endpoints. Trigger with phrases like "deploy fireflies", "fireflies Vercel", "fireflies production deploy", "fireflies Cloud Run", "fireflies Docker".
72
90%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Low
Low-risk findings worth noting
Deploy Fireflies.ai integrations across platforms. Covers GraphQL client setup, webhook receiver deployment, and secret management for Vercel, Docker, and Google Cloud Run.
FIREFLIES_API_KEY and FIREFLIES_WEBHOOK_SECRET ready// lib/fireflies.ts
const FIREFLIES_API = "https://api.fireflies.ai/graphql";
export async function firefliesQuery(query: string, variables?: any) {
const res = await fetch(FIREFLIES_API, {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${process.env.FIREFLIES_API_KEY}`,
},
body: JSON.stringify({ query, variables }),
});
const json = await res.json();
if (json.errors) throw new Error(json.errors[0].message);
return json.data;
}// app/api/webhooks/fireflies/route.ts
import crypto from "crypto";
export async function POST(req: Request) {
const rawBody = await req.text();
const signature = req.headers.get("x-hub-signature") || "";
// Verify HMAC-SHA256 signature
const expected = crypto
.createHmac("sha256", process.env.FIREFLIES_WEBHOOK_SECRET!)
.update(rawBody)
.digest("hex");
if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) {
return Response.json({ error: "Invalid signature" }, { status: 401 });
}
const event = JSON.parse(rawBody);
if (event.eventType === "Transcription completed") {
// Fetch transcript data
const data = await firefliesQuery(`
query($id: String!) {
transcript(id: $id) {
id title duration
speakers { name }
summary { overview action_items }
}
}
`, { id: event.meetingId });
// Process transcript (store, notify, create tasks)
console.log(`Processed: ${data.transcript.title}`);
}
return Response.json({ received: true });
}set -euo pipefail
# Add secrets
vercel env add FIREFLIES_API_KEY production
vercel env add FIREFLIES_WEBHOOK_SECRET production
# Deploy
vercel --prod
# Register webhook URL in Fireflies dashboard:
# https://your-app.vercel.app/api/webhooks/firefliesFROM node:20-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["node", "dist/index.js"]# docker-compose.yml
services:
fireflies-app:
build: .
ports:
- "3000:3000"
environment:
- FIREFLIES_API_KEY=${FIREFLIES_API_KEY}
- FIREFLIES_WEBHOOK_SECRET=${FIREFLIES_WEBHOOK_SECRET}
restart: unless-stoppedset -euo pipefail
docker compose up -d
# Verify
curl -f http://localhost:3000/api/health | jq .set -euo pipefail
# Build and push
gcloud builds submit --tag gcr.io/$PROJECT_ID/fireflies-app
# Deploy
gcloud run deploy fireflies-app \
--image gcr.io/$PROJECT_ID/fireflies-app \
--platform managed \
--allow-unauthenticated \
--set-env-vars "FIREFLIES_WEBHOOK_SECRET=${FIREFLIES_WEBHOOK_SECRET}" \
--set-secrets "FIREFLIES_API_KEY=fireflies-api-key:latest"
# Get URL for webhook registration
gcloud run services describe fireflies-app --format='value(status.url)'// app/api/health/route.ts (or /health endpoint)
export async function GET() {
try {
const start = Date.now();
const data = await firefliesQuery("{ user { email } }");
return Response.json({
status: "healthy",
fireflies: {
connected: true,
user: data.user.email,
latencyMs: Date.now() - start,
},
});
} catch (err) {
return Response.json({
status: "degraded",
fireflies: { connected: false, error: (err as Error).message },
}, { status: 503 });
}
}After deploying, register your webhook URL:
https://your-app.vercel.app/api/webhooks/fireflies)Or test via API:
set -euo pipefail
# Test API connectivity from deployed app
curl -f https://your-app.vercel.app/api/health | jq .| Issue | Cause | Solution |
|---|---|---|
| GraphQL auth error | API key not set in platform | Add secret via platform CLI |
| Webhook 401 | Secret mismatch | Verify secret matches dashboard |
| Cold start timeout | Serverless cold start + API latency | Increase function timeout to 30s |
| No webhook events | URL not registered | Register at app.fireflies.ai/settings |
For webhook event handling, see fireflies-webhooks-events.
4c47e33
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.