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 커뮤니티가 만든 AI 스킬을 발견하고 탐색하세요.
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 다운로드 다운로드 중... jeremylongshore
jeremylongshore/claude-code-plugins-plus-skills
GitHub 저장소 열기 이 저장소의 다른 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".
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 ). ({ : });
}
{ event_type, data } = req. ;
res. ( ). ({ : });
{
(event_type) {
:
(data);
;
:
(data);
;
:
(data);
;
:
(data);
;
}
} (err) {
. ( , err);
}
}
( ) {
( , {
: ,
: {
: ,
: ,
},
: . ({ : data. }),
});
}
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.