Quay lại bảng điều khiển

Tài liệu

Tìm hiểu cách sử dụng Asyntai

Nguồn Dữ liệu Thời gian thực

Kết nối chatbot của bạn với nguồn dữ liệu trực tiếp để có phản hồi động

Cấu hình nguồn dữ liệu
Gói Standard & Pro

Tổng quan

Nguồn dữ liệu thời gian thực cho phép chatbot của bạn truy cập dữ liệu trực tiếp từ hệ thống. Thay vì phản hồi tĩnh, AI của bạn có thể cung cấp thông tin cập nhật như tình trạng sẵn có, giá cả, thời gian chờ hoặc mức tồn kho.

Chỉ cần cung cấp một URL trả về dữ liệu của bạn (JSON hoặc văn bản thuần), và chatbot sẽ tự động bao gồm thông tin này khi trả lời các câu hỏi liên quan.

Nguồn dữ liệu thời gian thực tiêu chuẩn hỗ trợ nguồn cấp dữ liệu lên đến 200.000 ký tự (~500 mục). Đối với nguồn dữ liệu lớn hơn, xem Nguồn dữ liệu thời gian thực Max hỗ trợ lên đến 10.000.000 ký tự (~25.000 mục).

Cách hoạt động

  1. Bạn cung cấp một URL - Một điểm cuối API hoặc trang trả về dữ liệu trực tiếp của bạn
  2. Chatbot lấy dữ liệu - AI đọc toàn bộ nguồn dữ liệu với mỗi tin nhắn được gửi, đảm bảo phản hồi luôn sử dụng dữ liệu mới nhất
  3. Câu trả lời động - Phản hồi bao gồm dữ liệu thời gian thực từ nguồn của bạn
Trợ lý AI
Tối nay bạn còn phòng trống không?
Có! Chúng tôi còn phòng trống tối nay:

Phòng Suite Cao cấp - Còn 3 phòng với giá $299/đêm
Phòng Tiêu chuẩn - Còn 8 phòng với giá $149/đêm

Bạn có muốn tôi giúp đặt phòng không?
Còn ngày mai thì sao?
Cho ngày mai chúng tôi có:

Phòng Suite Cao cấp - 2 phòng với giá $299/đêm
Phòng Tiêu chuẩn - 5 phòng với giá $149/đêm

Trường hợp Sử dụng

Nguồn dữ liệu thời gian thực hoàn hảo cho các doanh nghiệp cần cung cấp thông tin hiện tại:

Khách sạn Tình trạng phòng trống và giá theo ngày
Nhà hàng Thời gian chờ, tình trạng bàn trống, giờ mở cửa
Thương mại điện tử Mức tồn kho và tình trạng sản phẩm
Dịch vụ Khung giờ hẹn và lịch trình

Thiết lập

Thêm nguồn dữ liệu thời gian thực chỉ cần vài bước:

1
Tạo điểm cuối dữ liệu của bạn Thiết lập một URL trả về dữ liệu trực tiếp của bạn (API hoặc trang web)
2
Đi đến Nguồn dữ liệu thời gian thực Từ menu trang web của bạn, nhấp vào "Nguồn dữ liệu thời gian thực\
3
Nhập URL của bạn Dán URL trả về dữ liệu của bạn và nhấp Lưu

Mẹo: Đảm bảo điểm cuối của bạn có thể truy cập công khai (không yêu cầu xác thực) để chatbot có thể lấy dữ liệu.

Xác minh kết nối

Sau khi lưu URL nguồn dữ liệu, Asyntai tự động xác minh kết nối. Bạn sẽ thấy một thẻ trạng thái hiển thị:

  • Trạng thái kết nối — URL có được truy cập thành công hay không
  • Định dạng dữ liệu — định dạng được phát hiện (JSON, HTML/XML hoặc Văn bản thuần)
  • Kích thước phản hồi — lượng dữ liệu được trả về
  • Xem trước nội dung — một đoạn trích của phản hồi để bạn có thể xác nhận đó là dữ liệu đúng

Nếu kết nối trực tiếp thất bại, Asyntai sẽ tự động thử proxy dự phòng để truy cập URL của bạn. Nếu cả hai phương pháp đều thất bại, URL của bạn vẫn được lưu — bạn chỉ cần xem thông báo với các đề xuất khắc phục sự cố.

Định dạng được hỗ trợ

URL nguồn dữ liệu của bạn nên trả về dữ liệu ở một trong các định dạng sau:

Định dạng JSON

Dữ liệu có cấu trúc hoạt động tốt nhất cho thông tin phức tạp như tồn kho hoặc lịch trình.

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

Định dạng văn bản thuần

Văn bản đơn giản phù hợp cho thông tin đơn giản.

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

Thẻ sản phẩm động

