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".
84
82%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
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.
4dee593
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.