Voiceflow Webhook DB

Local webhook receiver for Voiceflow call events with SQLite storage.

Endpoints

1. POST /webhook
2. GET /health

Run locally with Docker (Postgres)

cd /Users/optimystic/Documents/New\ project
docker compose up --build

Expose with ngrok (option A)

1. Create an ngrok account and copy your authtoken.
2. Create .env from .env.example.
3. Start the tunnel.

cd /Users/optimystic/Documents/New\ project
docker compose --profile ngrok up --build

Your public URL will be visible in ngrok's container logs. The webhook URL will be: https://YOUR_NGROK_SUBDOMAIN.ngrok-free.app/webhook

Expose with cloudflared (option B)

1. Install cloudflared locally.
2. Start a tunnel that points to your local container.

cd /Users/optimystic/Documents/New\ project
docker compose up --build
cloudflared tunnel --url http://localhost:3000

Your public URL will be printed by cloudflared. The webhook URL will be: https://<random>.trycloudflare.com/webhook

Railway Postgres

1. Add a Postgres service in Railway.
2. Set DATABASE_URL on the web service to the Postgres connection string.
3. Redeploy the web service.