Embed a streamlined, white-label version of WisdomAI Chat directly into your application. The page is loaded in an iframe and intentionally omits WisdomAI branding and features for a seamless integration experience. All core chat capabilities (natural‑language Q&A, table generation, and chart rendering) remain intact.
The embedded chat UI is hosted at: https://<customer>.askwisdom.ai/chat/embed

​
Key Components

Embedded Chat Page

Minimal WisdomAI chat UI rendered in the iframe

GraphQL API

Programmatically creates and manages chat sessions

Descope M2M Auth

Machine-to-machine JWT authentication using partner-specific API keys

​
End-to-End Workflow

1

New Chat Trigger

User clicks New Chat on your platform
2

Backend Creates Chat Session

The platform’s backend calls the createConversation mutation on WisdomAI GraphQL API and receives a conversationId
3

Load Embedded Chat

Your platform renders the iframe:
<iframe
  src="https://<customer>.askwisdom.ai/chat/embed/{conversationId}?token=<signed-jwt>"
  style="width: 100%; height: 100%; border: 0;" />
4

Seamless Interaction

The embedded page controls the chat experience; no further state management is required after the initial load.

​
GraphQL API Capabilities

OperationTypeDescription
createConversationMutationCreates a new blank chat session and returns conversationId
conversationsQueryRetrieves all conversations based on limit and offset

​
Machine-to-Machine Authentication Flow

1

API Key Provisioning

WisdomAI generates a dedicated access key in the Descope portal and shares it with you. Reach out to our API team at support@askwisdom.ai to get a dedicated access key.
2

JWT Signing

Use the following GraphQL API to get a JWT from the access key
query ExchangeAccessToken($accessKey: String!) {
  exchangeAccessToken(accessToken: $accessKey)
}
3

Request Authorization

Attach the signed JWT to every GraphQL request:
Authorization: Bearer <signed-jwt>
For detailed information about the authentication flow and API usage, see the Exchange Access Token documentation.