Famulor CLIPara terminal, scripts y agentes de código

Famulor en tu terminal.
Cada operación, un comando.

Crea asistentes, lanza llamadas y gestiona campañas y leads con un comando, en scripts o desde tu agente de código. Tu clave API queda en el llavero del sistema.

Obtener clave APIVer la guía
npm install -g famulor
  • Cada operación de la API
  • JSON, tabla, JSONL
  • Clave en el llavero del sistema
Ejemplo
$ 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 acción

Al reproducir se carga YouTube. Privacidad

Comandos

Cada operación de la API es un comando.

Los comandos se generan desde la especificación OpenAPI. Escribe el nombre de la operación, o un área y un verbo.

Asistentes

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

Llamadas

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

Campañas y leads

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

Números de teléfono

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

Bases de conocimiento

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

Todo lo demás

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

Cada área muestra sus comandos: 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
Salida

Legible para ti. Procesable para scripts.

Una respuesta, tres formatos. Con --all la CLI trae todas las páginas de una lista.

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
Para agentes de código

Tu agente de código conoce cada comando.

Los agentes leen cada esquema de comando en JSON y reciben los errores en un formato procesable. Colores, animación y preguntas se desactivan solos.

Encontrar comandos

famulor commands recording

Leer el esquema

famulor create-call --help --output json

Errores en JSON

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

Funciona en cualquier agente que ejecute comandos

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

Tú: Llama al +49 30 123456 con 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

Agente: Hecho. La llamada está en marcha, estado: queued.

Seguro por defecto

Nada pasa por accidente.

Una pregunta antes de cada borrado, una vista previa de cada petición y una clave que nunca queda en texto plano.

Pregunta antes de borrar

Borrar y las acciones irreversibles, como comprar un número, piden confirmación. En scripts, usa --yes.

Vista previa con --dry-run

Ves el método, la URL, las cabeceras y el cuerpo. La clave se oculta y no se envía nada.

Ninguna llamada doble

Las peticiones que crean algo nunca se repiten tras un timeout. La CLI espera sola los límites de uso.

Clave en el llavero

La clave se verifica antes de guardarse y luego queda en el llavero de macOS, Windows o Linux.

Un perfil por workspace

Guarda un acceso por workspace y cambia con famulor auth switch. En CI basta con FAMULOR_API_KEY.

También en tu dominio

Los partners white-label inician sesión una vez con --base-url. El perfil recuerda el 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 o API

Tres caminos a Famulor. Elige el tuyo.

Los tres trabajan con el mismo workspace y los mismos datos.

Esta página

Famulor CLI

Para terminal, scripts, CI y agentes de código.

  • Un comando por operación
  • JSON, tabla o JSONL
  • Clave en el llavero del sistema
Ver la guía

MCP Connector

Para Claude, ChatGPT y otras herramientas de IA en el chat.

  • Una URL de servidor, acceso OAuth
  • Herramientas de Famulor en el chat
  • Sin instalación local
Ver MCP Connector

REST API

Para tu propio producto y backend.

  • Especificación OpenAPI
  • Webhooks en tiempo real
  • Cualquier lenguaje o framework
Ver referencia API
Todo para desarrolladores
De un vistazo

Una herramienta para toda la plataforma.

Comando por operación

1:1

Generado desde la especificación OpenAPI.

Formatos de salida

3

JSON, tabla y JSON Lines.

Códigos de salida

0–5

Éxito, API, uso, sesión, no encontrado, cancelado.

Shells con completado

3

bash, zsh y fish.

Para empezar

Listo en tres comandos.

Instala, inicia sesión y listo.

  1. 01

    Instalar

    npm install -g famulor. Funciona en macOS, Linux y Windows con Node.js 22 o superior.

  2. 02

    Iniciar sesión

    famulor login te pide la clave API de Settings → API & MCP y la verifica antes de guardarla.

  3. 03

    Empezar

    famulor --help muestra todas las áreas. famulor calls, por ejemplo, lista los comandos de llamadas.

Combina con

Más funciones de la plataforma

Otros módulos que los equipos suelen combinar con esta función.

FAQ

Preguntas antes de salir a live

¿Qué es la Famulor CLI?

La Famulor CLI es la herramienta oficial de línea de comandos de Famulor. Cada operación pública de la API REST es un comando: asistentes, llamadas, campañas, leads, números, bases de conocimiento, automatizaciones y más. La usas en la terminal, en scripts, en CI o desde tu agente de código.

¿Qué necesito para usar la CLI?

Node.js 22 o superior y un plan de workspace con API Access. Se instala con npm install -g famulor. Crea una clave API en el panel en Settings → API & MCP y luego ejecuta famulor login.

¿Dónde se guarda mi clave API?

famulor login verifica la clave con la API antes de guardar nada. Después queda en el llavero de tu sistema: Llavero de macOS, Windows Credential Manager o Linux Secret Service. Sin llavero, se guarda en un archivo que solo tú puedes leer. En CI usa FAMULOR_API_KEY.

¿Puedo usar la CLI con Claude Code, Codex o Cursor?

Sí. famulor commands <tema> devuelve los comandos que coinciden en JSON compacto, y famulor <comando> --help --output json da el esquema completo. En agentes y CI se apagan colores, animación y preguntas. Si algo falla, stdout queda vacío y la última línea de stderr es el error en JSON, con un código de salida claro.

¿Cuándo uso la CLI, el MCP Connector o la API?

La CLI encaja en la terminal, scripts, CI y agentes de código. El MCP Connector lleva Famulor a herramientas de chat como Claude o ChatGPT sin instalar nada. La API REST es para integrar Famulor en tu propio producto. Los tres trabajan con el mismo workspace.

¿Puedo borrar algo por error?

Borrar y las acciones irreversibles, como comprar números, transferencias o restauraciones, piden confirmación en la terminal. En scripts, CI y agentes de código solo se ejecutan con --yes. Con --dry-run ves la petición exacta sin enviar nada.

¿Funciona con varios workspaces y white-label?

Sí. Una clave API pertenece a un solo workspace. Guarda un perfil por workspace con famulor auth login --profile <nombre> y cambia con famulor auth switch. Si usas Famulor con tu propio dominio, inicia sesión una vez con --base-url.

¿La CLI ya es estable?

La CLI es una versión preliminar pública (0.x). Los nombres de los comandos siguen la API y pueden cambiar antes de la 1.0. Un comando renombrado sigue funcionando al menos una versión menor.

Empieza ahora

Tu workspace, a un comando.

Consigue una clave API, instala la CLI y empieza con famulor login.

Obtener clave APIVer la guía

La Famulor CLI es gratuita y tiene licencia MIT. Necesita Node.js 22 o superior y un plan con API Access.