Callforge preview

90-second walkthrough

Architecture

Callforge preview

Callforge is the production SaaS layer for voice-agent products: tenant routing, assistant provisioning, tool dispatch and usage billing around Vapi/Twilio.

It is for builders who already have a voice-agent demo and now need the boring bits that make it sellable.

Stack

→ Node 20+

→ Postgres

→ Vapi

→ Twilio

→ Stripe

What you get

→ Tenant routing

→ Tool dispatch

→ Metered usage

→ Provisioning webhooks

→ Per-tenant prompt overrides

What you don't get

→ Multi-region deploy

→ PII redaction pipeline. Roadmap, not in the founder build.

Sample tenant creation

Example only:

curl -X POST https://api.callforge.dev/v1/tenants \

  -H "Authorization: Bearer $CALLFORGE_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{

    "name": "Acme Dental",

    "slug": "acme-dental",

    "timezone": "Europe/London",

    "phoneProvider": "twilio",

    "assistantTemplate": "inbound-receptionist-v1",

    "promptOverrides": {

      "businessHours": "Mon-Fri 08:30-17:30",

      "handoffNumber": "+44XXXXXXXXXX"

    }

  }'

Sample tool registration

{

  "name": "check_availability",

  "description": "Check open appointment slots for a tenant",

  "method": "POST",

  "url": "https://example.com/api/availability",

  "timeoutMs": 4500,

  "headers": {

    "Authorization": "Bearer {{tenant.secrets.calendar_token}}"

  },

  "inputSchema": {

    "type": "object",

    "required": ["date", "service"],

    "properties": {

      "date": { "type": "string", "format": "date" },

      "service": { "type": "string" }

    }

  }

}

Sample Stripe metered-usage flow

const usage = await callforge.usage.fromCall(callId)

await stripe.billing.meterEvents.create({ event_name: 'call_minutes', payload: usage })

await callforge.events.emit('usage.recorded', { tenantId, callId, usage })

API surface preview

This is the public surface shape, not a full implementation spec.

Endpoints

POST /v1/tenants

Create a tenant and attach default runtime config.

POST /v1/tenants/:id/tools

Register a callable tool for one tenant.

POST /v1/tenants/:id/assistants

Clone an assistant from a template and apply tenant prompt overrides.

POST /v1/webhooks

Subscribe an endpoint to Callforge events.

Events

→ `call.completed`

→ `call.failed`

→ `usage.recorded`