ダッシュボードに戻る

ドキュメント

Asyntaiの使い方を学ぶ

リアルタイムデータフィード

チャットボットをライブデータソースに接続して動的な回答を提供

データフィードを設定
スタンダード&プロプラン

概要

リアルタイムデータフィードにより、チャットボットがシステムからライブデータにアクセスできます。静的な応答の代わりに、AIが現在の空き状況、価格、待ち時間、在庫レベルなどの最新情報を提供できます。

データを返すURL(JSONまたはプレーンテキスト)を提供するだけで、チャットボットが関連する質問に回答する際にこの情報を自動的に含めます。

標準のリアルタイムデータフィードは最大200,000文字(約500アイテム)のフィードに対応しています。より大きなデータフィードについては、最大10,000,000文字(約25,000アイテム)に対応するリアルタイムデータフィードMaxをご覧ください。

仕組み

  1. URLを提供 - ライブデータを返すAPIエンドポイントまたはページ
  2. チャットボットがデータを取得 - AIは送信されるメッセージごとにフィード全体を読み取り、常に最新のデータを使用して応答します
  3. 動的な回答 - 応答にソースからのリアルタイムデータが含まれます
AIアシスタント
今夜空いている部屋はありますか?
はい!今夜の空室がございます:

デラックススイート - 残り3室、$299/泊
スタンダードルーム - 残り8室、$149/泊

ご予約のお手伝いをしましょうか?
明日はどうですか?
明日の空室状況は以下の通りです:

デラックススイート - 2室、$299/泊
スタンダードルーム - 5室、$149/泊

ユースケース

リアルタイムデータフィードは、最新の情報を提供する必要があるビジネスに最適です:

ホテル 日付別の空室状況と価格
レストラン 待ち時間、テーブルの空き状況、営業時間
Eコマース 在庫レベルと商品の在庫状況
サービス 予約枠とスケジューリング

セットアップ

リアルタイムデータフィードの追加は数ステップで完了します:

1
データエンドポイントを作成 ライブデータを返すURL(APIまたはウェブページ)を設定します
2
リアルタイムデータフィードに移動 ウェブサイトメニューから「リアルタイムデータフィード」をクリックします
3
URLを入力 データを返すURLを貼り付けて「保存」をクリックします

ヒント: チャットボットがデータを取得できるよう、エンドポイントが公開アクセス可能(認証不要)であることを確認してください。

接続の確認

データフィードのURLを保存すると、Asyntaiが自動的に接続を確認します。以下を示すステータスカードが表示されます:

  • 接続ステータス — URLに正常にアクセスできたかどうか
  • データ形式 — 検出された形式(JSON、HTML/XML、またはプレーンテキスト)
  • レスポンスサイズ — 返されたデータ量
  • コンテンツプレビュー — 正しいデータであることを確認するためのレスポンスの一部

直接接続が失敗した場合、AsyntaiはURLにアクセスするためにフォールバックプロキシを自動的に試みます。両方の方法が失敗した場合でもURLは保存されます - トラブルシューティングの提案とともに通知が表示されます。

対応フォーマット

データフィードURLは以下のいずれかの形式でデータを返す必要があります:

JSON形式

在庫やスケジュールなどの複雑な情報には構造化データが最適です。

{
  "current_date": "2025-01-15",
  "rooms": [
    {
      "type": "Deluxe Suite",
      "available": 3,
      "price": 299.99
    },
    {
      "type": "Standard Room",
      "available": 8,
      "price": 149.99
    }
  ]
}

プレーンテキスト形式

シンプルな情報にはプレーンテキストが適しています。

Current wait time: 15 minutes
Tables available: 3
Kitchen closes at: 10 PM

動的商品カード

リアルタイムデータフィードに商品情報(在庫、客室、サービスなど)が含まれている場合、ダイナミック商品カードを有効にして、チャット内に美しいビジュアルカードとして表示できます。

