Integration overview

AskAIs Customer Service は、複数のクライアント SDK を備えた単一のバックエンドです。ワークスペースを一度セットアップすれば、ウェブサイト、モバイルアプリ、任意のバックエンドサービスなど、どこにでもチャットを埋め込めます。すべてのクライアントが、同じ受信トレイ、AI エージェント、ナレッジベースと通信します。

1つのバックエンドで、あらゆるプラットフォームに対応

どのプラットフォームを使っても、インストールは短く済み、会話・連絡先・AI 応答・設定はすべて共有されます。各プラットフォームのインストール方法と、さらに重要な「今後のアップデートの受け取り方」を以下に示します。

プラットフォーム一覧

すべての SDK には互換性がありますか？

はい。これらは同じ AskAIs Customer Service ワークスペースへの異なる入り口であり、完全に相互運用できます。

• 同じバックエンド、同じ app-id：すべてのクライアントがワークスペース内の同じ受信トレイに接続します。
• デバイスをまたいだ同一の訪問者：同じ externalId で識別すれば、ウェブで始まったチャットをそのままアプリで継続できます。
• 共有された設定：AI エージェント、ナレッジベース、営業時間、キーワード応答、FAQ は一度設定すれば、すべてのチャネルに適用されます。

ウェブ — 公式の埋め込み（推奨）

この1行を </body> の直前に追加してください。インストールはこれだけです。app-id は公開情報であり、そのまま配布しても安全です。Settings → Inboxes からコピーしてください。

<script src="https://cs.askais.com/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://cs.askais.com"
        async></script>

⚠️ widget.js をダウンロードしたり、自分でホスティングしないでください

ウィジェットは必ず https://cs.askais.com/widget.js から読み込んでください。ファイルをダウンロードして自分でホスティングしたり、自分のバンドルにコンパイルして組み込んだりすると、そのバージョンで固定されてしまい、今後のスタイル更新、バグ修正、新機能が一切届かなくなります。cs.askais.com から読み込めば、ウィジェットは自動的に更新され、あなたは何も変更する必要がありません。

ページ側から操作する（任意）

スクリプトの読み込み後、グローバルな window.SingChat が利用できます。

// Open / close the widget
window.SingChat.open();
window.SingChat.close();

// Identify a logged-in user (so chats follow them across devices)
window.SingChat.identify({ externalId: "user_123", name: "Ada", email: "ada@acme.com" });

モバイルアプリ（iOS / Android / Flutter / React Native）

ネイティブ SDK はアプリにコンパイルして組み込まれるため、ウェブウィジェットのように自動更新されません。新しいバージョンを取り込むには、パッケージマネージャーで SDK のバージョンを上げ、新しいアプリビルドをリリースしてください。初期化の考え方はどの環境でも同じで、https://cs.askais.com を指定し、app-id で識別します。

// Swift Package Manager
.package(url: "https://github.com/singlink/singlink-ios", from: "0.1.0")

let client = SingChatClient(baseURL: "https://cs.askais.com")
try await client.identify(.deviceAnonymous(appId: "YOUR_APP_ID"))

任意のバックエンドや言語

SDK は不要です。REST API を直接呼び出して連絡先を識別し、メッセージを送受信できます。また、OpenAPI 仕様から生成した SDK を 30+ の言語向けに公開しています。

# Any backend / language — talk to the REST API directly
curl -X POST https://cs.askais.com/api/v1/auth/identify \
  -H 'Content-Type: application/json' \
  -d '{"appId":"YOUR_APP_ID","externalId":"user_123"}'

さらに詳しく

• ウェブウィジェット — 完全リファレンス（イベント、テーマ設定、セキュリティ）
• モバイル SDK — iOS、Android、Flutter、React Native
• すべての SDK とコード生成
• REST API リファレンス