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

# Send Message

> Send a message in an existing conversation

Send a message to continue an existing conversation with the Clever AI agent.

### Body

<ParamField body="message" type="string" required>
  The message to send to the agent
</ParamField>

<ParamField body="conversation_id" type="string">
  The ID of the existing conversation. If not provided, a new conversation will be started.
</ParamField>

<ParamField body="language" type="string" default="en">
  Language for the conversation (`en` or `it`)
</ParamField>

### Response

<ResponseField name="conversation_id" type="string">
  Unique identifier for the conversation
</ResponseField>

<ResponseField name="response" type="string">
  Agent's response to the message
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the conversation
</ResponseField>

<ResponseField name="customer_info" type="object">
  Updated customer information object

  <Expandable title="properties">
    <ResponseField name="name" type="string">Customer's name</ResponseField>
    <ResponseField name="phone" type="string">Contact phone number</ResponseField>
    <ResponseField name="address" type="string">Service address</ResponseField>
    <ResponseField name="issue" type="string">Description of the issue</ResponseField>
    <ResponseField name="role" type="string">Customer's role (optional)</ResponseField>
    <ResponseField name="priority" type="string">Ticket priority (optional)</ResponseField>
    <ResponseField name="type" type="string">Request type (optional)</ResponseField>
    <ResponseField name="date_time" type="string">Timestamp of conversation</ResponseField>
    <ResponseField name="submission_date_time" type="string">When ticket was submitted (optional)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="is_complete" type="boolean">
  Whether all required information has been collected
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X POST 'https://api.clever.nivara.io/conversation/message' \
  -H 'Content-Type: application/json' \
  -d '{
    "message": "My name is John Smith",
    "conversation_id": "conv_123abc456def",
    "language": "en"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "conversation_id": "conv_123abc456def",
    "response": "Thank you, John. Could you please provide your phone number?",
    "status": "in_progress",
    "customer_info": {
      "name": "John Smith",
      "phone": null,
      "address": null,
      "issue": null,
      "role": null,
      "priority": null,
      "type": null,
      "date_time": "2024-03-21T10:30:00Z",
      "submission_date_time": null
    },
    "is_complete": false
  }
  ```
</ResponseExample>