Повернутися до панелі керування

Документація

Дізнайтеся, як використовувати Asyntai

Потік даних у реальному часі

Підключіть ваш чат-бот до джерел даних у реальному часі для динамічних відповідей

Налаштувати канал даних
Тарифи Standard та Pro

Огляд

Канал даних у реальному часi дозволяє вашому чатботу отримувати актуальнi данi з ваших систем. Замiсть статичних вiдповiдей ваш ШI може надавати актуальну iнформацiю, таку як поточна наявнiсть, цiни, час очiкування або рiвнi запасiв.

Просто вкажіть URL-адресу, яка повертає ваші дані (JSON, CSV або звичайний текст), і чат-бот автоматично використовуватиме цю інформацію при відповіді на відповідні запитання.

Стандартний канал даних у реальному часi пiдтримує канали до 200 000 символiв (~500 елементiв). Для бiльших каналiв даних дивiться Канал даних у реальному часi Max, який пiдтримує до 10 000 000 символiв (~25 000 елементiв).

Як це працює

  1. Ви надаєте URL - Кiнцеву точку API або сторiнку, яка повертає вашi актуальнi данi
  2. Чат-бот індексує ваші дані - Ваш фід автоматично індексується та підтримується в актуальному стані. Для кожної розмови ШІ знаходить і використовує найбільш релевантні елементи з вашого фіду
  3. Динамiчнi вiдповiдi - Вiдповiдi включають данi в реальному часi з вашого джерела

Порада: Зміни в існуючих товарах, таких як ціни, рівні запасів та наявність, відображаються миттєво. Коли ви додаєте абсолютно нові продукти або товари до вашого фіду, вони з'являться у відповідях чат-бота протягом 24 годин.

ШI-асистент
Чи є у вас вільні номери на сьогодні?
Так! У нас є наявність на сьогодні:

Люкс - залишилось 3 номери за $299/ніч
Стандартний номер - залишилось 8 номерів за $149/ніч

Бажаєте, щоб я допоміг вам забронювати?
А як щодо завтра?
На завтра у нас є:

Люкс - 2 номери за $299/ніч
Стандартний номер - 5 номерів за $149/ніч

Випадки використання

Канали даних у реальному часi iдеально пiдходять для бiзнесiв, яким потрiбно надавати актуальну iнформацiю:

Готелі Наявність номерів та ціни за датою
Ресторани Час очікування, наявність столиків, години роботи
Електронна комерція Рівні запасів та наявність товарів
Послуги Вільні місця для записів та розклад

Налаштування

Додавання каналу даних у реальному часі потребує лише кількох кроків:

1
Створіть кінцеву точку даних Налаштуйте URL-адресу, яка повертає ваші актуальні дані (API або вебсторінку)
2
Перейдіть до каналу даних у реальному часі У меню вашого вебсайту натисніть "Канал даних у реальному часі"
3
Введіть вашу URL-адресу Вставте URL-адресу, яка повертає ваші дані, та натисніть "Зберегти"

Порада: Переконайтеся, що ваша кiнцева точка є публiчно доступною (аутентифiкацiя не потрiбна), щоб чатбот мiг отримати данi.

Перевірка з'єднання

Пiсля збереження URL-адреси каналу даних Asyntai автоматично перевiряє з'єднання. Ви побачите картку статусу, що показує:

  • Статус з'єднання — чи було URL-адресу успішно досягнуто
  • Формат даних — виявлений формат (JSON, HTML/XML або звичайний текст)
  • Розмір відповіді — скільки даних було повернуто
  • Попереднiй перегляд вмiсту — фрагмент вiдповiдi, щоб ви могли пiдтвердити, що це правильнi данi

Якщо пряме з'єднання не вдається, Asyntai автоматично спробує резервний проксi для доступу до вашої URL-адреси. Якщо обидва методи не спрацюють, ваша URL-адреса все одно збережеться — ви просто побачите повiдомлення з порадами щодо усунення неполадок.

Підтримувані формати

