POST
/
api
/
conversation
/
new
curl --location \
--request POST 'https://api.withdelphi.com/api/conversation/new' \
--header 'x-api-key: <key>' \
--header 'Content-Type: application/json' \
--data-raw '{"slug": "my-test-clone"}'
{
  "new_conversation": {
    "conversation_id": "b4177da8-40fc-4e5f-9c26-f7915d7e35e3",
    "created_at": "2023-06-04T15:32:04+00:00",
    "messages": [
        {
            "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
            "created_at": "2023-06-04T15:32:17+00:00",
            "sender": "CLONE"
        }
    ]
  },
  "conversation_type": "anonymous"
}

Body

slug
string

The slug of the clone that you want to start a new conversation with

user_email
string

The email of the user chatting with the clone.

Include this field to personalize the conversation to a user. Read more on the Personalization page

Response

new_conversation
object

Metadata about the new conversation that was just created

conversation_id
uuid

The id of the conversation. Store in a safe place to be passed in for generating clone responses. Learn more on the Generate Response page

created_at
datetime

The UTC timestamp of when the conversation was created

messages
Message array

An array containing the opening message from the clone. Customize the clone’s opening message on the Train tab of the clone editing page.

text
string

The text of the opening message

created_at
string

The time the message was sent

sender
string

Who sent the message. Either CLONE or USER

conversation_type
string

The type of the conversation, either: anonymous No user email was included in the request, no user information will be used to generate clone responses for this conversation personalized User email was included, conversation will be personal to the user