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: programmatisch verzenden vanaf je Famulor-telefoonnummers
  • Webhooks: ondertekende post-call- en conversation-ended-payloads
  • MCP-server & Famulor Skill: verbind MCP-compatibele AI-hosts
Shell · Quick start (cURL)
curl --request GET \
  --url https://app.famulor.io/api/user/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 call-event, in realtime

Ondertekende webhook-events naar je endpoint bij elke stap van de call. Geen polling: je backend weet meteen of een lead is gekwalificeerd of een afspraak is bevestigd.

call.started

Wordt afgevuurd zodra de call verbindt

call.variable_extracted

AI heeft een belangrijk gegevenspunt vastgelegd

call.completed

Call beëindigd: resultaat & transcript gereed

appointment.created

Afspraak bevestigd in je agenda

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 MCP-server (Model Context Protocol) voor Claude en andere hosts. Je agenten bellen, sturen WhatsApp en beheren leads.

stdio-transport
SSE-transport
OAuth 2.0-auth
Volledig tool-schema
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)CursorWindsurfClaude Code
Authenticatie

Standaard beveiligd

Elk API-verzoek gebruikt een gescopet Bearer-token. Webhook-payloads zijn ondertekend met HMAC-SHA256: je verifieert de echtheid vóór verwerking.

  • Bearer-token-authenticatie: per team, roteerbaar
  • HMAC-SHA256-signatuurverificatie voor webhooks
  • TLS-versleuteling op alle endpoints
  • IP-allowlist-ondersteuning op enterprise-plannen
Shell + Python · Auth examples
# Bearer token
curl --request GET \
  --url https://app.famulor.io/api/user/calls \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

# Verify a webhook signature
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.