有効にする方法

  1. リアルタイムデータフィード設定に移動します
  2. データフィードURLを追加します(例を見る
  3. 「Enable Dynamic Product Cards」をオンに切り替えます
  4. 設定を保存します

データ形式

以下のようなフィールドでフィードに商品の詳細を含めます:

  • name - 商品/アイテム名(必須)
  • price - 表示価格(例:「$99.99」)
  • description - 短い説明
  • image_url - 商品画像URL
  • button_link - アクションボタンのリンク
  • in_stock - 在庫状況(true/false)

JSONフィードの例は以下の通りです(サンプルJSONファイルを表示):

{
  "products": [
    {
      "name": "Wireless Headphones Pro",
      "price": "$149.99",
      "description": "Noise-cancelling over-ear headphones with 30h battery",
      "image_url": "https://yourstore.com/images/headphones-pro.jpg",
      "button_link": "https://yourstore.com/products/headphones-pro",
      "in_stock": true
    },
    {
      "name": "Smart Watch Ultra",
      "price": "$299.99",
      "description": "GPS, heart rate monitor, 5ATM water resistance",
      "image_url": "https://yourstore.com/images/smart-watch-ultra.jpg",
      "button_link": "https://yourstore.com/products/smart-watch-ultra",
      "in_stock": true
    },
    {
      "name": "Portable Charger 20K",
      "price": "$39.99",
      "description": "20,000mAh fast charging power bank with USB-C",
      "image_url": "https://yourstore.com/images/charger-20k.jpg",
      "button_link": "https://yourstore.com/products/charger-20k",
      "in_stock": false
    }
  ]
}

ヒント: ダイナミック商品カードはECの在庫、ホテルの客室、レンタルアイテム、または頻繁に変わる商品に最適です。固定商品の場合は、代わりに商品カードを使用してください。

業種別の例

さまざまなビジネスがリアルタイムデータフィードを構成する方法の詳細な例を紹介します:

これらはあくまで例です - ビジネスに関連する任意のフィールドを含めることができます。AIは提供されたデータを理解し活用します。
ECストア 商品の在庫状況、価格、URL、プロモーション
{
  "store_name": "TechGadgets Store",
  "store_url": "https://techgadgets.com",
  "last_updated": "2025-01-15T14:30:00Z",
  "products": [
    {
      "name": "Wireless Headphones Pro",
      "sku": "WHP-001",
      "url": "https://techgadgets.com/products/wireless-headphones-pro",
      "price": 149.99,
      "sale_price": 119.99,
          "in_stock": true,
      "quantity_available": 23,
      "category": "Audio"
    },
    {
      "name": "Smart Watch Series X",
      "sku": "SWX-002",
      "url": "https://techgadgets.com/products/smart-watch-series-x",
      "price": 299.99,
          "in_stock": true,
      "quantity_available": 8,
      "category": "Wearables"
    },
    {
      "name": "Bluetooth Speaker Mini",
      "sku": "BSM-003",
      "url": "https://techgadgets.com/products/bluetooth-speaker-mini",
      "price": 49.99,
          "in_stock": false,
      "restock_date": "2025-01-20",
      "category": "Audio"
    }
  ],
  "active_promotions": [
    {
      "code": "SAVE20",
      "description": "20% off orders over $100",
      "expires": "2025-01-31"
    }
  ],
  "shipping": {
    "free_shipping_threshold": 50,
    "estimated_delivery": "2-3 business days"
  }
}
顧客: "ワイヤレスヘッドホンの在庫はありますか?"
AI: "はい!Wireless Headphones Proは在庫があり、23個ご用意しています。現在セール中で$119.99です(通常価格$149.99)。こちらでご覧いただき、ご購入いただけます:techgadgets.com/products/wireless-headphones-pro。さらに、$100以上のご注文にコードSAVE20で追加20%オフ!"
医療 / クリニック 予約の空き状況と待ち時間
{
  "clinic_name": "Downtown Medical Center",
  "booking_url": "https://downtownmedical.com/book",
  "current_wait_times": {
    "General Practice": 25,
    "Pediatrics": 15,
    "Urgent Care": 40
  },
  "available_appointments": {
    "General Practice": [
      {"date": "2025-01-15", "slots": ["3:30 PM", "4:00 PM", "4:30 PM"]},
      {"date": "2025-01-16", "slots": ["9:00 AM", "10:30 AM", "2:00 PM", "3:30 PM"]},
      {"date": "2025-01-17", "slots": ["9:00 AM", "11:00 AM", "1:00 PM"]}
    ],
    "Dermatology": [
      {"date": "2025-01-18", "slots": ["10:00 AM", "11:00 AM"]},
      {"date": "2025-01-20", "slots": ["9:00 AM", "2:00 PM", "3:00 PM"]}
    ],
    "Pediatrics": [
      {"date": "2025-01-15", "slots": ["4:00 PM", "5:00 PM"]},
      {"date": "2025-01-16", "slots": ["9:00 AM", "10:00 AM", "11:00 AM", "2:00 PM"]}
    ]
  },
  "accepting_new_patients": true,
  "operating_hours": {
    "weekdays": "8:00 AM - 6:00 PM",
    "saturday": "9:00 AM - 1:00 PM",
    "sunday": "Closed"
  }
}
患者: "今週、皮膚科を受診したいのですが"
AI: "最も早い皮膚科の予約は1月18日(土)の午前10時または午前11時です。ご都合が合わない場合は、20日(月)の午前9時、午後2時、午後3時にも空きがあります。downtownmedical.com/bookでオンライン予約できます。"
フィットネスセンター / ジム クラスのスケジュールと施設のキャパシティ
{
  "gym_name": "FitLife Gym",
  "booking_url": "https://fitlifegym.com/classes",
  "current_status": {
    "occupancy": 45,
    "capacity": 150,
    "pool": "open",
    "sauna": "maintenance until Jan 20"
  },
  "class_schedule": [
    {
      "date": "2025-01-15",
      "day": "Wednesday",
      "classes": [
        {"time": "12:00 PM", "name": "HIIT Training", "instructor": "Mike", "spots_left": 8},
        {"time": "5:30 PM", "name": "Spin Class", "instructor": "Jessica", "spots_left": 3},
        {"time": "7:00 PM", "name": "Yoga Flow", "instructor": "Sarah", "spots_left": 12}
      ]
    },
    {
      "date": "2025-01-16",
      "day": "Thursday",
      "classes": [
        {"time": "6:00 AM", "name": "Morning Bootcamp", "instructor": "Mike", "spots_left": 10},
        {"time": "12:00 PM", "name": "Pilates", "instructor": "Emma", "spots_left": 6},
        {"time": "6:00 PM", "name": "Boxing Fitness", "instructor": "Carlos", "spots_left": 4}
      ]
    },
    {
      "date": "2025-01-17",
      "day": "Friday",
      "classes": [
        {"time": "7:00 AM", "name": "Yoga Flow", "instructor": "Sarah", "spots_left": 15},
        {"time": "5:30 PM", "name": "HIIT Training", "instructor": "Mike", "spots_left": 12},
        {"time": "6:30 PM", "name": "Zumba", "instructor": "Maria", "spots_left": 20}
      ]
    },
    {
      "date": "2025-01-18",
      "day": "Saturday",
      "classes": [
        {"time": "9:00 AM", "name": "Weekend Warrior", "instructor": "Carlos", "spots_left": 8},
        {"time": "10:30 AM", "name": "Family Yoga", "instructor": "Sarah", "spots_left": 10}
      ]
    }
  ],
  "membership_info_url": "https://fitlifegym.com/join"
}
メンバー: "今週のヨガクラスはどのようなものがありますか?"
AI: "今週のヨガクラスは以下の通りです:水曜午後7時 Yoga Flow(Sarah担当、残り12席)、金曜午前7時 Yoga Flow(Sarah担当、残り15席)、土曜午前10時30分 Family Yoga(Sarah担当、残り10席)。fitlifegym.com/classesで予約できます。"
レンタカー / 自動車サービス 日付と場所ごとの車両空き状況
{
  "company": "QuickRent Cars",
  "booking_url": "https://quickrent.com/book",
  "availability": {
    "2025-01-17": {
      "Economy": {"available": 5, "price_per_day_usd": 45.99},
      "SUV": {"available": 3, "price_per_day_usd": 89.99},
      "Luxury": {"available": 1, "price_per_day_usd": 159.99}
    },
    "2025-01-18": {
      "Economy": {"available": 3, "price_per_day_usd": 52.99},
      "SUV": {"available": 1, "price_per_day_usd": 99.99},
      "Luxury": {"available": 2, "price_per_day_usd": 179.99}
    },
    "2025-01-19": {
      "Economy": {"available": 2, "price_per_day_usd": 52.99},
      "SUV": {"available": 0, "price_per_day_usd": null},
      "Luxury": {"available": 2, "price_per_day_usd": 179.99}
    }
  },
  "active_promotions": [
    {"code": "WEEKEND15", "description": "15% off Fri-Sun rentals"}
  ]
}
顧客: "今週末にSUVが必要です"
AI: "金曜日(残り3台、$89.99/日)と土曜日(残り1台、$99.99/日)にSUVの空きがありますが、日曜日は満車です。お早めにご予約ください!コードWEEKEND15で15%オフ。quickrent.com/bookで予約できます。"
イベント / エンターテインメント会場 ショー、チケット、スケジュール
{
  "venue": "Grand Theater",
  "tickets_url": "https://grandtheater.com/tickets",
  "shows": [
    {
      "title": "The Musical Experience",
      "url": "https://grandtheater.com/shows/musical-experience",
      "duration": "2h 30min",
      "price_usd": 85,
      "performances": [
        {"date": "2025-01-15", "time": "7:30 PM", "seats_available": 43},
        {"date": "2025-01-16", "time": "7:30 PM", "seats_available": 115},
        {"date": "2025-01-17", "time": "2:00 PM", "seats_available": 155},
        {"date": "2025-01-17", "time": "7:30 PM", "seats_available": 70}
      ]
    },
    {
      "title": "Comedy Night Live",
      "url": "https://grandtheater.com/shows/comedy-night",
      "duration": "2h",
      "price_usd": 45,
      "performances": [
        {"date": "2025-01-18", "time": "8:00 PM", "seats_available": 120},
        {"date": "2025-01-19", "time": "8:00 PM", "seats_available": 85}
      ]
    }
  ]
}
顧客: "今週末のショーは何がありますか?"
AI: "今週末は、金曜と土曜の午後7時30分に「The Musical Experience」(土曜午後2時のマチネもあり)- チケットは$85。土曜と日曜の午後8時に「Comedy Night Live」が$45です。金曜夜は残り43席のみで、すぐに売り切れます!grandtheater.com/ticketsで予約してください。"
不動産 / 物件管理 物件情報、価格、内覧スケジュール
{
  "agency": "Premier Properties",
  "website": "https://premierproperties.com",
  "listings": [
    {
      "id": "APT-4B",
      "url": "https://premierproperties.com/listing/apt-4b",
      "address": "123 Oak Street, Apt 4B",
      "type": "Apartment",
      "bedrooms": 2,
      "bathrooms": 1,
      "sqft": 950,
      "rent_usd_per_month": 1850,
      "available_from": "2025-02-01",
      "features": ["In-unit laundry", "Parking included", "Pet-friendly", "Balcony"],
      "open_houses": ["2025-01-18 11:00 AM", "2025-01-19 2:00 PM"]
    },
    {
      "id": "HSE-456",
      "url": "https://premierproperties.com/listing/hse-456",
      "address": "456 Maple Avenue",
      "type": "House",
      "bedrooms": 3,
      "bathrooms": 2,
      "sqft": 1800,
      "rent_usd_per_month": 2800,
      "available_from": "Immediate",
      "features": ["Backyard", "2-car garage", "Updated kitchen", "Central AC"],
      "open_houses": ["2025-01-16 2:00 PM", "2025-01-17 10:00 AM"]
    },
    {
      "id": "APT-12C",
      "url": "https://premierproperties.com/listing/apt-12c",
      "address": "789 Pine Road, Unit 12C",
      "type": "Apartment",
      "bedrooms": 1,
      "bathrooms": 1,
      "sqft": 650,
      "rent_usd_per_month": 1200,
      "available_from": "2025-02-15",
      "features": ["Gym access", "Rooftop deck", "Doorman"],
      "open_houses": ["2025-01-18 1:00 PM"]
    }
  ],
  "contact_url": "https://premierproperties.com/contact",
  "schedule_viewing_url": "https://premierproperties.com/schedule"
}
顧客: "$1500以下のアパートはありますか?"
AI: "789 Pine Roadに月額$1,200の1ベッドルームがあり、2月15日から入居可能です。650平方フィートで、ジム、屋上デッキ、ドアマン付きです。1月18日(土)午後1時にオープンハウスがあります。または、premierproperties.com/scheduleでプライベート内覧を予約してください。詳細:premierproperties.com/listing/apt-12c"

サイズ制限

標準のリアルタイムデータフィードは最大200,000文字のフィードに対応しています。含めることができるアイテム数は、各アイテムに含まれるデータ量によって異なります—短く簡潔なエントリのフィードでは約500アイテムを収容できますが、長い説明を含むフィードではそのほんの一部しか収容できない場合があります。フィードがこの制限を超えると、保存時に通知が表示されます。

フィードサイズを削減するヒント

フィードが大きすぎる場合、制限内に収めるための方法をご紹介します:

  • 売れ筋や人気商品のみを含める — お客様が最もよく問い合わせる商品に絞りましょう
  • 不要なフィールドを削除する — 内部ID、メタデータ、チャットボットが必要としないフィールドを除外しましょう
  • 説明文を短くする — マーケティング用の長文ではなく、簡潔な商品説明を使用しましょう。エントリをコンパクトに保つ方法の例については、推奨サンプル構造をご覧ください
  • 在庫状況でフィルタリングする — 現在在庫があるまたは有効な商品のみを含めましょう
  • カテゴリで分割する — すべてではなく、最も関連性の高い商品カテゴリのフィードを作成しましょう

ヒント: 数千件のアイテムを含む大規模なデータフィードを接続する必要がある場合は、最大10,000,000文字(約25,000アイテム)に対応したリアルタイムデータフィードMax(Proプラン)をご利用ください。

ベストプラクティス

  • データを最新に保つ — エンドポイントはキャッシュデータではなく、最新の情報を返すようにしましょう
  • コンテキストを含める — AIがデータの意味を理解できるよう、日付、時刻、ラベルを追加しましょう
  • 明確に構造化する — AIがデータを正しく解釈できるよう、JSONで明確なフィールド名を使用しましょう
  • 焦点を絞る — チャットボットが質問に回答するために必要なデータのみを含めましょう

重要: URLは公開アクセス可能である必要があります。エンドポイントに認証が必要な場合、チャットボットはデータを取得できません。

データフィードを削除

設定の「データフィードを削除」ボタンをクリックすることで、いつでもデータフィードを削除できます。チャットボットはナレッジベースのみを使用した応答に戻ります。

注意: リアルタイムデータフィードはStandardおよびProプランでご利用いただけます。数千件のアイテムを含む大規模なデータフィードの接続が必要ですか?リアルタイムデータフィードMax(Proプラン)をご覧ください。

試してみる

まだ独自のAPIエンドポイントがありませんか?公開APIで機能をテストして動作を確認できます。例えば、BinanceのリアルタイムBitcoin価格を試してみてください:

https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT

これはリアルタイムのBTC/USDT価格データを返します。接続後、チャットボットはライブデータを使用して「現在のBitcoin価格は?」のような質問に回答できるようになります。

ヒント: JSONまたはプレーンテキストを返す任意の公開APIを使用できます - 天気データ、株価、為替レートなど。準備ができたら独自のエンドポイントに置き換えてください。