Start Conversation

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
}

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
}

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:

Show properties

name

string

Customer’s name

phone

string

Contact phone number

address

string

Service address

issue

string

Description of the issue

role

string

Customer’s role (optional)

priority

string

Ticket priority (optional)

type

string

Request type (optional)

date_time

string

Timestamp of conversation

submission_date_time

string

When ticket was submitted (optional)

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
}

API Reference Send Message

Get Started

Our Projects

Start Conversation

Query Parameters

Response

​Query Parameters

​Response

Query Parameters

Response