This endpoint initiates an Core chat session within the AE system. The chat is configured based on the provided parameters and request body. The client can specify a preferred language for the session, though it's optional. The response will contain the chat's outcome or any relevant error information if the request fails.
| widgetId required | string The ID of a specific widget. |
| chatId required | string The ID of a specific chat session within the widget. |
| language | string Example: language=en The language code (e.g., 'en' for English, 'es' for Spanish) to be used in the chat session. If not specified, the default language will be used. |
| message required | string The message content. |
| message_origin | string Default: "copilot" Origin of the message, defaulting to 'copilot'. |
object (UserData) Schema for additional user information that is optional. |
{- "message": "string",
- "message_origin": "copilot",
- "user_data": {
- "ip": "string",
- "browser": "string",
- "name": "string",
- "email": "string",
- "location": "string"
}
}{- "prompt": "string",
- "text": "string",
- "documents": [
- {
- "id": "string",
- "metadata": {
- "created_timestamp": "2019-08-24T14:15:22Z",
- "description": "string",
- "doc_id": 0,
- "keywords": [
- "string"
], - "questions": [
- "string"
], - "title": "string",
- "type": "string",
- "updated_timestamp": "2019-08-24T14:15:22Z",
- "url": "string",
- "used_by_ai": true,
- "weights": 0.1,
- "widget_id": "string"
}, - "page_content": "string",
- "type": "string"
}
], - "route": "string",
- "widget_id": "string",
- "conversation_id": "string",
- "chat_history": {
- "conversation_id": "string",
- "widget_id": "string",
- "message_origin": "string",
- "messages": [
- {
- "role": 0,
- "content": "string",
- "timestamp": 0,
- "citations": [
- {
- "doc_id": 0,
- "url": "string",
- "title": "string",
- "description": "string",
- "chunk": "string"
}
], - "query_hash": "string"
}
], - "user": "string",
- "is_flagged": true,
- "rating": 0,
- "status": "string",
- "tokens": {
- "total_tokens": 0,
- "input_tokens": 0,
- "output_tokens": 0
}, - "created_timestamp": "2019-08-24T14:15:22Z",
- "updated_timestamp": "2019-08-24T14:15:22Z"
}, - "language": "string"
}This endpoint initiates an Core chat session utilizing Azure's services within the AE system. The chat interaction is configured based on the data provided in the request body. The response will provide details of the chat session or error information if the request fails.
| widgetId required | string The ID of a specific widget. |
| chatId required | string The ID of a specific chat session within the widget. |
| language | string Example: language=en The language code (e.g., 'en' for English, 'es' for Spanish) to be used in the chat session. If not specified, the default language will be used. |
| message required | string The message content. |
| message_origin | string Default: "copilot" Origin of the message, defaulting to 'copilot'. |
object (UserData) Schema for additional user information that is optional. |
{- "message": "string",
- "message_origin": "copilot",
- "user_data": {
- "ip": "string",
- "browser": "string",
- "name": "string",
- "email": "string",
- "location": "string"
}
}{- "prompt": "string",
- "text": "string",
- "documents": [
- {
- "id": "string",
- "metadata": {
- "created_timestamp": "2019-08-24T14:15:22Z",
- "description": "string",
- "doc_id": 0,
- "keywords": [
- "string"
], - "questions": [
- "string"
], - "title": "string",
- "type": "string",
- "updated_timestamp": "2019-08-24T14:15:22Z",
- "url": "string",
- "used_by_ai": true,
- "weights": 0.1,
- "widget_id": "string"
}, - "page_content": "string",
- "type": "string"
}
], - "route": "string",
- "widget_id": "string",
- "conversation_id": "string",
- "chat_history": {
- "conversation_id": "string",
- "widget_id": "string",
- "message_origin": "string",
- "messages": [
- {
- "role": 0,
- "content": "string",
- "timestamp": 0,
- "citations": [
- {
- "doc_id": 0,
- "url": "string",
- "title": "string",
- "description": "string",
- "chunk": "string"
}
], - "query_hash": "string"
}
], - "user": "string",
- "is_flagged": true,
- "rating": 0,
- "status": "string",
- "tokens": {
- "total_tokens": 0,
- "input_tokens": 0,
- "output_tokens": 0
}, - "created_timestamp": "2019-08-24T14:15:22Z",
- "updated_timestamp": "2019-08-24T14:15:22Z"
}, - "language": "string"
}This endpoint creates a new support ticket on Zendesk within the AE system. The request body must include the necessary details for the ticket, such as the issue description and relevant user information. Upon successful creation, the response will include the ticket ID and its status on Zendesk. If the request is invalid or fails, appropriate error responses will be returned.
| widgetId required | string The ID of a specific widget. |
| chatId required | string The ID of a specific chat session within the widget. |
| username required | string |
| email required | string |
| description required | string |
| connection_id | string Default: "" |
{- "username": "string",
- "email": "string",
- "description": "string",
- "connection_id": ""
}{- "ticket_id": "string",
- "status": "string"
}This endpoint initiates an agent handoff session within Zendesk via the AE system. It allows for the seamless transition of a conversation from an automated system to a human agent. The request body must include the details required to create a support ticket, which will be used to inform the agent about the ongoing issue. A successful response will contain details about the handoff session, ensuring that the human agent has the context needed to continue the interaction. If the request fails, appropriate error information will be returned.
| widgetId required | string The ID of a specific widget. |
| chatId required | string The ID of a specific chat session within the widget. |
| username required | string |
| email required | string |
| description required | string |
| connection_id | string Default: "" |
{- "username": "string",
- "email": "string",
- "description": "string",
- "connection_id": ""
}{- "session_id": "string",
- "status": "string"
}This endpoint allows users to send a message directly to a human agent within the Auralis Core Chat Flow system. The message content and any related metadata must be provided in the request body. Upon successful processing, the response will include details of the sent message, confirming its delivery to the agent. If the request is malformed or contains invalid data, the appropriate error information will be returned.
| widgetId required | string The ID of a specific widget. |
| chatId required | string The ID of a specific chat session within the widget. |
| message required | string |
| email required | string |
{- "message": "string",
- "email": "string"
}{- "message_id": "string",
- "status": "string"
}This endpoint is designed to receive and process webhook notifications from Zendesk. The request body should contain the payload sent by Zendesk, which may include information about ticket updates, user activities, or other events. The server will handle these notifications to integrate Zendesk updates into the Auralis Core Chat Flow system. The response will confirm receipt of the webhook notification or indicate any issues with processing the request.
| widgetId required | string The ID of a specific widget. |
| chatId required | string The ID of a specific chat session within the widget. |
| property name* additional property | any |
{ }{- "status": "string",
- "message": "string"
}This endpoint indexes articles from Zendesk by processing the article data provided in the request. The request body should include details about the Zendesk articles to be indexed, such as article IDs or other identifying information. The system will fetch and index the content of these articles to make them searchable. The response will confirm the successful indexing of the articles or provide error details if the request fails.
| widgetId required | string The ID to associate the vector store with a specific widget. |
| url required | Array of strings (Url) |
string (Email) | |
| token | string (Zendesk Token) |
{- "url": [
- "string"
], - "email": "string",
- "token": "string"
}{- "_shards": {
- "total": 0,
- "successful": 0,
- "skipped": 0,
- "failed": 0
}, - "_total": 0,
- "data": [
- {
- "_id": "string",
- "url": "string",
- "created_timestamp": 0,
- "created_by": "string",
- "updated_timestamp": 0,
- "updated_by": "string",
- "widget_id": "string",
- "doc_id": 0,
- "title": "string",
- "status": "string",
- "description": "string",
- "used_by_ai": true,
- "weights": 0,
- "type": "string",
- "chunk": "string",
- "cleaned_chunk": "string",
- "keywords": [
- "string"
], - "questions": [
- "string"
], - "vector_doc_id": 0
}
]
}This endpoint creates a new vector store entry in the vector database. The request body should include the necessary data to define the new vector store, such as the vectors and metadata. The response will contain information about the newly created vector store entry, including any relevant identifiers and status details.
| widgetId required | string The ID to associate the vector store with a specific widget. |
| query required | string |
| description | string |
| source required | Array of strings |
| flagged | boolean Default: false |
| flagged_comment | string Default: "" |
| rating | integer Default: 0 |
{- "query": "string",
- "description": "string",
- "source": [
- "string"
], - "flagged": false,
- "flagged_comment": "",
- "rating": 0
}{- "status": "string",
- "message": "string"
}This endpoint updates an existing vector store entry in the vector database. The request body should contain the updated vector data and any other necessary information. The response will provide information about the updated vector store, including confirmation of the changes made.
| widgetId required | string The ID to associate the vector store with a specific widget. |
| queryId required | string The ID to associate the vector store with a specific widget. |
| query required | string |
| description | string |
| source required | Array of strings |
| flagged | boolean Default: false |
| flagged_comment | string Default: "" |
| rating | integer Default: 0 |
{- "query": "string",
- "description": "string",
- "source": [
- "string"
], - "flagged": false,
- "flagged_comment": "",
- "rating": 0
}{- "status": "string",
- "message": "string"
}This endpoint deletes a specific vector store entry from the vector database. The request body should include details required for identifying and removing the vector store entry. Optionally, a widget_id can be provided to specify the associated widget. The response will confirm the deletion of the vector store entry or provide error information if the request fails.
| widgetId required | string The ID to associate the vector store with a specific widget. |
| queryId required | string The ID to associate the vector store with a specific widget. |
{- "status": "string",
- "message": "string"
}This endpoint indexes web pages by processing the URLs and their content provided in the request. The request body should include details such as the URLs to be indexed and any associated metadata. The system will fetch the content from these URLs, analyze it, and store it in the index for further search and retrieval operations. The response will confirm the successful indexing of the specified websites or indicate any issues encountered during the process.
| widgetId required | string The ID to associate the vector store with a specific widget. |
| urls required | Array of strings (Url) List of URLs to be indexed. |
| sourceType required | string (Source Type) Enum: "Web" "YoutubeVideo" "VimeoVideo" "Document" "Blog" "NewsArticle" "ForumPost" "Confluence" "Notion" The type of source being indexed. |
{- "urls": [
- "string"
], - "sourceType": "Web"
}{- "_shards": {
- "total": 0,
- "successful": 0,
- "skipped": 0,
- "failed": 0
}, - "_total": 0,
- "data": [
- {
- "_id": "string",
- "url": "string",
- "created_timestamp": 0,
- "created_by": "string",
- "updated_timestamp": 0,
- "updated_by": "string",
- "widget_id": "string",
- "doc_id": 0,
- "title": "string",
- "status": "string",
- "description": "string",
- "used_by_ai": true,
- "weights": 0,
- "type": "string",
- "chunk": "string",
- "cleaned_chunk": "string",
- "keywords": [
- "string"
], - "questions": [
- "string"
], - "vector_doc_id": 0
}
]
}This endpoint indexes custom data for search and analysis. The request body should include data in a format suitable for indexing, allowing for flexibility in the structure of the input. The system will process this data, analyze its content, and integrate it into the index. The response will provide confirmation of successful indexing or details of any errors encountered during the process.
| widgetId required | string The ID to associate the vector store with a specific widget. |
| custom_title | string (custom_title) Title of the custom data to be indexed. |
| custom_description | string (custom_description) Description of the custom data to be indexed. |
| custom_urls | Array of strings or null (custom_urls) List of URLs to be optionally added. |
{- "custom_title": "string",
- "custom_description": "string",
- "custom_urls": [
- "string"
]
}{- "_shards": {
- "total": 0,
- "successful": 0,
- "skipped": 0,
- "failed": 0
}, - "_total": 0,
- "data": [
- {
- "_id": "string",
- "url": "string",
- "created_timestamp": 0,
- "created_by": "string",
- "updated_timestamp": 0,
- "updated_by": "string",
- "widget_id": "string",
- "doc_id": 0,
- "title": "string",
- "status": "string",
- "description": "string",
- "used_by_ai": true,
- "weights": 0,
- "type": "string",
- "chunk": "string",
- "cleaned_chunk": "string",
- "keywords": [
- "string"
], - "questions": [
- "string"
], - "vector_doc_id": 0
}
]
}This endpoint synchronizes and indexes website data for analysis. The request body should include details required to fetch and index the website content. The system will process this data and integrate it into the index, providing a confirmation of successful synchronization or details of any errors encountered.
| docId required | string The ID of a specific document. |
| widgetId required | string The ID to associate the vector store with a specific widget. |
| url required | string (Url) |
| created_by required | string (Created By) |
required | Created Timestamp (integer) or Created Timestamp (number) (Created Timestamp) |
{- "url": "string",
- "created_by": "string",
- "created_timestamp": 0
}{- "_shards": {
- "total": 0,
- "successful": 0,
- "skipped": 0,
- "failed": 0
}, - "_total": 0,
- "data": [
- {
- "_id": "string",
- "url": "string",
- "created_timestamp": 0,
- "created_by": "string",
- "updated_timestamp": 0,
- "updated_by": "string",
- "widget_id": "string",
- "doc_id": 0,
- "title": "string",
- "status": "string",
- "description": "string",
- "used_by_ai": true,
- "weights": 0,
- "type": "string",
- "chunk": "string",
- "cleaned_chunk": "string",
- "keywords": [
- "string"
], - "questions": [
- "string"
], - "vector_doc_id": 0
}
]
}