Send message

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

Endpoint

POST /conversations/{uuid}/messages

Path parameters

string

required

UUID of the conversation to send the message to.

Request

string

required

The user’s message. Maximum 2000 characters.

Response

boolean

Whether the request was successful.

string

The assistant’s response.

array

Functions executed by the assistant while processing the message. Empty array if none were called.

Show Function call properties

string

Name of the function called.

object

Arguments passed to the function.

object

Result returned by the function.

Example

curl -X POST "https://portal.intellixent.ai/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"}'

const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';

const response = await fetch(
  `https://portal.intellixent.ai/api/conversations/${conversationId}/messages`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ message: 'I would like to schedule a demo for next week' })
  }
);

const data = await response.json();
console.log(data.message); // Assistant's response

200 Success

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

200 With function calls

{
  "status": true,
  "message": "I've checked our calendar and found available slots for next week.",
  "function_calls": [
    {
      "name": "check_calendar_availability",
      "arguments": {
        "start_date": "2025-01-13",
        "end_date": "2025-01-17"
      },
      "result": {
        "available_slots": ["2025-01-13 14:00", "2025-01-15 10:00"]
      }
    }
  ]
}

404 Conversation not found

{
  "status": false,
  "error": "Conversation not found"
}

400 Insufficient balance

{
  "status": false,
  "error": "Insufficient balance. Please top up your account."
}

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

Overview

Assistants

Calls

Campaigns & Leads

Conversations

Messaging

Phone Numbers

Knowledge & Tools

Webhooks

Endpoint

Path parameters

Request

Response

Example

​Endpoint

​Path parameters

​Request

​Response

​Example

Endpoint

Path parameters

Request

Response

Example