「知っている」と「調べに行く」の違い
顧客の質問には2種類あります。1つ目は一般的なもの:返品ポリシーは何ですか? 配送はどれくらいかかりますか? ドイツに発送しますか? 充実したナレッジベースがこれらを処理します。
2つ目は具体的なもの:注文 #4521 はどこですか? 青色のバージョンはまだ在庫がありますか? 今月のプランはあとどれだけ残っていますか? これらはナレッジベースには存在しません。お客様のシステム — 注文管理、在庫、請求 — の中に存在し、毎秒変化します。
1つ目だけを処理できるチャットボットは、化粧をしたFAQに過ぎません。2つ目も処理できるチャットボットはアシスタントです。両者を分けるのはAPIアクセスです。
このギャップが顧客を失わせる理由
今日のほとんどの「AIチャット」はナレッジベースだけに乗っています。配送ポリシーを17ヶ国語で言い換えることはできますが、顧客に荷物が今どこにあるかを伝えることはできません。だから顧客が尋ね、ボットがかわし、顧客は諦めるか、ボットがミリ秒で取得できたはずの同じデータを調べる担当者を待つかになります。
これがチャットボットの天井です。「確認させてください」のたびに、最初のメッセージで数秒以内に答えるチャンスが失われます — 顧客の意図がまだ熱いうちに。
API接続が実際に行うこと
enuchatでは、API接続はチャットとバックエンドサービスの1つを結ぶ設定済みのリンクです。一度だけ定義します:ベースURL、認証方式、いくつかのエンドポイント、そのパラメータ、応答のマッピング方法。
そこから先、AIは会話中にこれらのエンドポイントを呼び出せます。訪問者が注文について尋ねると、AIは注文番号を抽出し、注文エンドポイントを呼び出し、ライブステータスを読み取り、それを返答に織り込みます。訪問者が見るのは1文だけ:「注文 #4521 は昨日発送され、木曜日に到着予定です。」 その文の背後で、本物のAPI呼び出しが起きています。
顧客は配管を見ません。チャットが本当に知っているということだけを見ます。
5つの認証方式、カスタムコード不要
接続したいAPIのほとんどは、すでに標準的な認証を使用しています。enuchatは5つを最初からサポートします:
- None — 認証を必要としないパブリックAPI向け
- API Key — ヘッダーまたはクエリパラメータで送信
- Bearer Token — シンプルなトークンベース認証
- Basic Auth — レガシーシステム向け
- OAuth 2.0 client credentials — Salesforce、HubSpot、または独自のOAuthサーバーなど現代的なプロバイダー向け
OAuth 2.0の場合、enuchatはトークンのライフサイクルを自動で処理します — 初回呼び出し時に取得し、有効期限までキャッシュ、必要に応じて更新します。資格情報を一度設定すれば、あとは忘れて構いません。すべての資格情報はlibsodiumで保管時に暗号化され、API応答に表示されることはありません。
変数、テンプレート、応答マッピング
エンドポイントはテンプレートとして定義されます。/orders/{orderId} のようなパスや、{customerId} を参照するJSONボディは、セッション変数から値を補間します — AIや静的ルールが会話中に設定できる変数です。
APIが応答すると、JSON応答のフィールドをドット表記でセッション変数にマッピングし直します。data.status は order_status になります。data.shipping.eta は delivery_eta になります。AIはその値を、訪問者の言語で自然な応答に織り込みます。
ほとんどのユースケースをカバーする3つのパターン
実際には、ほとんどのAPI統合は3つの形のいずれかに分類されます。
調べて答える
訪問者が1回のAPI呼び出しで答えられる質問をします。ルールは CALL_API に続いて REPLY_AI を発火させます。AIは取得したデータを使って、文脈を踏まえた根拠ある回答を構成します。注文ステータス、口座残高、客室の空き状況、現在の価格、荷物追跡 — すべてここに当てはまります。
調べてルーティング
API呼び出しは次に何をすべきか決めるのに十分な情報を返します。プレミアムアカウントはシニアエージェントにエスカレーションされます。期限切れのサブスクリプションは請求担当に回されます。AIは CALL_API に続いて ASSIGN_TO_OPERATOR を使い、推測ではなく実際の顧客データに基づいてルーティングの判断を行います。
マルチステップフロー
最初のメッセージは SET_VARIABLE で会話にタグを付け、2番目は十分なコンテキストが揃ったらAPI呼び出しをトリガーし、3番目で回答を構成します。バックエンドを叩く前に意図を確認したい場合や、データ照会が訪問者が2メッセージ前に言ったことに依存する場合に便利です。
組み込みのセキュリティ
バックエンドをチャットウィジェットに接続することにナーバスになるチームもいます — もっともです。enuchatはデフォルトで複数の保護層を提供します:
- SSRF防止 はlocalhost、プライベートIP、内部ホスト名への呼び出しをブロックします
- 5秒タイムアウト は遅いAPIによって会話が止まるのを防ぎます
- テナントスコープ はテナント間のデータ漏洩がないことを意味します — エンドポイントはあなた自身のウィジェットからのみ見えます
- テストボタン はルールに組み込む前に、接続と各エンドポイントを個別に検証します
- 暗号化された資格情報 がダッシュボードに平文で戻ってくることは決してありません
顧客にとって何が変わるか
チャットは 「確認できる人を探させてください」 から 「確認しました、答えはこちらです」 に変わります — 60+言語のいずれでも、日曜の午前3時に、サポートチームが寝ている間でも。さもなければカートや注文、プランを離脱していたであろう顧客が、回答が彼らの質問中に届くから留まります。
これがチャットボットとアシスタントの違いです。そして、顧客が実際に感じる違いです。
始め方
すでにenuchatを設定済みなら、API接続は 設定 → API接続 にあります。チームが週に100回タイプする質問に答えるエンドポイントを1つ選んでください — 注文ステータスは通常、最も効果の高い出発点です。接続を設定し、エンドポイントを追加し、ルールに接続し、本番に出す前に1回テストしてください。完全な手順は API接続ガイドをご覧ください。
enuchatが初めての方は、enuchat.com でサインアップしてください。無料プランには初日からAPI接続が含まれます — カード不要、会話ごとの料金なし、トライアル期限なし。
最初のエンドポイントを接続するのに5分。最初の有用な回答は通常その日のうちに届きます。