Ciarem AI

Admins only. Why the AI agent answered, transferred or declined in a contact's recent conversations: per AI turn, what the customer said, the decision, the rule that fired and the knowledge used. Give ONE of `contact_query` (name, phone or email), `contact_id` or `conversation_id`. When several contacts match a query, returns `candidates`: ask which one, then call again with its `contact_id`.

explain_ai_decisions

Admins only. Whether the workspace's AI agent is ready to answer customers and what to fix: readiness checks, open recommended actions, and each connected channel's status.

get_account_health

Who is connected: the signed-in Ciarem user and the workspace (organization) this connection reads from.

get_profile

One contact's details plus their 5 most recent conversations. `contact_id` comes from search_contacts or a conversation.

get_contact

One conversation with its latest messages in reading order (oldest first), including internal team notes. `limit` caps the messages (max 50).

get_conversation

Admins only. Conversation counts for the last 24 hours or 7 days (active, handled by the AI, new leads, awaiting reply, per channel) and the team leaderboard (assigned, sent, resolved, median reply time in seconds).

get_metrics

Inbox conversations, most recent first: who, channel, status, whether the AI or a human handles it, unread count and the last message. Filter by status, channel, `assigned_to_me`, `unassigned`, or a `query` over names and message text. Up to `limit` (max 25).

list_conversations

Find contacts (customers and leads) in Ciarem by name, phone or email. `funnel_stage` (a stage name, e.g. "Interesado") and `owned_by_me` narrow the list. Returns the total match count and up to `limit` (max 25) contacts, newest first.

search_contacts

Search the workspace's knowledge base (the documents, texts and websites its AI agent answers from) by meaning. Each match has the passage and the source it came from.

search_knowledge