POST
/
v1
/
conversation
curl --request POST \
  --url https://api.droxy.ai/v1/conversation \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "conversationId": "<string>",
  "chatbotId": "<string>",
  "messages": [
    {}
  ],
  "override": true
}'
{
  "id": "<string>",
  "user": "<string>",
  "chatbot": "<string>",
  "createdAt": 123,
  "messages": [
    {
      "text": "<string>",
      "fromUser": true
    }
  ],
  "source": {
    "type": 123,
    "discordChannelId": "<string>",
    "whatsAppInfo": {
      "replyingPhoneNumberId": "<string>",
      "replyingPhoneNumber": "<string>",
      "senderPhoneNumber": "<string>",
      "senderName": "<string>"
    },
    "facebookInfo": {
      "pageId": "<string>",
      "senderId": "<string>",
      "senderName": "<string>"
    },
    "instagramInfo": {
      "instagramAccountId": "<string>",
      "senderId": "<string>",
      "senderUsername": "<string>"
    }
  }
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
chatbotId
string
required

The chatbot's id to associate the conversation with.

​
messages
object[]
required

An array of messages to save in the conversation.

​
conversationId
string

The conversation's id. If not defined, a new conversation will be created.

​
override
boolean

The conversation's override flag. If true, the conversation will be overridden. If false, the conversation will be appended to the existing conversation. Will default to true.

Response

200
application/json
Created
​
id
string
required

The conversation id.

​
user
string
required

The user id associated to the conversation.

​
chatbot
string
required

The chatbot id associated to the conversation .

​
createdAt
number
required

The created date of the conversation. Unix timestamp in milliseconds.

​
messages
object[]
required

The array of messages for the conversation.

​
source
object
required

The conversation's source.