Nếu nguồn dữ liệu thời gian thực của bạn chứa thông tin sản phẩm (như tồn kho, phòng hoặc dịch vụ), bạn có thể bật Thẻ sản phẩm động để hiển thị chúng dưới dạng thẻ trực quan đẹp mắt trong cuộc trò chuyện.

Cách bật

  1. Đi đến cài đặt Nguồn dữ liệu thời gian thực
  2. Thêm URL nguồn dữ liệu của bạn (xem ví dụ)
  3. Bật "Kích hoạt thẻ sản phẩm động"
  4. Lưu cài đặt của bạn

Định dạng dữ liệu

Bao gồm chi tiết sản phẩm trong nguồn dữ liệu với các trường như:

  • name - Tên sản phẩm/mục (bắt buộc)
  • price — Giá hiển thị (ví dụ: "$99.99")
  • description — Mô tả ngắn
  • image_url - URL hình ảnh sản phẩm
  • button_link — Liên kết cho nút hành động
  • in_stock — Trạng thái có sẵn (true/false)

Đây là ví dụ về cách nguồn dữ liệu JSON của bạn nên trông (xem tệp JSON mẫu):

{
  "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
    }
  ]
}

Mẹo: Thẻ sản phẩm động hoạt động tuyệt vời cho tồn kho thương mại điện tử, phòng khách sạn, vật phẩm cho thuê hoặc bất kỳ sản phẩm nào thay đổi thường xuyên. Đối với sản phẩm tĩnh, hãy sử dụng Thẻ sản phẩm thay thế.

Ví dụ theo ngành

Dưới đây là các ví dụ chi tiết về cách các doanh nghiệp khác nhau có thể cấu trúc nguồn dữ liệu thời gian thực:

Đây chỉ là các ví dụ - bạn có thể bao gồm bất kỳ trường nào liên quan đến doanh nghiệp của bạn. AI sẽ hiểu và sử dụng bất kỳ dữ liệu nào bạn cung cấp.
Cửa hàng thương mại điện tử Tình trạng sản phẩm, giá cả, URL và khuyến mãi
{
  "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"
  }
}
Khách hàng: "Bạn còn tai nghe không dây trong kho không?"
AI: "Có! Tai nghe không dây Pro còn hàng với 23 chiếc có sẵn. Chúng đang được giảm giá còn $119.99 (giá gốc $149.99). Bạn có thể xem và mua tại đây: techgadgets.com/products/wireless-headphones-pro. Ngoài ra, dùng mã SAVE20 để được giảm thêm 20% cho đơn hàng trên $100!"
Y tế / Phòng khám Tình trạng lịch hẹn và thời gian chờ
{
  "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"
  }
}
Bệnh nhân: "Tôi cần gặp bác sĩ da liễu trong tuần này"
AI: "Lịch hẹn da liễu sớm nhất là thứ Bảy ngày 18 tháng 1 lúc 10:00 SA hoặc 11:00 SA. Nếu không phù hợp, còn nhiều khung giờ vào thứ Hai ngày 20 lúc 9:00 SA, 2:00 CH hoặc 3:00 CH. Bạn có thể đặt lịch trực tuyến tại downtownmedical.com/book."
Trung tâm thể dục / Phòng tập Lịch lớp học và sức chứa cơ sở
{
  "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"
}
Thành viên: "Tuần này có lớp yoga nào không?"
AI: "Đây là các lớp yoga tuần này: Thứ Tư 7:00 CH Yoga Flow với Sarah (12 chỗ), Thứ Sáu 7:00 SA Yoga Flow với Sarah (15 chỗ), và Thứ Bảy 10:30 SA Yoga Gia đình với Sarah (10 chỗ). Bạn có thể đặt chỗ tại fitlifegym.com/classes."
Cho thuê xe / Dịch vụ ô tô Tình trạng xe theo ngày và địa điểm
{
  "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"}
  ]
}
Khách hàng: "Tôi cần một xe SUV cho cuối tuần này"
AI: "Chúng tôi có xe SUV vào thứ Sáu (còn 3 chiếc giá $89.99/ngày) và thứ Bảy (còn 1 chiếc giá $99.99/ngày), nhưng Chủ nhật đã hết. Đặt sớm nhé! Dùng mã WEEKEND15 để giảm 15%. Đặt xe tại quickrent.com/book."
Sự kiện / Địa điểm giải trí Chương trình, vé và lịch trình
{
  "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}
      ]
    }
  ]
}
Khách hàng: "Cuối tuần này có chương trình gì?"
AI: "Cuối tuần này chúng tôi có 'The Musical Experience' vào thứ Sáu và thứ Bảy lúc 7:30 CH (cũng có suất chiều lúc 2 CH vào thứ Bảy) - vé $85. Vào thứ Bảy và Chủ nhật lúc 8 CH có 'Comedy Night Live' giá $45. Tối thứ Sáu đang bán rất nhanh, chỉ còn 43 ghế! Đặt vé tại grandtheater.com/tickets."
Bất động sản / Quản lý tài sản Danh sách, giá cả và lịch xem
{
  "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"
}
Khách hàng: "Bạn có căn hộ nào dưới $1500 không?"
AI: "Chúng tôi có một căn hộ 1 phòng ngủ tại 789 Pine Road giá $1.200/tháng, sẵn sàng từ ngày 15 tháng 2. Diện tích 650 sqft với phòng tập, sân thượng và bảo vệ. Có buổi xem nhà mở vào thứ Bảy ngày 18 tháng 1 lúc 1:00 CH, hoặc đặt lịch xem riêng tại premierproperties.com/schedule. Xem chi tiết: premierproperties.com/listing/apt-12c"