URL вашого каналу даних повинен повертати дані в одному з цих форматів:

Формат JSON

Структурованi данi найкраще пiдходять для складної iнформацiї, такої як iнвентар або розклади.

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

Формат CSV

Значення, розділені комами, чудово підходять для каталогів товарів, експорту інвентарю та даних електронних таблиць.

id,title,description,availability,price,link,image_link
101,"Wireless Headphones","Noise-cancelling, 30h battery","in stock","149.99 USD",https://store.com/headphones,https://store.com/img/hp.jpg
102,"Smart Watch","GPS, heart rate monitor","in stock","299.99 USD",https://store.com/watch,https://store.com/img/sw.jpg
103,"Portable Charger","20000mAh USB-C","out of stock","39.99 USD",https://store.com/charger,https://store.com/img/pc.jpg

Формат звичайного тексту

Звичайний текст підходить для простої інформації.

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

Динамічні картки товарів

Якщо ваш канал даних у реальному часi мiстить iнформацiю про товари (наприклад, iнвентар, номери або послуги), ви можете увiмкнути Динамiчнi картки товарiв, щоб вiдображати їх як гарнi вiзуальнi картки у чатi.

Як увімкнути

  1. Перейдiть до налаштувань каналу даних у реальному часi
  2. Додайте URL-адресу каналу даних (дивiться приклад)
  3. Увімкніть перемикач "Увімкнути динамічні картки товарів"
  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
    }
  ]
}

Порада: Динамiчнi картки товарiв чудово пiдходять для iнвентарю електронної комерцiї, готельних номерiв, товарiв для оренди або будь-яких товарiв, що часто змiнюються. Для статичних товарiв використовуйте Картки товарiв.

Галузеві приклади

Ось детальнi приклади того, як рiзнi бiзнеси можуть структурувати своїх канали даних у реальному часi:

Це лише приклади - ви можете включити будь-якi поля, релевантнi для вашого бiзнесу. ШI зрозумiє та використає будь-якi наданi вами данi.
Iнтернет-магазин Наявність товарів, ціни, 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"
  }
}
Клієнт: "Чи є у вас бездротові навушники в наявності?"
ШI: "Так! Wireless Headphones Pro є в наявностi - доступно 23 одиницi. Зараз вони продаються за $119.99 (звичайна цiна $149.99). Ви можете переглянути та придбати їх тут: techgadgets.com/products/wireless-headphones-pro. Крiм того, використовуйте код SAVE20 для додаткової знижки 20% на замовлення понад $100!"
Охорона здоров'я / Медична клініка Наявність записів та час очікування
{
  "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"
  }
}
Пацієнт: "Мені потрібно потрапити до дерматолога цього тижня"
ШI: "Найближчий запис до дерматолога - субота, 18 сiчня, о 10:00 або 11:00. Якщо це не пiдходить, є бiльше вiльних мiсць у понедiлок, 20-го, о 9:00, 14:00 або 15:00. Ви можете записатися онлайн на 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"
}
Учасник: "Які заняття з йоги є цього тижня?"
ШI: "Ось заняття з йоги цього тижня: середа 19:00 Yoga Flow з Сарою (12 мiсць), п'ятниця 7:00 Yoga Flow з Сарою (15 мiсць) та субота 10:30 Сiмейна йога з Сарою (10 мiсць). Записатися можна на 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"}
  ]
}
Клієнт: "Мені потрібен позашляховик на ці вихідні"
ШI: "У нас є позашляховики на п'ятницю (залишилось 3 за $89.99/день) та суботу (залишився 1 за $99.99/день), але на недiлю все зайнято. Бронюйте скорiше! Використовуйте код 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}
      ]
    }
  ]
}
Клієнт: "Які вистави є цих вихідних?"
ШI: "Цих вихiдних у нас "The Musical Experience" в п'ятницю та суботу о 19:30 (також матине о 14:00 в суботу) - квитки по $85. В суботу та недiлю о 20:00 - "Comedy Night Live" по $45. Квитки на п'ятничний вечiр швидко розкуповуються - залишилось лише 43 мiсця! Бронюйте на 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?"
ШI: "У нас є однокiмнатна квартира на 789 Pine Road за $1200/мiсяць, доступна з 15 лютого. Площа 650 кв. футів, з доступом до спортзалу, терасою на даху та консьєржем. День вiдкритих дверей — субота, 18 сiчня, о 13:00, або запишiться на приватний перегляд на premierproperties.com/schedule. Деталi: premierproperties.com/listing/apt-12c"

