Integration overview

AskAIs は、接続方法が豊富な単一のバックエンドです。ワークスペースを一度セットアップすれば、ウェブサイト、モバイルアプリ、任意のバックエンドサービスなど、どこにでもチャットを埋め込めます。お客様は Telegram や WhatsApp などの受信チャネルからも連絡できます。すべてのクライアントとチャネルが、同じ受信トレイ、AI エージェント、ナレッジベースと通信します。

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

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

プラットフォーム一覧

すべてのクライアントとチャネルは連携しますか？

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

• 同じバックエンド、同じ app-id：すべてのクライアントがワークスペース内の同じ受信トレイに接続します。
• デバイスをまたいだ同一の訪問者：同じ externalId で識別すれば、ウェブで始まったチャットをそのままアプリで継続できます。
• 埋め込みだけではありません。受信チャネルとして、ウェブやアプリ内のウィジェットに加え、お客様は Telegram や WhatsApp からも連絡でき（どちらもエンドツーエンドで稼働中）、すべてのメッセージが同じ受信トレイに集まります。X の受け口も準備済みです。
• 共有された設定：AI エージェント（プラットフォーム提供または自分のキー）、ナレッジベース、営業時間、キーワード応答、FAQ は一度設定すれば、すべてのチャネルに適用されます。

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

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

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

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

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

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

スクリプトの読み込み後、グローバルな 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" });

モバイルアプリ：Flutter SDK または WebView 埋め込み

モバイルには実際に使える方法が3つあります。1つ目は、ネイティブの Flutter ウィジェット SDK で、フル機能でテーマ変更可能なチャット UI（フローティングバブルとネイティブのチャット画面。WebView ではありません）を提供します。pubspec に追加してリリースするだけです。2つ目は、iOS と Android（および React Native）で、ウェブウィジェットを WebView にそのまま埋め込む方法です。ウェブサイトと同じ体験で、自動的に最新の状態が保たれます。3つ目は、REST API と署名付き Webhook を使って、自前の UI を描画する方法です。インストールが必要な iOS、Android、React Native 専用のネイティブチャット SDK はありません。これらがサポートされている方法です。

# Flutter, native chat widget (floating bubble + native chat UI, not a WebView).
# In your app's pubspec.yaml (download and unzip the SDK package first):
dependencies:
  singchat_widget:
    path: ../singchat_widget

# iOS / Android / React Native without Flutter: load the hosted web widget in a
# WKWebView / WebView (same experience as the website), or drive the REST API
# with signed webhooks and render your own chat UI.

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

SDK は不要です。REST API を直接呼び出して連絡先を識別し、メッセージを送受信でき、署名付き Webhook で受信イベントを検証できます。API 全体は公開された OpenAPI 仕様に従っているため、自分の言語のクライアントを生成することも、エンドポイントを直接呼び出すこともできます。

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

さらに詳しく

• ウェブウィジェット、完全リファレンス（イベント、テーマ設定、セキュリティ）
• モバイル、Flutter SDK と WebView 埋め込み
• SDK と OpenAPI 仕様
• REST API リファレンス