Voice Chat Interaction

This endpoint allows our pre-diagnostic AI to interact with your existing voice chat. We will pick up in mid conversation to ask all the right questions to help pre-diagnose the vehicle.

Endpoint

https://api.example.com/customer/voice-prediag/

Request Details

HTTP Method

POST

Request Format

application/json

Request Body

Parameter	Type	Required	Description
status	String	True	Specifies the type of request. For initiation, it would be "start"
appt_uuid	String	True	The unique identifier for the appointment/conversation.
dealer_uuid	String	True	Unique identifier for dealer.
customer_name	String	True	The name of the customer.
transcript	String	(Conditional) Only on Initial Call	The full transcript of the conversation held by the previous AI up to the point of handoff.
message	String	(Conditional) Only for subsequent request	The latest message content from the customer.
vehicle_id	String	True	Vehicle Identification Number

Note

For initial start, leave message empty. The transcript will initiate the conversation.

Status Options

• start (Initialize conversation)
• message (AI looking for a response)

Making an Initial Chat Request

Note

Make sure to include trailing backslash in POST URL after prediag/

curl -X POST \
  https://api.example.com/customer/voice-prediag/ \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: API_KEY" \
  -d '{
    "appt_uuid": "000111",
    "dealer_uuid": "1234321",
    "customer_name": "John Customer",
    "vehicle_id": "AS76D87ASD8A",
    "message": "My car is making a strange rattling noise when I accelerate."
  }'

{
    "response":"Is the rattling noise coming from a specific area."
}

Error Response

[
  {
    "status": "error",
    "question": "Error: Invalid appt_uuid provided."
  }
]