> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Send message

> Send a user message to an existing conversation and receive the assistant's response

Send a message to an existing Famulor conversation and receive the assistant's reply including any function calls triggered during processing.

### Path Parameters

<ParamField path="uuid" type="string" required>
  UUID of the existing conversation
</ParamField>

### Request Body

<ParamField body="message" type="string" required>
  User message to send (max 2000 characters)
</ParamField>

### Request Examples

### Response Fields

<ResponseField name="status" type="boolean" required>
  Indicates whether the request succeeded
</ResponseField>

<ResponseField name="message" type="string" required>
  Assistant's response text
</ResponseField>

<ResponseField name="function_calls" type="array" optional>
  Function calls executed during this message (empty if none)

  <Expandable title="function call properties">
    <ResponseField name="name" type="string">
      Function name
    </ResponseField>

    <ResponseField name="arguments" type="object">
      Arguments passed to the function
    </ResponseField>

    <ResponseField name="result" type="object">
      Return value from the function
    </ResponseField>
  </Expandable>
</ResponseField>

### Response Examples

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "status": true,
    "message": "I'd be happy to help you schedule a demo! I have availability on Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which time works best for you?",
    "function_calls": []
  }
  ```

  ```json 200 Success (with function calls) theme={null}
  {
    "status": true,
    "message": "I found two slots. Which one do you prefer?",
    "function_calls": [
      {
        "name": "check_calendar_availability",
        "arguments": {
          "date_range": "next_week"
        },
        "result": {
          "available_slots": ["2025-01-10 14:00", "2025-01-12 10:00"]
        }
      }
    ]
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "status": false,
    "error": "Conversation not found"
  }
  ```

  ```json 400 Insufficient Balance theme={null}
  {
    "status": false,
    "error": "Insufficient balance. Please top up your account."
  }
  ```

  ```json 400 Processing Error theme={null}
  {
    "status": false,
    "error": "Failed to process message: invalid tool output"
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "status": false,
    "error": "message is required"
  }
  ```
</ResponseExample>

### Notes

* Widget conversations: \$0.01 per user message; test conversations are free.
* Store the conversation UUID to resume chats later.
* Show loading states since tool calls may take a few seconds.
* Combine with [`Get Conversation`](/en/api-reference/ai-chatbot/get-conversation) for history and [`Create Conversation`](/en/api-reference/ai-chatbot/create-conversation) to start new chats.