Famulor

Get the authenticated Famulor user profile, including total balance.

List all AI assistants on the Famulor account (paginated). Returns the assistant configurations including their fixed variable names.

List all outbound-capable assistants.

List phone numbers eligible to be attached to an assistant (filter by inbound/outbound).

List available LLM / multimodal / dualplex model IDs.

List voices compatible with a given engine mode and optional language.

List all supported assistant languages.

List custom TTS providers selectable on an assistant.

List custom STT providers selectable on a pipeline assistant.

Create a new AI assistant. Required: name, voice_id, language_id, type, mode, timezone, initial_message, system_prompt, and either llm_model_id (pipeline) or multimodal_model_id (multimodal/dualplex). For multimodal/dualplex, knowledgebase_mode must be "function_call" when a knowledgebase is attache

Update an existing assistant (partial). Only the fields you send are changed.

Permanently delete an assistant. Cannot be undone.

Enable inbound-call webhook notifications for an assistant.

Disable inbound-call webhook notifications.

Enable conversation-ended (chat) webhook for an assistant.

Disable conversation-ended (chat) webhook.

Disable the post-call webhook for an assistant.

Initiate an outbound AI phone call with a configured assistant.

Retrieve a single call by ID.

List calls with pagination and optional assistant filter.

Delete a call record. Cannot be undone.

List conversations across your assistants with cursor pagination and filters.

Get the full message history of a chat conversation by UUID.

Start a new chat session with an assistant (widget=paid, test=free).

Send a user message in an existing chat conversation and get the assistant reply.

Re-enable AI replies for a conversation after a human takeover.

Disable AI replies for a conversation so a human can take over.

List all campaigns you own (call, WhatsApp, SMS), including channel, schedule windows, and fallback config.

Get a single campaign by ID. Same fields as list_campaigns.

Create a draft call, WhatsApp, or SMS campaign. Starts in draft — add leads, then start with update_campaign_status. For channel=call require assistant_id; for whatsapp require whatsapp_sender_id + whatsapp_template_id; for sms require sms_from_phone_number_id + sms_body.

Start or stop a call, WhatsApp, or SMS campaign. Starting validates channel config, schedule, and balance.

Delete a campaign. Running campaigns are stopped first. Cannot be undone.

List leads with pagination.

Create a new lead in a campaign. IMPORTANT: variable names come from the associated assistant configuration and are fixed; only their values can be supplied here.

Update a lead. Variables are merged with existing ones.

Delete a lead.

Send an SMS from one of your Famulor phone numbers (must be SMS-capable). Costs are deducted from your balance.

List mid-call tools (HTTP integrations callable by an assistant during a call).

Get a single mid-call tool by ID.

Create a new mid-call HTTP tool.

Update a mid-call tool. headers/schema fully replace existing values when provided.

Delete a mid-call tool.

List all knowledge bases on the account.

Get a knowledge base by ID.

Create a new knowledge base.

Rename or describe an existing knowledge base.

Delete a knowledge base permanently.

List documents in a knowledge base.

Get a single document by ID.

Add a website (URL-scraped) document to a knowledge base. File uploads (pdf/txt/docx) must use the Famulor dashboard or a direct multipart/form-data call.

Update a document name or description. Content cannot be changed.

Delete a document from a knowledge base.

List every phone number on the account (regardless of SMS or subscription status).

Search for purchasable phone numbers via the Famulor provider.

Purchase a phone number returned by search_phone_numbers (monthly subscription).

Update a phone number you own. Currently sets the nickname — a short human-readable label (max 50 chars) shown next to the number. Send null/empty to clear it. Granted (shared) numbers cannot be updated.

Release (cancel) a purchased phone number.

List assistant folders (paginated), each with its assistants_count. Folders group assistants, e.g. per customer or brand; an assistant belongs to at most one folder.

Create a folder to group assistants. Assign assistants via the folder_id field on create_assistant / update_assistant.

Rename a folder or change its color (partial — only sent fields change).

Delete a folder. Assistants inside are NOT deleted — they just become uncategorized.

List assistant labels (paginated), each with its assistants_count. Labels are tags; an assistant can carry multiple labels across folders.

Create a label to tag assistants (e.g. "inbound", "outbound"). Assign via the label_ids field on create_assistant / update_assistant.

Rename a label or change its color (partial — only sent fields change).

Delete a label. It is removed from all assistants it was assigned to — the assistants themselves are NOT affected.

List all SIP trunks on the account.

Get a SIP trunk by ID.

Provision a new SIP trunk (extension or DID number).

Update a SIP trunk (partial).

Delete a SIP trunk by phone-number ID.

List WhatsApp Business senders. status defaults to "online" — pass "all" to see all.

List approved templates for a WhatsApp sender (status defaults to "approved").

Check whether a 24h messaging window is open for a recipient.

Send a WhatsApp template message (required when initiating or outside the 24h window).

Send a freeform WhatsApp message. Requires an open 24h session (use get_whatsapp_session_status to check).

Generate a context-aware AI reply for a customer message. The system keeps conversation state per customer_identifier (e.g. phone, email, CRM ID).