Embed Chat

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

Operation	Type	Description
createConversation	Mutation	Creates a new blank chat session and returns conversationId
conversations	Query	Retrieves 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 [e-mail] 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.