📱APP
Create APP
Creating an application with ZBrain Builder is a streamlined process enabled by the platform's intuitive API. To create an app using ZBrain Builder, initiate a POST request to the provided URL with the necessary headers and payload. This includes setting your app's configuration, description, email, knowledge base, and name.
Request URL: https://app.zbrain.ai:3000/api/manage-app
Request Method: POST
Request Headers:
Authorization: Bearer <<API Key>>
Content-Type: application/json
Request Payload:
configuration: {type: <<"PUBLIC" or "PRIVATE">>}
description: << "some description optional" >>
email: << email >>
knowledgeBases: << Array of KnowledgeBaseId's which are strings >>
name: <Enter your app name>
Authorization
Bearer API-Key (get it from settings > profile from https://app.zbrain.ai/settings/profile )
configuration
type of app i.e., PUBLIC or PRIVATE
description
description about the app
email
registered email id of application creator email
( for PRIVATE app only)
name
name of the app
knowledgeBases
Array of KnowledgeBaseId's which are strings (get the _id
key of each knowledge base from Get knowledge bases response)
Sample Request Body payload:
{ "configuration": {"type": "PUBLIC"}, "description": "App Description", "email": "", "knowledgeBases": ["knowledgeBaseId"], "name": "App Name", }
Code snippets:
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.zbrain.ai:3000/api/manage-app',
'headers': {
'Content-Type': 'application/json',
'Authorization': 'Bearer <API key>'
},
body: JSON.stringify({
"configuration": {
"type": "<PUBLIC or PRIVATE>"
},
"description": "<some description optional>",
"email": "<email>",
"knowledgeBases": [
"<knowledgeBaseId>",
"<knowledgeBaseId>"
],
"name": "<name>"
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Sample Response:
{ "responseData": { "styles": { "headerColor": "string", "textColor": "string", "sideBarColor": "string", "sideBarText": "string", "backGroundColor": "string", "sampleQueryColor": "string", "botReplyBg": "string" }, "configuration": { "id": number, "type": "string" }, "logo": "string", "name": "string", "description": "string", "pageTitle": "string", "pageDescription": "string", "botName": "string", "botInstruction": "string", "botIcon": "string", "botType": "string", "model": "string", "tenantId": "string", "email": "string", "createdBy": "string", "knowledgeBases": [ "string" ], "sampleQueries": ["string"], "suggestedQueries": ["string"], "_id": "string", "addedOn": number, "modifiedOn": number }, "message": "App created successfully", "success": true, "responseCode": 200 }
Get all APPs
The ZBrain get app API allows users to get all user active apps. To get a ZBrain apps, initiate a GET request to the provided URL with the necessary payload.
Request URL: https://app.zbrain.ai:3000/api/apps?skip=0&limit=10
Request Method: GET
Query strings:
skip: << numeric value >>
limit: << numeric value >>
Request Headers:
Authorization: Bearer <<API Key >>
Content-Type: application/json
Authorization
Bearer API-Key (get it from settings > profile from https://app.zbrain.ai/settings/profile )
skip
no.of apps to skip
limit
no.of apps to listout
Sample Query string:
?skip=0&limit=10
Code snippets:
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://app.zbrain.ai:3000/api/apps?skip=0&limit=10',
'headers': {
'Authorization': 'Bearer <API key>'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Sample Response:
{ "responseData": { "data": [ { "name": "string", "createdByName": "string", "_id": "string", "configuration": { "type": "string" }, "createdBy": "string", "isDeactivated": boolean, "role": "string", "addedOn": number, "modifiedOn": number } ], "total": number }, "message": "Information fetched successfully", "success": true, "responseCode": 200 }
Get APP by Id
Request URL: https://app.zbrain.ai:3000/api/manage-app/<appId>
Request Method: GET
Path parameters:
appId: << appId >>
Request Headers:
Authorization: Bearer <<API Key >>
Content-Type: application/json
Authorization
Bearer API-Key (get it from settings > profile from https://app.zbrain.ai/settings/profile )
appId
unique id of app (_id get it from the get all APP's api response)
Sample Path parameters:
/manage-app/<appId>
Code snippets:
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://app.zbrain.ai:3000/api/manage-app/<appId>',
'headers': {
'Authorization': 'Bearer <API key>'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Sample Response:
{ "responseData": { "styles": { "headerColor": "string", "textColor": "string", "sideBarColor": "string", "sideBarText": "string", "backGroundColor": "string", "sampleQueryColor": "string", "botReplyBg": "string" }, "configuration": { "id": number, "type": "string" }, "logo": "string", "name": "string", "description": "string", "pageTitle": "string", "pageDescription": "string", "botName": "string", "botInstruction": "string", "botIcon": "string", "botType": "string", "model": "string", "tenantId": "string", "email": "string", "createdBy": "string", "knowledgeBases": [ "string" ], "sampleQueries": ["string"], "suggestedQueries": ["string"], "_id": "string", "addedOn": number, "modifiedOn": number }, "message": "Information fetched successfully", "success": true, "responseCode": 200 }
Update APP
The ZBrain app update API allows for various modifications to your existing application. This includes the ability to change your app's name, add or adjust sample queries, modify the title and description of the chat page, alter the chatbot's instructions, or even rename the app. Additionally, it provides the flexibility to update the knowledge bases linked to your application. To update a ZBrain app, initiate a PUT request to the provided URL with the necessary payload.
Request URL:https://app.zbrain.ai:3000/api/manage-app
Request Method: PUT
Request Payload:
name : << App name >>
sampleQueries : << Array of questions >>
pageTitle: << Chat screen tttle >>
pageDescription: << Chat screen description >>
appId: << appId>>
knowledgeBases: << Array of knowledgebaseId's >>
botInstruction: << Instruction to chatbot >>
botName: << chatbot name >>
Authorization
Bearer API-Key (get it from settings > profile from https://app.zbrain.ai/settings/profile )
name
name of the app
sampleQueries
sample queries for chatscreen
appId
unique id of app (_id get it from the get all APP's api response)
pageTitle
name to the chat screen
pageDescription
description to the chatscreen
knowledgeBases
Array of KnowledgeBaseId's which are strings (get the _id
key of each knowledge base from Get knowledge bases response)
botInstruction
instruction to bot
botName
bot name
Sample Request Body payload:
{
"name": "name of app",
"sampleQueries": ["sample query 1","sample query 2"],
"appId": "_id",
"pageTitle": "chat screen title",
"pageDescription": "chat screen description",
"knowledgeBases": ["knowledgeBase1_id","knowledgeBase2_id"]
"botInstruction": "bot instruction",
"botName": "bot name"
}
Code snippets:
var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://app.zbrain.ai:3000/api/manage-app',
'headers': {
'Content-Type': 'application/json',
'Authorization': 'Bearer <API key>'
},
body: JSON.stringify({
"name": "<name>",
"sampleQueries": [
"<add sample queries>"
],
"pageTitle": "<pageTitle>",
"pageDescription": "<pageDescription>",
"appId": "<appId>",
"knowledgeBases": [
"knowledgeBaseId",
"knowledgeBaseId"
],
"botInstruction": "<instruction to bot>",
"botName": "<bot name>"
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Sample Response:
{ "responseData": { "styles": { "headerColor": "string", "textColor": "string", "sideBarColor": "string", "sideBarText": "string", "backGroundColor": "string", "sampleQueryColor": "string", "botReplyBg": "string" }, "configuration": { "id": number, "type": "string" }, "logo": "string", "name": "string", "description": "string", "pageTitle": "string", "pageDescription": "string", "botName": "string", "botInstruction": "string", "botIcon": "string", "botType": "string", "model": "string", "tenantId": "string", "email": "string", "createdBy": "string", "knowledgeBases": [ "string" ], "sampleQueries": ["string"], "suggestedQueries": ["string"], "_id": "string", "addedOn": number, "modifiedOn": number }, "message": "Information added successfully", "success": true, "responseCode": 200 }
Delete APP
To delete an app on ZBrain Builder, simply send a DELETE request to the provided URL, replacing '' with your specific application's ID. Ensure the required headers, including your Authorization Bearer and Content-Type, are correctly included in the request.
Request URL: https://app.zbrain.ai:3000/api/delete-app/<appId>
Request Method: DELETE
Request Headers:
Authorization: Bearer <<API Key>>
Content-Type: application/json
Authorization
Bearer API-Key (get it from settings > profile from https://app.zbrain.ai/settings/profile )
appId
unique id of app (_id get it from the get all APP's api response)
Sample Request Path Payload:
/appId
Code snippets:
var request = require('request');
var options = {
'method': 'DELETE',
'url': 'https://app.zbrain.ai:3000/api/delete-app/<appId>',
'headers': {
'Authorization': 'Bearer <API key>'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Sample Response:
{ "responseData": "App deleted successfully", "message": "App deleted successfully", "success": true, "responseCode": 200 }
Query APP
The query API for ZBrain Builder allows you to interact with your created application by sending a POST request to the provided URL. The request payload should include the specific app ID and the user's message content, facilitating the app to return responses in a paragraph format to the queries posed.
Request URL: https://app.zbrain.ai:3002/api/query
Request Method: POST
Request Headers:
Authorization: Bearer <<API Key>>
Content-Type: application/json
Request Payload:
appId: << appId >>
messages: [{role: "user", content: << Enter Query >>}
conversationId: "timestamp-randomString"
Authorization
provide Bearer API-Key (get it from settings > profile from https://app.zbrain.ai/settings/profile )
appId
unique id of the app _id
(get it from the response of get all APP's)
messages
Array of containing role and user query as content
conversationId
Unique id required for each query for a session. It is combination of unix timestamp and random 13 character string. Format: (timestamp-randomString)
Sample Request Body Payload:
{
"appId": "appId",
"messages": [
{
"role": "user",
"content": "query"
}
],
"conversationId":"timestamp-randomString"
}
Code snippets:
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://app.zbrain.ai:3002/api/query',
'headers': {
'Content-Type': 'application/json',
'Authorization': 'Bearer <API key>'
},
body: JSON.stringify({
"appId": "<appId>",
"messages": [
{
"role": "user",
"content": "<query>"
}
]
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Sample Response:
{ "responseData": "string", "message": "Information fetched successfully", "success": true, "responseCode": 200 }
Query stream APP
ZBrain Builder's query stream API responds to user queries in a real-time streaming format. By initiating a GET request with the specific app ID and query, the API facilitates a continuous, interactive conversation with the user, enhancing the chatbot experience.
Request URL: https://app.zbrain.ai:3002/api/stream-query?appId=<appId>&query=<query>&conversationId=<uuid>
Request Method: GET
Request Headers:
Authorization: Bearer <<API Key>>
Content-Type: text/event-stream
Authorization
Bearer API-Key (get it from settings > profile from https://app.zbrain.ai/settings/profile )
appId
unique id of the app _id
(get it from the response of get all APP's)
query
Query to chatbot ("string")
conversationId
unique Id for a conversation session.
Sample Request query Payload:
?appId=<appId>&query=<query>&conversationId=<uuid>
Code snippets:
const EventSource = require('eventsource');
const es = new EventSource(
'https://app.zbrain.ai:3002/api/stream-query?appId=<appId>&query=<query>&conversationId=<uuid>',
{
headers: {
Authorization: 'Bearer <API key>',
},
}
);
let response = '';
es.addEventListener('message', ({ data }) => {
const parsedMessage = JSON.parse(data);
response += parsedMessage;
console.log('Received content: ', parsedMessage);
});
es.addEventListener('error', ({ data = '""' }) => {
const errorMessage = JSON.parse(data);
console.log('Error occurred: ', errorMessage);
if (errorMessage === 'DONE') {
console.log('Final response: ', response);
}
es.close();
});
Get APP analytics
To retrieve application analytics, send a GET request to the specified URL with the required parameters. Ensure the request includes the relevant application ID and tenant ID, and confirm that the necessary headers are correctly incorporated.
Request Method: GET
Query Strings: tenantId: <<Enter the ID of the tenant>> appId : <<Enter the ID of the app>> startTimestamp: << Enter the start timestamp for the analytics data>> endTimestamp: <<Enter the end timestamp for the analytics data>>
Request headers: "Authorization": "Bearer <your_access_token>" "Content-Type": "application/json"
Sample Request Query Parameters:
{
"tenantId": "",
"appId": "",
"startTimestamp": "",
"endTimestamp": ""
}
Sample Response:
{
"responseData": {
"sessions": [
{
"x": "2024-04-25",
"y": 1
},
{
"x": "2024-04-26",
"y": 1
}
],
"queries": [
{
"x": "2024-04-26",
"y": 1
},
{
"x": "2024-04-25",
"y": 2
}
],
"tokenUsage": [
{
"x": "2024-04-26",
"y": 27
},
{
"x": "2024-04-25",
"y": 100
}
]
},
"message": "Information fetched successfully",
"success": true,
"responseCode": 200
}
Get APP reports
To obtain app reports, send a GET request to the following URL with the specified query parameters. Required query parameters include the tenant ID and app ID. Optional query parameters include email, searchQuery, startDate, and endDate.
Request URL: https://app.zbrain.ai:3000/v2/api/app-reports
Request Method: GET
Query String: tenantId (string, required): <<Enter the ID of the tenant>> appId (string, required):<<Enter ID of the application>> email (string, optional): <<Enter the email of the user for filtering>> searchQuery (string, optional): <<Enter the search query>> startDate (timestamp, optional): << Enter the start date for filtering sessions>> endDate (timestamp, optional): <<Enter the end date for filtering sessions>>
Request Headers: Authorization: Bearer <your_access_token> Content-Type: application/json
Sample Request Query Parameters:
{
"tenantId": "",
"appId": "",
"email": "",
"searchQuery": "",
"startDate":,
"endDate":
}
Sample Response:
{
"responseData": {
"sessions": [
{
"_id": "session_id_1",
"appId": "example_app_id",
"queriesCount": 2,
"tokenUsed": 12684,
"user": null,
"sessionStart": 1718082947067,
"sessionEnd": 1718082933015,
"timeTaken": 0,
"likes": 0,
"dislikes": 0,
"averageTimeTaken": 0,
"satisfactionScore": null
},
{
"_id": "session_id_2",
"appId": "example_app_id",
"queriesCount": 3,
"tokenUsed": 122,
"user": {
"name": "",
"email": "",
"phoneNumber": "",
"chatUserId": ""
},
"sessionStart": 1717407595038,
"sessionEnd": 1717407037654,
"timeTaken": 0,
"likes": 0,
"dislikes": 0,
"averageTimeTaken": 0,
"satisfactionScore": null
}
],
"totals": {
"totalSessions": 2,
"totalQueriesCount": 15,
"totalTokenUsed": 12806,
"totalTimeTaken": 0,
"totalLikes": 0,
"totalDislikes": 0,
"averageTimeTaken": 0,
"satisfactionScore": null
}
},
"message": "Information fetched successfully",
"success": true,
"responseCode": 200
}
Get filter options for the APP reports
To fetch app report filter options, send a GET request to the following URL with the specified parameters. These parameters specify the context for filtering options tailored to specific tenants, applications, and user emails. Ensure the request includes appropriate headers and any necessary authentication headers if the endpoint requires authentication.
Request URL: https://app.zbrain.ai:3000/v2/api/app-reports/filter
Request Method: GET
Query String: tenantId: <<Enter the ID of the tenant>> appId: <<Enter the application's ID>> email: <<Enter the user's email address>>
Request Headers: Authorization: Bearer <your_access_token> Content-Type: application/json
Sample Request Query Parameters:
{
"tenantId": "",
"appId": "",
"email": ""
}
Sample Response:
{
"responseData": {
"users": {
"name": "John Doe",
"email": "[email protected]",
"phoneNumber": "+1234567890",
"chatUserId": "chat123"
}
},
"message": "Information fetched successfully",
"success": true,
"responseCode": 200
}
Last updated