Обмеження розміру

Стандартний канал даних у реальному часi пiдтримує канали до 200 000 символiв. Кiлькiсть елементiв, якi ви можете включити, залежить вiд обсягу даних кожного елемента — канал з короткими, стислими записами може вмiстити ~500 елементiв, тодi як канал з довгими описами може вмiстити лише частину. Якщо ваш канал перевищує цей лiмiт, ви побачите повiдомлення при спробi зберегти.

Поради щодо зменшення розміру каналу

Якщо ваш канал занадто великий, ось кілька способів вмістити його в ліміт:

  • Включайте лише найпопулярнiшi товари — Зосередьтеся на товарах, про якi клiєнти запитують найчастiше
  • Видалiть непотрiбнi поля — Прибирайте внутрiшнi iдентифiкатори, метаданi або поля, якi чатботу не потрiбнi
  • Скоротiть описи — Використовуйте стислi описи товарiв замiсть повних маркетингових текстiв. Дивiться рекомендовану зразкову структуру для прикладу компактних записiв
  • Фiльтруйте за наявнiстю — Включайте лише товари, якi зараз є в наявностi або активнi
  • Роздiлiть за категорiями — Створiть канал для найбiльш релевантної категорiї товарiв замiсть усього

Порада: Якщо вам потрiбно пiдключити бiльший канал даних з тисячами елементiв, використовуйте Канал даних у реальному часi Max (план Pro), який пiдтримує до 10 000 000 символiв (~25 000 елементiв).

Найкращі практики

  • Пiдтримуйте данi актуальними — Ваша кiнцева точка повинна повертати поточну iнформацiю, а не кешованi данi
  • Включайте контекст — Додавайте дати, час або мiтки, щоб ШI розумiв, що означають данi
  • Структуруйте чiтко — Використовуйте зрозумiлi назви полiв у JSON, щоб ШI мiг правильно iнтерпретувати данi
  • Зберiгайте фокус — Включайте лише данi, якi потрiбнi чатботу для вiдповiдей на запитання

Важливо: URL-адреса повинна бути публiчно доступною. Якщо ваша кiнцева точка вимагає аутентифiкацiї, чатбот не зможе отримати данi.

Видалити канал даних

Ви можете видалити канал даних у будь-який час, натиснувши кнопку "Видалити канал даних" у налаштуваннях. Чатбот повернеться до використання лише бази знань для вiдповiдей.

Примітка: Канал даних у реальному часi доступний на планах Standard та Pro. Потрiбно пiдключити бiльшi канали даних з тисячами елементiв? Дивiться Канал даних у реальному часi Max (план Pro).

Спробуйте

Ще не маєте власної кiнцевої точки API? Ви можете протестувати цю функцiю з публiчним API, щоб побачити, як це працює. Наприклад, спробуйте актуальну цiну Bitcoin з Binance:

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

Це повертає данi про цiну BTC/USDT у реальному часi. Пiсля пiдключення ваш чатбот зможе вiдповiдати на запитання на кшталт "Яка поточна цiна Bitcoin?" з використанням актуальних даних.

Порада: You can use any public API that returns JSON or plain text — weather data, stock prices, exchange rates, and more. Replace it with your own endpoint when you're ready.

Platform Guides

Using a specific CMS or e-commerce platform? We have step-by-step setup instructions for each — pick yours below to jump straight to the guide. The setup works for both Real-Time Data Feed and Real-Time Data Feed Max; only the feed size limits differ.