Developer Platform

Famulor AI in dein Produkt einbauen

REST-API für Anrufe, WhatsApp, SMS und Messaging, plus MCP-Server, Echtzeit-Webhooks und Dashboard-Einbettung. KI-Kommunikation in wenigen Minuten in jedes Produkt.

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-Kanäle

0

Sprachen

3.1

OpenAPI-Spezifikation

Kostenlos

zum Starten

API Explorer

Eine Plattform, jeder Kanal

Eine HTTP-API plus Webhooks und MCP: Anrufe, Assistenten, WhatsApp Business, SMS, Nummern & SIP, Kampagnen und Leads.

  • Anrufe & Kampagnen: Outbound-/Inbound-Lebenszyklus, Status, Integrationen
  • Assistenten & Wissensdatenbanken: Prompts, Stimmen, Modelle, KB-Dokumente
  • Konversationen & KI-Antworten: Chat-Sessions, Messaging, Übergabe an Menschen
  • WhatsApp Business: Absender, Vorlagen, Sessions innerhalb des 24-Stunden-Fensters
  • SMS: Versand per API, Zwei-Wege-Konversationen mit KI-Antworten, Verlauf und manuellen Antworten
  • Webhooks: Post-Call-, Conversation-Ended- und signierte Booking-Payloads
  • MCP-Server & Famulor Skill: MCP-kompatible KI-Hosts anbinden
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

Deine Plattform. Deine Kunden.

Baue dein eigenes Kundenportal. Lege Konten an, steuere Zugänge und übertrage Credits per API. Auf deiner Domain bleiben die API-Pfade gleich.

White-Label-Doku lesen
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"
  }'

Kunden anlegen

Registriere Endkunden samt Workspace und rufe ihre Kontoübersicht ab.

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

Zugänge steuern

Stelle Kunden-Tokens aus, binde einen Login an und widerrufe Zugänge bei Bedarf.

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

Guthaben übertragen

Übertrage Credits zwischen deinem Reseller-Guthaben und Kundenkonten.

POST /platform/users/{user_id}/balance

Onboarding konfigurieren

Steuere Registrierung, Prepaid-Standardwerte und Willkommens-Credits über deine Software.

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

Eigene Domain verbinden

Füge deine Domain hinzu, erhalte DNS-Einträge und prüfe die Aktivierung per API.

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

Per MCP verwalten

Binde Kundenverwaltung und Guthaben als Tools in deinen KI-Client ein.

/mcp?toolsets=platform

Für Reseller mit API Access und Owner- oder Admin-Rolle. Kundenverwaltung nutzt platform:read / platform:write, Domains die passenden Settings-Scopes.

Webhooks

Auf jedes Ergebnis reagieren, in Echtzeit

Webhook-Events an deinen Endpunkt, sobald ein Anruf oder eine Konversation endet oder ein Termin gebucht wird. Kein Polling: dein Backend weiß sofort, wenn ein Lead qualifiziert oder ein Termin bestätigt ist.

call.completed

Anruf beendet: Ergebnis & Transkript liegen vor

conversation.ended

E-Mail- oder Messaging-Konversation beendet, mit Transkript

booking.created

Termin gebucht, signiert mit HMAC-SHA256

booking.rescheduled

Termin verschoben, mit vorheriger Startzeit

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

Deinem KI-Agenten eine echte Telefonleitung geben

Ein gehosteter MCP-Server für Claude, ChatGPT, Cursor und andere Hosts, dazu das offizielle Famulor-Plugin in ChatGPT und Codex. Deine Agenten tätigen Anrufe, senden WhatsApp, verwalten Leads und fragen Milian.

Gehosteter HTTPS-Endpunkt
OAuth 2.0 pro Workspace
Freigabe pro Tool-Gruppe
Plugin für 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' },
  }],
});

Kompatibel mit

Claude (Anthropic)ChatGPTCodexCursorWindsurfClaude Code
Famulor CLI

Die ganze API im Terminal

Jede API-Operation als Befehl, mit Ausgabe als JSON, Tabelle oder JSONL. Für Skripte, CI und Coding-Agents wie Claude Code oder Codex.

  • API-Key im OS-Schlüsselbund
  • --dry-run und Rückfrage vor jedem Löschen
  • Befehlsschema als JSON für Agents
Shell · Famulor CLI
npm install -g famulor
famulor login
famulor list-assistants --output table
famulor create-call --assistant-id <id> --to-number +4930123456
Authentifizierung

Sicher per Voreinstellung

Jede API-Anfrage läuft über ein Bearer-Token: einen Workspace-API-Key mit eigenen Scopes und Ablaufdatum oder ein OAuth-2.0-Token. Booking-Webhooks sind mit HMAC-SHA256 signiert, damit du die Echtheit vor der Verarbeitung prüfst.

  • Workspace-API-Keys mit eigenen Rechten und Ablaufdatum
  • OAuth 2.0 mit PKCE für Apps im Namen von Nutzern
  • HMAC-SHA256-Signaturen für Booking-Webhooks
  • TLS-Verschlüsselung auf allen Endpunkten
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)

Bereit zu bauen?

Leg ein kostenloses Konto an und hol dir den API-Schlüssel in wenigen Minuten.