conversations

Create

POST

Creates a conversation.

Request

This endpoint expects an object.

type

string literalRequired

Allowed value: support

description

stringOptional

Description for the conversation.

group

stringOptional

The group that the conversation is associated with.

is_spam

booleanOptional

Whether the conversation is spam.

members

list of stringsOptional

The users in the conversation.

messages

list of objectsOptional

Initial messages on the conversation.

metadata

objectOptional

source_channel

stringOptional

Whether the conversation is from a source channel.

stage

objectOptional

Sets an object's initial stage.

Response

This endpoint returns an object

conversation

object

POST

1 curl -X POST https://api.devrev.ai/conversations.create \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "type": "support"
6 }'

200Successful

1 {
2   "conversation": {
3     "id": "id",
4     "members": [],
5     "created_date": "2023-01-01T12:00:00Z",
6     "description": "description",
7     "display_id": "display_id",
8     "group": {
9       "id": "id",
10       "display_id": "display_id",
11       "member_type": "dev_user",
12       "name": "name"
13     },
14     "metadata": {
15       "url_context": "url_context"
16     },
17     "modified_date": "2023-01-01T12:00:00Z",
18     "sla_tracker": {
19       "id": "id",
20       "display_id": "display_id"
21     },
22     "stage": {
23       "name": "name",
24       "stage": {
25         "id": "id"
26       }
27     },
28     "tags": [
29       {
30         "tag": {
31           "id": "id",
32           "name": "name"
33         }
34       }
35     ],
36     "title": "title"
37   }
38 }

Built with

1	curl -X POST https://api.devrev.ai/conversations.create \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"type": "support"
6	}'

1	{
2	"conversation": {
3	"id": "id",
4	"members": [],
5	"created_date": "2023-01-01T12:00:00Z",
6	"description": "description",
7	"display_id": "display_id",
8	"group": {
9	"id": "id",
10	"display_id": "display_id",
11	"member_type": "dev_user",
12	"name": "name"
13	},
14	"metadata": {
15	"url_context": "url_context"
16	},
17	"modified_date": "2023-01-01T12:00:00Z",
18	"sla_tracker": {
19	"id": "id",
20	"display_id": "display_id"
21	},
22	"stage": {
23	"name": "name",
24	"stage": {
25	"id": "id"
26	}
27	},
28	"tags": [
29	{
30	"tag": {
31	"id": "id",
32	"name": "name"
33	}
34	}
35	],
36	"title": "title"
37	}
38	}