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.

Dokumentation lesenJetzt starten
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: programmatischer Versand über deine Famulor-Rufnummern
  • Webhooks: signierte Post-Call- und Conversation-Ended-Payloads
  • MCP-Server & Famulor Skill: MCP-kompatible KI-Hosts anbinden
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()
Was du bauen kannst

In jedem Stack integrierbar

Vom Outbound-Call-Trigger bis zur vollen Kommunikations-API: Famulor passt sich deinem Produkt an.

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 Anrufereignis reagieren: in Echtzeit

Signierte Webhook-Events an deinen Endpunkt: für jeden Schritt im Anruf. Kein Polling: dein Backend weiß sofort, wenn ein Lead qualifiziert oder ein Termin bestätigt ist.

call.started

Wird ausgelöst, sobald der Anruf verbunden ist

call.variable_extracted

Die KI hat einen wichtigen Datenpunkt erfasst

call.completed

Anruf beendet: Ergebnis & Transkript liegen vor

appointment.created

Termin im Kalender bestätigt

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 MCP-Server (Model Context Protocol) für Claude und andere Hosts. Deine Agenten tätigen Anrufe, senden WhatsApp und verwalten Leads.

stdio-Transport
SSE-Transport
OAuth-2.0-Auth
Vollständiges Tool-Schema
MCP-Server-DokumentationFamulor-Skill-Dokumentation
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)CursorWindsurfClaude Code
Authentifizierung

Sicher per Voreinstellung

Jede API-Anfrage läuft über ein gescoptes Bearer-Token. Webhook-Payloads sind mit HMAC-SHA256 signiert: du prüfst die Echtheit vor der Verarbeitung.

  • Bearer-Token-Authentifizierung: pro Team, rotierbar
  • HMAC-SHA256-Signaturprüfung für Webhooks
  • TLS-Verschlüsselung auf allen Endpunkten
  • IP-Allowlist für Enterprise-Pläne
API-Schlüssel verwalten
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)
Ressourcen

Weiterführende Dokumentation

Bereit zu bauen?

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

Kostenlos testenDemo buchen