​
Overview

Embed a streamlined, white-label version of WisdomAI Chat directly into your application.
The embedded chat UI is hosted at: https://<customer>.askwisdom.ai/embed/chat
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.

​
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 createChat mutation on WisdomAI GraphQL API and receives a chatId
3

Load Embedded Chat

Your platform renders the iframe:
<iframe
  src="https://<customer>.askwisdom.ai/embed/chat/{chatId}"
  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
createChatMutationCreates a new blank chat session and returns chatId
listChatsQueryRetrieves all chat sessions with summaries for custom chat list UI

​
Authentication

​
Machine-to-Machine Flow

1

API Key Provisioning

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

JWT Signing

Use client-credentials flow to sign a JWT with your API key
3

Request Authorization

Attach the signed JWT to every GraphQL request:
Authorization: Bearer <signed-jwt>