0
API-Kanäle
0
Sprachen
3.1
OpenAPI-Spezifikation
Kostenlos
zum Starten
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
curl --request GET \
--url https://app.famulor.io/api/v1/calls \
--header 'Authorization: Bearer YOUR_API_TOKEN'// 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()In jedem Stack integrierbar
Vom Outbound-Call-Trigger bis zur vollen Kommunikations-API: Famulor passt sich deinem Produkt an.
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 lesencurl 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}/logoutGuthaben übertragen
Übertrage Credits zwischen deinem Reseller-Guthaben und Kundenkonten.
POST /platform/users/{user_id}/balanceOnboarding konfigurieren
Steuere Registrierung, Prepaid-Standardwerte und Willkommens-Credits über deine Software.
GET · PATCH /platform/default-limitsGET · PATCH /platform/welcome-creditsEigene 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/verifyPer MCP verwalten
Binde Kundenverwaltung und Guthaben als Tools in deinen KI-Client ein.
/mcp?toolsets=platformFür Reseller mit API Access und Owner- oder Admin-Rolle. Kundenverwaltung nutzt platform:read / platform:write, Domains die passenden Settings-Scopes.
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.completedAnruf beendet: Ergebnis & Transkript liegen vor
conversation.endedE-Mail- oder Messaging-Konversation beendet, mit Transkript
booking.createdTermin gebucht, signiert mit HMAC-SHA256
booking.rescheduledTermin verschoben, mit vorheriger Startzeit
{
"event": "call.completed",
"call_id": "call_9f2ac1",
"assistant": "front-desk",
"outcome": "appointment_booked",
"duration_seconds": 96
}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.
// 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
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
npm install -g famulor
famulor login
famulor list-assistants --output table
famulor create-call --assistant-id <id> --to-number +4930123456Sicher 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
# 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)Weiterführende Dokumentation
Bereit zu bauen?
Leg ein kostenloses Konto an und hol dir den API-Schlüssel in wenigen Minuten.