Famulor CLIPour le terminal, les scripts et les agents de code

Famulor dans votre terminal.
Chaque opération, une commande.

Créez des assistants, lancez des appels, gérez campagnes et leads en une commande, dans vos scripts ou depuis votre agent de code. Votre clé API reste dans le trousseau.

Obtenir une clé APILire la doc
npm install -g famulor
  • Chaque opération d’API
  • JSON, tableau, JSONL
  • Clé dans le trousseau système
Exemple
$ 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"
  }
}

La Famulor CLI en action

La lecture charge YouTube. Confidentialité

Commandes

Chaque opération d’API est une commande.

Les commandes sont générées depuis la spécification OpenAPI. Tapez le nom de l’opération, ou un domaine suivi d’un verbe.

Assistants

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

Appels

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

Campagnes et leads

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

Numéros de téléphone

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

Bases de connaissances

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

Tout le reste

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

Chaque domaine liste ses commandes: 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
Sortie

Lisible pour vous. Exploitable par vos scripts.

Une réponse, trois formats. Avec --all, la CLI récupère toutes les pages d’une liste.

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
Pour les agents de code

Votre agent de code connaît les commandes.

Les agents lisent chaque schéma de commande en JSON et reçoivent les erreurs dans un format exploitable. Couleurs, animation et questions se coupent d’elles-mêmes.

Trouver les commandes

famulor commands recording

Lire le schéma

famulor create-call --help --output json

Erreurs en JSON

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

Fonctionne dans tout agent qui exécute des commandes

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

Vous: Appelle le +49 30 123456 avec 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: C’est fait. L’appel est lancé, statut : queued.

Sûr par défaut

Rien ne se passe par accident.

Une question avant chaque suppression, un aperçu de chaque requête et une clé jamais stockée en clair.

Demande avant de supprimer

Suppressions et actions irréversibles, comme l’achat d’un numéro, demandent confirmation. En script : --yes.

Aperçu avec --dry-run

Vous voyez méthode, URL, en-têtes et corps. La clé est masquée et rien n’est envoyé.

Aucun appel en double

Une requête qui crée quelque chose n’est jamais relancée après un timeout. La CLI attend seule les quotas.

Clé dans le trousseau

La clé est vérifiée avant d’être enregistrée, puis gardée dans le trousseau macOS, Windows ou Linux.

Un profil par espace

Un accès par espace de travail, bascule avec famulor auth switch. En CI, FAMULOR_API_KEY suffit.

Aussi sur votre domaine

Les partenaires white-label se connectent une fois avec --base-url. Le profil retient l’hôte.

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 ou API

Trois accès à Famulor. Choisissez le bon.

Les trois travaillent sur le même espace de travail et les mêmes données.

Cette page

Famulor CLI

Pour le terminal, les scripts, la CI et les agents de code.

  • Une commande par opération
  • JSON, tableau ou JSONL
  • Clé dans le trousseau système
Lire la doc

MCP Connector

Pour Claude, ChatGPT et d’autres outils d’IA dans le chat.

  • Une URL de serveur, connexion OAuth
  • Les outils Famulor dans le chat
  • Rien à installer en local
Voir MCP Connector

REST API

Pour votre propre produit et backend.

  • Spécification OpenAPI
  • Webhooks en temps réel
  • Tout langage, tout framework
Référence API
Tout pour les développeurs
En un coup d’œil

Un outil pour toute la plateforme.

Commande par opération

1:1

Générée depuis la spécification OpenAPI.

Formats de sortie

3

JSON, tableau et JSON Lines.

Codes de sortie

0–5

Succès, API, usage, connexion, introuvable, annulé.

Shells avec complétion

3

bash, zsh et fish.

Pour commencer

Prêt en trois commandes.

Installer, se connecter, c’est parti.

  1. 01

    Installer

    npm install -g famulor. Fonctionne sur macOS, Linux et Windows avec Node.js 22 ou plus.

  2. 02

    Se connecter

    famulor login demande votre clé API depuis Settings → API & MCP et la vérifie avant de l’enregistrer.

  3. 03

    C’est parti

    famulor --help affiche tous les domaines. famulor calls, par exemple, liste les commandes d’appels.

Fonctionne avec

Plus dans la plateforme

D’autres briques que les équipes associent souvent à celle-ci.

FAQ

Questions avant le go-live

Qu’est-ce que la Famulor CLI ?

La Famulor CLI est l’outil officiel en ligne de commande de Famulor. Chaque opération publique de l’API REST est une commande : assistants, appels, campagnes, leads, numéros, bases de connaissances, automatisations et plus. Utilisez-la dans le terminal, vos scripts, la CI ou via votre agent de code.

De quoi ai-je besoin pour utiliser la CLI ?

Node.js 22 ou plus et une offre avec API Access. L’installation se fait avec npm install -g famulor. Créez une clé API dans le tableau de bord sous Settings → API & MCP, puis lancez famulor login.

Où ma clé API est-elle stockée ?

famulor login vérifie la clé auprès de l’API avant tout enregistrement. Elle est ensuite stockée dans le trousseau du système : Trousseau macOS, Windows Credential Manager ou Linux Secret Service. Sans trousseau, elle va dans un fichier lisible par vous seul. En CI, utilisez FAMULOR_API_KEY.

Puis-je utiliser la CLI avec Claude Code, Codex ou Cursor ?

Oui. famulor commands <sujet> renvoie les commandes correspondantes en JSON compact, et famulor <commande> --help --output json donne le schéma complet. Couleurs, animation et questions se coupent dans les agents et la CI. En cas d’échec, stdout reste vide et la dernière ligne de stderr est l’erreur en JSON, avec un code de sortie clair.

Quand utiliser la CLI, le MCP Connector ou l’API ?

La CLI convient au terminal, aux scripts, à la CI et aux agents de code. Le MCP Connector amène Famulor dans des outils de chat comme Claude ou ChatGPT, sans rien installer. L’API REST sert à intégrer Famulor dans votre propre produit. Les trois travaillent sur le même espace de travail.

Puis-je supprimer quelque chose par erreur ?

Suppressions et actions irréversibles, comme l’achat de numéros, les transferts ou les restaurations, demandent confirmation dans le terminal. Dans les scripts, la CI et les agents de code, elles ne s’exécutent qu’avec --yes. Avec --dry-run, vous voyez la requête exacte sans rien envoyer.

Est-ce compatible avec plusieurs espaces et le white-label ?

Oui. Une clé API appartient à un seul espace de travail. Enregistrez un profil par espace avec famulor auth login --profile <nom> et basculez avec famulor auth switch. Si vous utilisez Famulor sur votre propre domaine, connectez-vous une fois avec --base-url.

La CLI est-elle déjà stable ?

La CLI est en préversion publique (version 0.x). Les noms de commandes suivent l’API et peuvent encore changer avant la 1.0. Une commande renommée continue de fonctionner pendant au moins une version mineure.

Commencer

Votre espace de travail, à une commande.

Obtenez une clé API, installez la CLI et lancez famulor login.

Obtenir une clé APILire la doc

La Famulor CLI est gratuite et sous licence MIT. Elle nécessite Node.js 22 ou plus et une offre avec API Access.