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コマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Zipをダウンロード ダウンロード中... 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.
