Developer Platform

Bouw met Famulor AI in je product

REST-API voor calls, WhatsApp, sms en messaging, plus MCP-server, realtime webhooks en dashboard-embedding. AI-communicatie in minuten, in elk product.

calls.create.ts
POST /v1/calls
{
  "assistant_id": "front-desk",
  "to": "+1555010148"
}

→ 202 Accepted
{ "call_id": "call_9f2ac1" }
call.completed
Webhook delivered
MCP server online

0

API-kanalen

0

talen

3.1

OpenAPI-specificatie

Gratis

om te starten

API Explorer

Eén platform, elk kanaal

Eén HTTP-API plus webhooks en MCP: calls, assistenten, WhatsApp Business, sms, nummers & SIP, campagnes en leads.

  • Calls & campagnes: outbound-/inboundlevenscyclus, statussen, integraties
  • Assistenten & kennisbanken: prompts, stemmen, modellen, KB-documenten
  • Gesprekken & AI-antwoorden: chatsessies, messaging, overdracht naar mens
  • WhatsApp Business: afzenders, templates, sessies binnen het 24-uursvenster
  • Sms: versturen via API, tweerichtingsgesprekken met AI-antwoorden, geschiedenis en handmatige antwoorden
  • Webhooks: post-call-, conversation-ended- en ondertekende boekingspayloads
  • MCP-server & Famulor Skill: verbind MCP-compatibele AI-hosts
Shell · Quick start (cURL)
curl --request GET \
  --url https://app.famulor.io/api/v1/calls \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
JavaScript · Voice API
// List your AI calls (User API)
const res = await fetch('https://app.famulor.io/api/v1/calls', {
  headers: {
    Authorization: 'Bearer YOUR_API_TOKEN',
    Accept: 'application/json',
  },
})
const payload = await res.json()
White-label-API

Jouw platform. Jouw klanten.

Bouw je eigen klantportaal. Maak accounts aan, beheer toegang en draag credits over via de API. Op je eigen domein blijven de API-paden gelijk.

Lees de white-label-docs
POST /api/v1/platform/users
curl https://your-domain.example/api/v1/platform/users \
  --request POST \
  --header "Authorization: Bearer $FAMULOR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Alex Example",
    "email": "alex@customer.example",
    "mode": "invite"
  }'

Klantaccounts aanmaken

Registreer klanten met een eigen workspace en haal hun accountoverzicht op.

GET · POST /platform/usersGET /platform/users/{user_id}

Toegang beheren

Geef klanttokens uit, koppel een inlogproces en trek toegang in wanneer dat nodig is.

POST /platform/users/{user_id}/tokenPOST /platform/users/loginPOST /platform/users/{user_id}/logout

Credits overdragen

Verplaats credits tussen je resellersaldo en de accounts van je klanten.

POST /platform/users/{user_id}/balance

Onboarding instellen

Beheer registratie, prepaidinstellingen en welkomstcredits vanuit je software.

GET · PATCH /platform/default-limitsGET · PATCH /platform/welcome-credits

Je domein koppelen

Voeg je domein toe, ontvang DNS-records en controleer de activering via de API.

GET · POST · DELETE /custom-domainPOST /custom-domain/verify

Beheren via MCP

Koppel tools voor klantbeheer en credits aan je AI-client.

/mcp?toolsets=platform

Voor resellers met API Access en een Owner- of Admin-rol. Klantbeheer gebruikt platform:read / platform:write; domeinen gebruiken de bijbehorende settings-scopes.

Webhooks

Reageer op elk resultaat, in realtime

Webhook-events naar je endpoint zodra een call of gesprek eindigt of er een boeking binnenkomt. Geen polling: je backend weet meteen of een lead is gekwalificeerd of een afspraak is bevestigd.

call.completed

Call beëindigd: resultaat & transcript gereed

conversation.ended

E-mail- of messaginggesprek beëindigd, met transcript

booking.created

Boeking gemaakt, ondertekend met HMAC-SHA256

booking.rescheduled

Boeking verplaatst, met de vorige starttijd

webhook.payload.json
{
  "event": "call.completed",
  "call_id": "call_9f2ac1",
  "assistant": "front-desk",
  "outcome": "appointment_booked",
  "duration_seconds": 96
}
MCP-integratie

Geef je AI-agent een echte telefoonlijn

Een gehoste MCP-server voor Claude, ChatGPT, Cursor en andere hosts, plus de officiële Famulor-plugin in ChatGPT en Codex. Je agenten bellen, sturen WhatsApp, beheren leads en vragen Milian.

Gehost HTTPS-endpoint
OAuth 2.0 per workspace
Akkoord per toolgroep
Plugin voor ChatGPT & Codex
JavaScript · Claude + Famulor MCP
// Connect Famulor as an MCP server
const client = new Anthropic();

const response = await client.messages.create({
  model: 'claude-opus-4-6',
  max_tokens: 1024,
  tools: [{
    type: 'mcp',
    server_label: 'famulor',
    server_url:   'https://app.famulor.io/mcp',
    headers:      { Authorization: 'Bearer YOUR_API_TOKEN' },
  }],
});

Compatibel met

Claude (Anthropic)ChatGPTCodexCursorWindsurfClaude Code
Famulor CLI

De hele API in je terminal

Elke API-operatie als commando, met uitvoer als JSON, tabel of JSONL. Voor scripts, CI en coding agents zoals Claude Code of Codex.

  • API-key in de OS-sleutelhanger
  • --dry-run en een vraag vóór elke verwijdering
  • Commandoschema’s als JSON voor agents
Shell · Famulor CLI
npm install -g famulor
famulor login
famulor list-assistants --output table
famulor create-call --assistant-id <id> --to-number +4930123456
Authenticatie

Standaard beveiligd

Elk API-verzoek gebruikt een Bearer-token: een workspace-API-key met eigen scopes en vervaldatum, of een OAuth 2.0-token. Boekingswebhooks zijn ondertekend met HMAC-SHA256, zodat je de echtheid vóór verwerking verifieert.

  • Workspace-API-keys met eigen rechten en vervaldatum
  • OAuth 2.0 met PKCE voor apps namens gebruikers
  • TLS-versleuteling op alle endpoints
  • HMAC-SHA256-handtekeningen op boekingswebhooks
Shell + Python · Auth examples
# Bearer token
curl --request GET \
  --url https://app.famulor.io/api/v1/calls \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

# Verify a booking webhook signature (X-Famulor-Signature: sha256=<hex>)
import hmac, hashlib

def verify_signature(payload: bytes, sig: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig)

Klaar om te bouwen?

Maak gratis een account aan en ontvang je API-sleutel binnen enkele minuten.