Skip to main content
instantly-deploy-integration Deploy Instantly.ai webhook receivers and API integrations to cloud platforms.
Use when deploying to Vercel, Cloud Run, or Fly.io,
or setting up production webhook endpoints.
Trigger with phrases like "deploy instantly", "instantly cloud run",
"instantly vercel", "instantly webhook deployment", "instantly production deploy".
跳到安装 Skills Marketplace 发现并探索由社区构建的 Agent Skills
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill instantly-deploy-integration命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
下载 Zip 下载中... 同仓库更多 Skills Implement user sign-up and sign-in flows with Clerk.
Use when building authentication UI, customizing sign-in experience,
or implementing OAuth social login.
Trigger with phrases like "clerk sign-in", "clerk sign-up",
"clerk login flow", "clerk OAuth", "clerk social login".
Implement session management and middleware with Clerk.
Use when managing user sessions, configuring route protection,
or implementing token refresh and custom JWT templates.
Trigger with phrases like "clerk session", "clerk middleware",
"clerk route protection", "clerk token", "clerk JWT".
Configure enterprise SSO, role-based access control, and organization management.
Use when implementing SSO integration, configuring role-based permissions,
or setting up organization-level controls.
Trigger with phrases like "clerk SSO", "clerk RBAC",
"clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".
jeremylongshore
jeremylongshore/claude-code-plugins-plus-skills
打开 GitHub 仓库 name instantly-deploy-integration description Deploy Instantly.ai webhook receivers and API integrations to cloud platforms.
Use when deploying to Vercel, Cloud Run, or Fly.io,
or setting up production webhook endpoints.
Trigger with phrases like "deploy instantly", "instantly cloud run",
"instantly vercel", "instantly webhook deployment", "instantly production deploy".
allowed-tools Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep version 1.12.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","instantly","deployment","vercel","cloud-run"] compatibility Designed for Claude Code, also compatible with Codex and OpenClaw
Instantly Deploy Integration
Overview
Deploy Instantly API v2 integrations — primarily webhook receivers and automation services — to cloud platforms. Instantly webhooks require a public HTTPS endpoint that responds within 30 seconds (3 retries on failure). This skill covers Vercel serverless functions, Google Cloud Run containers, and Fly.io deployments.
Prerequisites
Completed instantly-install-auth setup
Working Instantly integration tested locally (see instantly-local-dev-loop)
Cloud platform account (Vercel, GCP, or Fly.io)
Domain or HTTPS URL for webhook endpoint
Instructions
Option A: Vercel Serverless Functions
import type { VercelRequest , VercelResponse } from "@vercel/node" ;
export default async function handler (req : VercelRequest , res : VercelResponse if (req.method !== "POST" ) {
return res.status (405 ).json ({ error : "Method not allowed" });
}
const secret = req.headers ["x-webhook-secret" ];
if (secret !== process.env .INSTANTLY_WEBHOOK_SECRET ) {
return res.status (401 ).json
error
"Unauthorized"
const
body
status
200
json
received
true
try
switch
case
"reply_received"
await
syncReplyToCRM
break
case
"email_bounced"
await
handleBounce
break
case
"lead_interested"
await
notifySalesTeam
break
case
"lead_unsubscribed"
await
addToBlockList
break
catch
console
error
`Webhook processing error: ${event_type} `
async
function
addToBlockList
data : { lead_email: string }
await
fetch
"https://api.instantly.ai/api/v2/block-lists-entries"
method
"POST"
headers
Authorization
`Bearer ${process.env.INSTANTLY_API_KEY} `
"Content-Type"
"application/json"
body
JSON
stringify
bl_value
lead_email
vercel env add INSTANTLY_API_KEY
vercel env add INSTANTLY_WEBHOOK_SECRET
vercel deploy --prod
Option B: Google Cloud Run # Dockerfile
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --production=false
COPY . .
RUN npm run build
FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
COPY package*.json ./
EXPOSE 8080
ENV PORT=8080
CMD ["node", "dist/server.js"]
import express from "express" ;
import { instantly } from "./instantly" ;
const app = express ();
app.use (express.json ());
app.get ("/health" , (_, res ) => res.json ({ status : "ok" }));
app.post ("/webhooks/instantly" , async (req, res) => {
const secret = req.headers ["x-webhook-secret" ];
if (secret !== process.env .INSTANTLY_WEBHOOK_SECRET ) {
return res.status (401 ).json ({ error : "Unauthorized" });
}
res.status (200 ).json ({ received : true });
const { event_type, data } = req.body ;
console .log (`Webhook: ${event_type} ` , JSON .stringify (data).slice (0 , 200 ));
if (event_type === "reply_received" ) {
await instantly ("/leads/update-interest-status" , {
method : "POST" ,
body : JSON .stringify ({
lead_email : data.lead_email ,
campaign_id : data.campaign_id ,
interest_value : 1 ,
}),
});
}
});
const PORT = process.env .PORT || 8080 ;
app.listen (PORT , () => console .log (`Listening on port ${PORT} ` ));
set -euo pipefail
gcloud run deploy instantly-webhooks \
--source . \
--region us-central1 \
--allow-unauthenticated \
--set-env-vars "INSTANTLY_API_KEY=${INSTANTLY_API_KEY} ,INSTANTLY_WEBHOOK_SECRET=${INSTANTLY_WEBHOOK_SECRET} " \
--min-instances 1 \
--max-instances 10 \
--memory 256Mi \
--cpu 1
Option C: Fly.io
app = "instantly-webhooks"
primary_region = "iad"
[build]
dockerfile = "Dockerfile"
[http_service]
internal_port = 8080
force_https = true
auto_stop_machines = true
auto_start_machines = true
min_machines_running = 1
[env]
NODE_ENV = "production"
set -euo pipefail
fly launch --name instantly-webhooks
fly secrets set INSTANTLY_API_KEY="your-key" INSTANTLY_WEBHOOK_SECRET="your-secret"
fly deploy
Step 2: Register Webhook After Deployment async function registerProductionWebhook (deployedUrl : string const webhook = await instantly<{ id : string ; name : string }>("/webhooks" , {
method : "POST" ,
body : JSON .stringify ({
name : "Production CRM Sync" ,
target_hook_url : `${deployedUrl} /webhooks/instantly` ,
event_type : "all_events" ,
headers : {
"X-Webhook-Secret" : process.env .INSTANTLY_WEBHOOK_SECRET ,
},
}),
});
console .log (`Webhook registered: ${webhook.id} ` );
await instantly (`/webhooks/${webhook.id} /test` , { method : "POST" });
console .log ("Test webhook sent — check your endpoint logs" );
}
Step 3: Post-Deploy Verification set -euo pipefail
DEPLOY_URL="https://instantly-webhooks-abc123.run.app"
curl -s ${DEPLOY_URL} /health | jq .
curl -X POST ${DEPLOY_URL} /webhooks/instantly \
-H "Content-Type: application/json" \
-H "X-Webhook-Secret: ${INSTANTLY_WEBHOOK_SECRET} " \
-d '{"event_type":"reply_received","data":{"lead_email":"test@example.com"}}'
Error Handling Error Cause Solution Webhook delivery fails Endpoint returns non-2xx Ensure 200 response before async processing Cold start timeout Serverless function too slow Set min-instances=1 or use always-on Secret not available Env var not set Verify with fly secrets list or cloud console Webhook retries flooding Processing takes >30s Return 200 immediately, process async
Resources
Next Steps For webhook event handling patterns, see instantly-webhooks-events.
