Import chat messages

Where to get an assistant ID and a bearer token

GraphQL endpoint

POST /graphql HTTP/1.1
Host: api.botmetrica.com
Authorization: Bearer <token>
Content-Type: application/json
Accept: application/json

REST endpoint

POST /v1/... HTTP/1.1
Host: api.botmetrica.com
Authorization: Bearer <token>
Content-Type: application/json
Accept: application/json

Add messages to a chat (even if it doesn't exist yet)

This endpoint allows you to add messages to a chat, so you'll be able to refer to it using your internal ID. This ID should be unique for each chat per assistant.

REST request

POST https://api.botmetrica.com/v1/add-chat-messages

{
	"assistantId": "<assistant-id>",
	"externalChatId": "<Your own unique ID per assistant>",
	"chatTitle": "<Chat title>",
	"source": "Instagram",
	"messages": [
		{
			"sentAt": 1745139600000,
			"content": "Hello from the user",
			"isInbound": true
		},
		{
			"sentAt": 1745139601000,
			"content": "Response from the bot",
			"knowledge": {
				"agent 1": "agent's context",
				"agent 2": "agent's context",
				"environment": {
					"value 1": 123,
					"value 2": true
				}
			},
			"isInbound": false
		},
		{
			"sentAt": 1745139602000,
			"content": "Response from an operator",
			"isInbound": false,
			"sender": "John Smith",
			"isHuman": true
		},
		{
			"sentAt": 1745139602000,
			"content": "Automatic response",
			"isInbound": false,
			"sender": "Auto Response"
		}
	]
}

Response body: { "chatId": "<chat-id>" }

---

GraphQL request

{
	"query": "mutation CreateChatMessages($assistantId: String!, $chatTitle: String, $externalChatId: String!, $messages: [MessageInput!]!) {createChatMessages(assistantId: $assistantId, chatTitle: $chatTitle, source: source, externalChatId: $externalChatId, messages: $messages) { id createdAt name } }",
	"variables": {
		"assistantId": "<assistant-id>",
		"externalChatId": "<Your own unique ID per assistant>",
		"chatTitle": "<Chat title>",
		"source": "Instagram",
		"messages": [
			{
				"sentAt": 1745139600000,
				"content": "Hello from the user",
				"isInbound": true
			},
			{
				"sentAt": 1745139601000,
				"content": "Response from the bot",
				"knowledge": {
					"agent 1": "agent's context",
					"agent 2": "agent's context",
					"environment": {
						"value 1": 123,
						"value 2": true
					}
				},
				"isInbound": false
			},
			{
				"sentAt": 1745139602000,
				"content": "Response from an operator",
				"isInbound": false,
				"sender": "John Smith",
				"isHuman": true
			},
			{
				"sentAt": 1745139602000,
				"content": "Automatic response",
				"isInbound": false,
				"sender": "Auto Response"
			}
    		]
	}
}

Create a Chat

This endpoint allows you to create a new chat.

{
	"query": "mutation createApiChat($assistantId: ID!, $name: String, $messages: [MessageInput!]) { createApiChat(assistantId: $assistantId, name: $name, source: $source, messages: $messages) { id } }",
	"variables": {
		"assistantId": "<assistant-id>",
		"name": "<Chat name>",
		"source": "Instagram",
		"messages": [
			{
				"sentAt": 1745139600000,
				"content": "Hello from the user",
				"isInbound": true
			},
			{
				"sentAt": 1745139601000,
				"content": "Response from the bot",
				"knowledge": "{\"info\": \"bot's knowledge\"}",
				"isInbound": false
			},
			{
				"sentAt": 1745139602000,
				"content": "Response from an operator",
				"isInbound": false,
				"sender": "John Smith",
				"isHuman": true
			},
			{
				"sentAt": 1745139602000,
				"content": "Automatic response",
				"isInbound": false,
				"sender": "Auto Response"
			}
		]
	}
}

Add Messages to a Chat

This endpoint allows you to add new messages to an existing chat session.

{
	"query": "mutation createMessages($chatId: ID!, $messages: [MessageInput!]!) { createMessages(chatId: $chatId, messages: $messages) }",
	"variables": {
		"chatId": "<chat-id>",
		"messages": [
			{
				"sentAt": 1745139603000,
				"content": "New message from the user",
				"isInbound": true
			},
			{
				"sentAt": 1745139604000,
				"content": "Another response from the bot",
				"knowledge": "{\"info\": \"bot's knowledge\"}",
				"isInbound": false
			}
		]
	}
}