Giới hạn kích thước

Nguồn dữ liệu thời gian thực tiêu chuẩn hỗ trợ nguồn cấp dữ liệu lên đến 200.000 ký tự. Số lượng mục bạn có thể bao gồm phụ thuộc vào lượng dữ liệu mỗi mục chứa — nguồn cấp dữ liệu với các mục ngắn gọn có thể chứa ~500 mục, trong khi nguồn cấp dữ liệu với mô tả dài có thể chỉ chứa một phần nhỏ. Nếu nguồn dữ liệu vượt quá giới hạn này, bạn sẽ thấy thông báo khi cố lưu.

Mẹo giảm kích thước nguồn dữ liệu

Nếu nguồn dữ liệu của bạn quá lớn, đây là một số cách để đưa nó về trong giới hạn:

  • Chỉ bao gồm sản phẩm bán chạy hoặc phổ biến — Tập trung vào các sản phẩm khách hàng hỏi nhiều nhất
  • Xóa các trường không cần thiết — Loại bỏ ID nội bộ, siêu dữ liệu hoặc các trường chatbot không cần
  • Rút ngắn mô tả — Sử dụng mô tả sản phẩm ngắn gọn thay vì nội dung marketing đầy đủ. Xem cấu trúc mẫu đề xuất để biết ví dụ về cách giữ các mục gọn nhẹ
  • Lọc theo tình trạng sẵn có — Chỉ bao gồm các mục hiện đang có hàng hoặc đang hoạt động
  • Chia theo danh mục — Tạo nguồn dữ liệu cho danh mục sản phẩm phù hợp nhất thay vì tất cả

Mẹo: Nếu bạn cần kết nối nguồn dữ liệu lớn hơn với hàng nghìn mục, hãy sử dụng Nguồn dữ liệu thời gian thực Max (gói Pro) hỗ trợ lên đến 10.000.000 ký tự (~25.000 mục).

Thực hành Tốt nhất

  • Giữ dữ liệu luôn mới — Điểm cuối của bạn nên trả về thông tin hiện tại, không phải dữ liệu đã được lưu trong bộ nhớ đệm
  • Bao gồm ngữ cảnh — Thêm ngày, giờ hoặc nhãn để AI hiểu dữ liệu có nghĩa gì
  • Cấu trúc rõ ràng — Sử dụng tên trường rõ ràng trong JSON để AI có thể diễn giải dữ liệu chính xác
  • Tập trung — Chỉ bao gồm dữ liệu chatbot cần để trả lời câu hỏi

Quan trọng: URL phải có thể truy cập công khai. Nếu điểm cuối của bạn yêu cầu xác thực, chatbot sẽ không thể lấy dữ liệu.

Xóa nguồn dữ liệu

Bạn có thể xóa nguồn dữ liệu bất cứ lúc nào bằng cách nhấp nút "Xóa nguồn dữ liệu" trong cài đặt. Chatbot sẽ quay lại chỉ sử dụng cơ sở kiến thức của bạn cho các phản hồi.

Lưu ý: Nguồn dữ liệu thời gian thực có sẵn trên các gói Standard và Pro. Cần kết nối nguồn dữ liệu lớn hơn với hàng nghìn mục? Xem Nguồn dữ liệu thời gian thực Max (gói Pro).

Thử ngay

Chưa có điểm cuối API riêng? Bạn có thể thử tính năng với một API công khai để xem cách hoạt động. Ví dụ, thử giá Bitcoin trực tiếp từ Binance:

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

Điều này trả về dữ liệu giá BTC/USDT thời gian thực. Sau khi kết nối, chatbot của bạn sẽ có thể trả lời các câu hỏi như "Giá Bitcoin hiện tại là bao nhiêu?" bằng dữ liệu trực tiếp.

Mẹo: Bạn có thể sử dụng bất kỳ API công khai nào trả về JSON hoặc văn bản thuần — dữ liệu thời tiết, giá cổ phiếu, tỷ giá hối đoái và nhiều hơn nữa. Thay thế bằng điểm cuối của riêng bạn khi bạn sẵn sàng.