Famulor

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

Create a new knowledge base.

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

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.

Create a new mid-call HTTP tool.

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

Permanently delete an assistant. Cannot be undone.

Delete a call record. Cannot be undone.

Delete a campaign. Cannot be undone.

Delete a document from a knowledge base.

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

Delete a knowledge base permanently.

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

Delete a lead.

Delete a mid-call tool.

Delete a SIP trunk by phone-number ID.

Disable conversation-ended (chat) webhook.

Disable inbound-call webhook notifications.

Disable the post-call webhook for an assistant.

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

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

Enable inbound-call webhook notifications for an assistant.

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

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

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

Retrieve a single call by ID.

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

Get a single document by ID.

Get a knowledge base by ID.

List all supported assistant languages.

Get the authenticated Famulor user profile, including total balance.

Get a single mid-call tool by ID.

List available LLM / multimodal / dualplex model IDs.

List all outbound-capable assistants.

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

Get a SIP trunk by ID.

List custom TTS providers selectable on an assistant.

List custom STT providers selectable on a pipeline assistant.

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

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

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

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

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

List calls with pagination and optional assistant filter.

List all outbound calling campaigns.

List conversations across your assistants with cursor pagination and filters.

List documents in a knowledge base.

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.

List all knowledge bases on the account.

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

List leads with pagination.

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

List all SIP trunks on the account.

Initiate an outbound AI phone call with a configured assistant.

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

Release (cancel) a purchased phone number.

Search for purchasable phone numbers via the Famulor provider.

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

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

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

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

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

Start or stop a campaign.

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

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

Rename or describe an existing knowledge base.

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

Update a lead. Variables are merged with existing ones.

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

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.

Update a SIP trunk (partial).