Integration overview
The ways to connect AskAIs today: your website, your app, Telegram and AI clients.
Technical names such as
window.SingChatbelong to the widget and API. Keep them exactly as written in your code.
AskAIs is a hosted service: your workspace, inbox, AI agent and knowledge base live on askais.com. You connect your customers to it in the ways below, and every conversation lands in the same shared inbox, answered by the same AI agent with the same knowledge and settings.
Ways to connect
| Where | How you connect | Updates |
|---|---|---|
| Your website | One <script> tag | None needed: every page load gets the current widget |
| Your iOS, Android, Flutter, React Native or desktop app | A WebView that opens your chat page | None needed: the WebView loads the current widget |
| Telegram | A bot token in Settings → Channels | None needed |
| Claude Code, Cursor or Gemini CLI (for your team) | The MCP server, with an MCP key | None needed |
Your website
Add this before </body>. Copy your App ID from Settings → Inboxes; it is public and safe to ship.
<script src="https://askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://askais.com"
async></script>⚠️ Load widget.js from askais.com
Do not download widget.js or bundle it into your own code. Loaded from askais.com, it always runs the current version; a copy stays frozen and misses every fix and new feature.
Mobile and desktop apps
There is no SDK to install. Open https://askais.com/api/widget-embed?appId=YOUR_APP_ID in a WebView and your app shows the same chat as your website, full screen. Add the signed-in user's ID, email and name to the URL so your team knows who they are talking to. The In-app chat page has the full guide, with code for Flutter, iOS, Android and JavaScript.
Signed-in visitors and verified identity
For signed-in users, pass externalId, email and name so their chats follow them across devices. To stop anyone from posing as another user, also pass hmac: an HMAC-SHA256 of the externalId, keyed with the inbox secret key and computed on your server. The Web widget page shows how.
Telegram
Create a bot with @BotFather, paste its token under Settings → Channels and connect. Messages to the bot arrive in the same inbox, where the AI agent and your team answer them.
AI clients (MCP)
The MCP server lets Claude Code, Cursor or Gemini CLI work on your workspace: read and answer conversations, train the AI, edit FAQ and read analytics. It is for you and your team, not for your customers. A workspace owner or admin creates the MCP key.
Not available today
- Installable SDK packages (npm, pub.dev, CocoaPods, Gradle). Use the script tag on the web and the WebView page in apps.
- A public REST API for your own backend. API keys are accepted only by the MCP server.
- Webhooks for conversation or message events. Settings → Webhooks can store an endpoint and send a signed test ping, but no events are delivered yet.
- JavaScript methods to open, close or listen to the widget.
window.SingChat.start()is the only method the script provides.