Famulor CLIVoor terminal, scripts en coding agents

Famulor in je terminal.
Elke API-operatie een commando.

Maak assistenten, start gesprekken, beheer campagnes en leads met één commando, in scripts of vanuit je coding agent. Je API-key blijft in de OS-sleutelhanger.

API-key aanmakenLees de docs
npm install -g famulor
  • Elke API-operatie
  • JSON, tabel, JSONL
  • Key in de OS-sleutelhanger
Voorbeeld
$ npm install -g famulor
$ famulor
Famulor CLI
Voice AI agents, straight from your terminal.
$ famulor login
◆  Paste your API key (input hidden):
✓ Logged in
Workspace  Bright Smile Dental
Host  app.famulor.io
Stored in  OS keychain
$ famulor assistants create --name "Front Desk"
✓ Create an assistant · 1153 ms
{
  "data": {
    "id": "3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55",
    "name": "Front Desk",
    "is_active": true,
    "mode": "pipeline",
    "language": "en",
    "created_at": "2026-10-01T09:41:00Z"
  }
}

De Famulor CLI in actie

Afspelen laadt YouTube. Privacy

Commando’s

Elke API-operatie is een commando.

De commando’s komen rechtstreeks uit de OpenAPI-spec. Typ de naam van de operatie, of een gebied plus een werkwoord.

Assistenten

assistants
famulor assistants create --name "Front Desk"
famulor update-assistant <id> --llm-temperature 0.4

Gesprekken

calls
famulor create-call --assistant-id <id> --to-number +4930123456
famulor get-call-recording <call-id> --output-file call.ogg

Campagnes en leads

campaigns
famulor add-leads <campaign-id> --phone +4930123456 --name "Mia"
famulor start-campaign <campaign-id>

Telefoonnummers

phone-numbers
famulor search-available-phone-numbers --country DE
famulor list-phone-numbers --output table

Kennisbanken

knowledge-bases
famulor create-knowledge-base --name "FAQ"
famulor add-knowledge-document <id> --url https://example.com/faq

Al het andere

famulor api
famulor commands recording
famulor api GET /assistants --query limit=5

Elk gebied toont zijn commando’s: famulor <area>

  • assistants
  • calls
  • campaigns
  • leads
  • phone-numbers
  • voices
  • knowledge-bases
  • tools
  • automations
  • bookings
  • messaging
  • sms
  • history
  • integrations
  • widgets
  • translation
  • loop
  • milian
  • qa
  • dashboards
  • segments
  • callbacks
  • suppression
  • caller-ids
  • sip-trunks
  • carrier-connections
  • white-label
  • workspaces
  • api-keys
  • billing
  • settings
  • account
  • catalog
  • migrations
Uitvoer

Leesbaar voor jou. Parseerbaar voor scripts.

Eén antwoord, drie formaten. Met --all haalt de CLI elke pagina van een lijst op.

zsh
famulor list-calls --limit 2 --output table
ID STATUS TO NUMBER DURATION SEC ────────────────────────────────────────────────────────────────────────────── c3a91f-4d2e-4b7a-9c1f-0a1b2c3d4e10 ● completed +1 415 555 0120 142 c3c80e-4d2e-4b7a-9c1f-0a1b2c3d4e11 ● completed +1 415 555 0123 96 2 of 212 · add --all to fetch every page
Voor coding agents

Je coding agent kent elk commando.

Agents lezen elk commandoschema als JSON en krijgen fouten terug in een vorm die ze kunnen parsen. Kleuren, animatie en vragen gaan vanzelf uit.

Commando’s vinden

famulor commands recording

Schema lezen

famulor create-call --help --output json

Fouten als JSON

{"error":{"code","message","status","exit_code"}}

Werkt in elke agent die commando’s uitvoert

  • Claude Code
  • Codex
  • Cursor
  • Gemini CLI
  • Windsurf
  • Warp
  • OpenClaw
  • Hermes
Agent

Jij: Bel +49 30 123456 met Front Desk.

Bash
famulor commands call
Bash
famulor create-call --help --output json
Bash
famulor create-call --assistant-id 3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55 --to-number +4930123456

Agent: Klaar. Het gesprek is gestart, status: queued.

Standaard veilig

Niets gebeurt per ongeluk.

Een vraag vóór elke verwijdering, een voorbeeld van elk verzoek en een key die nooit als platte tekst opgeslagen wordt.

Vraagt eerst, verwijdert dan

Verwijderen en onomkeerbare acties, zoals een nummer kopen, vragen eerst. In scripts bevestig je met --yes.

Voorbeeld met --dry-run

Je ziet methode, URL, headers en body. De key is afgeschermd en er wordt niets verstuurd.

Geen dubbel gesprek

Verzoeken die iets aanmaken worden na een timeout nooit herhaald. Op rate limits wacht de CLI zelf.

Key in de sleutelhanger

De key wordt gecontroleerd vóór opslag en staat dan in de sleutelhanger van macOS, Windows of Linux.

Eén profiel per workspace

Bewaar een login per workspace en wissel met famulor auth switch. In CI volstaat FAMULOR_API_KEY.

Ook op je eigen domein

White-label-partners loggen één keer in met --base-url. Het profiel onthoudt de host.

