Skip to main content
POST
/
conversation
/
start
curl -X POST 'https://api.clever.nivara.io/conversation/start?language=en'

{
  "conversation_id": "conv_123abc456def",
  "response": "Hello! I'm here to help you with any maintenance requests. Could you please tell me your name?",
  "status": "started",
  "customer_info": {
    "name": null,
    "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
}

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.

Start a new conversation with the Clever AI agent. You can specify the language for the conversation (English or Italian).

​
Query Parameters

​
language
string
default:"en"
Language for the conversation. Can be:
  • en or english for English
  • it or italian for Italian (case insensitive)

​
Response

​
conversation_id
string
Unique identifier for the conversation
​
response
string
Initial response from the agent
​
status
string
Current status of the conversation. One of:
  • started
  • in_progress
  • awaiting_troubleshooting_confirmation
  • troubleshooting_in_progress
  • awaiting_approval
  • completed
  • error
​
customer_info
object
Customer information object containing:
​
is_complete
boolean
Whether all required information has been collected
curl -X POST 'https://api.clever.nivara.io/conversation/start?language=en'

{
  "conversation_id": "conv_123abc456def",
  "response": "Hello! I'm here to help you with any maintenance requests. Could you please tell me your name?",
  "status": "started",
  "customer_info": {
    "name": null,
    "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
}