Skip to main content
POST
/
conversations
/
{uuid}
/
messages
curl -X POST "https://call.aiployees.com/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "I would like to schedule a demo for next week"
  }'

{
  "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": []
}

Documentation Index

Fetch the complete documentation index at: https://docs.aiployees.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint sends a user message to an existing conversation and returns the assistant’s response. The assistant processes the message using the configured AI model and any available tools.

​
Path Parameters

​
uuid
string
required
The unique UUID identifier of the conversation

​
Request Body

​
message
string
required
The user’s message to send to the assistant. Maximum length: 2000 characters.

​
Response Fields

​
status
boolean
Indicates whether the request was successful
​
message
string
The assistant’s response to the user’s message
​
function_calls
array
Array of function calls made by the assistant while processing the message. Empty array if no functions were called.

​
Error Responses

​
status
boolean
Will be false when an error occurs
​
error
string
Error message. Possible values:
  • Conversation not found - The provided UUID does not match any conversation
  • Insufficient balance. Please top up your account. - The assistant owner’s account balance is too low
  • Failed to process message: [details] - An error occurred while processing the message
curl -X POST "https://call.aiployees.com/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "I would like to schedule a demo for next week"
  }'

{
  "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": []
}

​
Pricing

Each user message in a widget conversation costs $0.01. Test conversations are free.

​
Function Calls

The assistant may execute functions during message processing, such as:
  • Calendar operations: Checking availability, booking appointments
  • Knowledge base queries: Searching documentation or FAQs
  • Custom integrations: Calling your configured webhook endpoints
Function call results are included in the response so you can display relevant information to the user or track actions taken.

​
Best Practices

  1. Handle errors gracefully: Display user-friendly messages when errors occur
  2. Show loading states: The assistant may take a few seconds to respond, especially when executing functions
  3. Preserve conversation ID: Store the conversation UUID to allow users to resume conversations
  4. Respect rate limits: Implement appropriate delays between messages if needed