zsh
famulor delete-assistant 3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55
! Delete an assistant "Front Desk" (3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55) in Bright Smile Dental on app.famulor.io? This cannot be undone. [y/N] n
✗ Cancelled. Nothing was deleted.
famulor create-call --assistant-id 3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55 --to-number +4930123456 --dry-run
{ "command": "create-call", "operation_id": "createCall", "method": "POST", "url": "https://app.famulor.io/api/v1/calls", "headers": { "Authorization": "Bearer fam_[REDACTED]", "Content-Type": "application/json" }, "body": { "assistant_id": "3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55", "to_number": "+4930123456" } }
CLI, MCP of API

Drie wegen naar Famulor. Kies wat past.

Alle drie werken met dezelfde workspace en dezelfde data.

Deze pagina

Famulor CLI

Voor terminal, scripts, CI en coding agents.

  • Eén commando per operatie
  • JSON, tabel of JSONL
  • Key in de OS-sleutelhanger
Lees de docs

MCP Connector

Voor Claude, ChatGPT en andere AI-tools in de chat.

  • Eén server-URL, inloggen via OAuth
  • Famulor-tools direct in de chat
  • Niets lokaal te installeren
Naar MCP Connector

REST API

Voor je eigen product en backend.

  • OpenAPI-specificatie
  • Realtime webhooks
  • Elke taal, elk framework
Naar API-referentie
Alles voor ontwikkelaars
In één oogopslag

Eén tool voor het hele platform.

Commando per operatie

1:1

Gegenereerd uit de OpenAPI-spec.

Uitvoerformaten

3

JSON, tabel en JSON Lines.

Duidelijke exitcodes

0–5

Gelukt, API, gebruik, login, niet gevonden, geannuleerd.

Shells met completion

3

bash, zsh en fish.

Aan de slag

Klaar in drie commando’s.

Installeren, inloggen, aan de slag.

  1. 01

    Installeren

    npm install -g famulor. Draait op macOS, Linux en Windows met Node.js 22 of nieuwer.

  2. 02

    Inloggen

    famulor login vraagt om je API-key uit Settings → API & MCP en controleert hem vóór het opslaan.

  3. 03

    Aan de slag

    famulor --help toont alle gebieden. famulor calls toont bijvoorbeeld elk commando voor gesprekken.

Werkt samen met

Meer uit het platform

Andere onderdelen die teams meestal combineren met deze functie.

FAQ

Vragen vóór go-live

Wat is de Famulor CLI?

De Famulor CLI is de officiële command-line tool van Famulor. Elke openbare REST API-operatie is een commando: assistenten, gesprekken, campagnes, leads, telefoonnummers, kennisbanken, automatiseringen en meer. Je gebruikt hem in de terminal, in scripts, in CI of via je coding agent.

Wat heb ik nodig om de CLI te gebruiken?

Node.js 22 of nieuwer en een workspace-abonnement met API Access. Installeren doe je met npm install -g famulor. Maak een API-key aan in het dashboard onder Settings → API & MCP en voer daarna famulor login uit.

Waar wordt mijn API-key opgeslagen?

famulor login controleert de key bij de API voordat er iets wordt opgeslagen. Daarna staat hij in de sleutelhanger van je systeem: macOS-sleutelhanger, Windows Credential Manager of Linux Secret Service. Zonder sleutelhanger komt hij in een bestand dat alleen jij kunt lezen. In CI zet je FAMULOR_API_KEY.

Kan ik de CLI gebruiken met Claude Code, Codex of Cursor?

Ja. famulor commands <onderwerp> geeft passende commando’s als compacte JSON, en famulor <commando> --help --output json het volledige schema. In agents en CI gaan kleuren, animatie en vragen uit. Bij een fout blijft stdout leeg en is de laatste regel op stderr de fout als JSON, met een duidelijke exitcode.

Wanneer gebruik ik de CLI, de MCP Connector of de API?

De CLI past bij terminal, scripts, CI en coding agents. De MCP Connector brengt Famulor naar chattools zoals Claude of ChatGPT, zonder installatie. De REST API gebruik je als je Famulor in je eigen product bouwt. Alle drie werken met dezelfde workspace.

Kan ik per ongeluk iets verwijderen?

Verwijderen en onomkeerbare acties zoals nummers kopen, overdrachten of herstellen vragen in de terminal om bevestiging. In scripts, CI en coding agents draaien ze alleen met --yes. Met --dry-run zie je het exacte verzoek en wordt er niets verstuurd.

Werkt het met meerdere workspaces en white-label?

Ja. Een API-key hoort bij precies één workspace. Bewaar per workspace een profiel met famulor auth login --profile <naam> en wissel met famulor auth switch. Gebruik je Famulor op je eigen domein, log dan één keer in met --base-url.

Is de CLI al stabiel?

De CLI is een public preview (versie 0.x). Commandonamen volgen de API en kunnen vóór 1.0 nog veranderen. Een hernoemd commando blijft minstens één minor-versie werken.

Aan de slag

Je workspace, één commando verderop.

Maak een API-key aan, installeer de CLI en begin met famulor login.

API-key aanmakenLees de docs

De Famulor CLI is gratis en MIT-gelicentieerd. Je hebt Node.js 22 of nieuwer nodig en een abonnement met API Access.