Create a conversation

Create a new conversation by making an HTTP POST request

POST https://api.userdesk.io/v1/chatbot/:chabot_id/conversation

Create a new conversation for a specific chatbot.

The fields marked with * are mandatory

Headers

Name	Type	Description
Authorization*	String	Bearer <your_chatbot_api_key>

Request Body

Name	Type	Description
userName	String	Name of the user
userEmail	String	Email of the user

200: OK Conversation successfully created

{
  "success": true,
  "conversationId": "7bb301ad-e691-4341-8afb-b4407c4ffdf2",
  "response": "Hello, how can I help you?"
}

401: Unauthorized Missing API Key

401: Unauthorized Wrong API Key

403: Forbidden Access to this chatbot is denied

500: Internal Server Error An error occurred on the server

If the request is successful, the response includes the conversationId and the first message from the Chatbot, if configured.

{
  "success": true,
  "conversationId": "7bb301ad-e691-4341-8afb-b4407c4ffdf2",
  "response": "Hello, how can I help you?"
}