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

Connect your chatbot to live data sources for dynamic responses

Тарифи Standard та Pro

Огляд

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

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

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

Як це працює

Ви надаєте URL - Кiнцеву точку API або стор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:

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

Бажаєте, щоб я допомiг вам забронювати?

А як щодо завтра?

На завтра у нас є:

Люкс - 2 номери за $299/нiч
Стандартний номер - 5 номерiв за $149/н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нцеву точку даних Set up a URL that returns your live data (API or webpage)

Перейдiть до каналу даних у реальному часi У меню вашого вебсайту натиснiть "Канал даних у реальному часi\

Введiть вашу URL-адресу Вставте URL-адресу, яка повертає вашi данi, та натиснiть "Зберегти"

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

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

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

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

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

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

Your data feed URL should return data in one of these formats:

Формат 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
    }
  ]
}

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

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

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 вiзуальнi картки у чатi.

Як увiмкнути

Перейдiть до налаштувань каналу даних у реальному часi
Додайте URL-адресу каналу даних (дивiться приклад)
Увiмкнiть перемикач "Увiмкнути динамiчнi картки товарiв"
Збережiть налаштування

Формат даних

Включiть деталi товарiв у ваш канал з такими полями:

name - Назва товару/елемента (обов'язково)
price — Цiна для вiдображення (наприклад, "$99.99")
description — Короткий опис
image_url - URL-адреса зображення товару
button_link — Посилання для кнопки дiї
in_stock — Статус наявностi (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.

Iнтернет-магазин Наявнiсть товарiв, цiни, URL-адреси та промоакц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"
  }
}

Клiєнт: "Чи є у вас бездротовi навушники в наявностi?"

ШI: "Так! Wireless Headphones Pro є в наявностi - доступно 23 одиницi. Зараз вони продаються за $119.99 (звичайна цiна $149.99). Ви можете переглянути та придбати їх тут: techgadgets.com/products/wireless-headphones-pro. Крiм того, використовуйте код SAVE20 для додаткової знижки 20% на замовлення понад $100!"

Охорона здоров'я / Медична клiнiка Наявнiсть записiв та час очiкування

{
  "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єнт: "Менi потрiбно потрапити до дерматолога цього тижня"

ШI: "Найближчий запис до дерматолога - субота, 18 сiчня, о 10:00 або 11:00. Якщо це не пiдходить, є бiльше вiльних мiсць у понедiлок, 20-го, о 9:00, 14:00 або 15:00. Ви можете записатися онлайн на downtownmedical.com/book."

Фiтнес-центр / Спортзал Розклади занять та мiсткiсть залу

{
  "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 заняття з йоги є цього тижня?"

ШI: "Ось заняття з йоги цього тижня: середа 19:00 Yoga Flow з Сарою (12 мiсць), п'ятниця 7:00 Yoga Flow з Сарою (15 мiсць) та субота 10:30 Сiмейна йога з Сарою (10 мiсць). Записатися можна на fitlifegym.com/classes."

Оренда автомобiлiв / Автосервiс Наявнiсть автомобiлiв за датою та мiсцезнаходженням

{
  "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єнт: "Менi потрiбен позашляховик на цi вихiднi"

ШI: "У нас є позашляховики на п'ятницю (залишилось 3 за $89.99/день) та суботу (залишився 1 за $99.99/день), але на недiлю все зайнято. Бронюйте скорiше! Використовуйте код WEEKEND15 для знижки 15%. Забронювати на quickrent.com/book."

Подiї / Розважальний заклад Вистави, квитки та розклади

{
  "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 вистави є цих вихiдних?"

ШI: "Цих вихiдних у нас "The Musical Experience" в п'ятницю та суботу о 19:30 (також матине о 14:00 в суботу) - квитки по $85. В суботу та недiлю о 20:00 - "Comedy Night Live" по $45. Квитки на п'ятничний вечiр швидко розкуповуються - залишилось лише 43 мiсця! Бронюйте на grandtheater.com/tickets."

Нерухомiсть / Управлiння нерухомiстю Оголошення, цiни та розклад переглядiв

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

Клiєнт: "Якi квартири є до $1500?"

ШI: "У нас є однокiмнатна квартира на 789 Pine Road за $1200/мiсяць, доступна з 15 лютого. Площа 60 кв.м, з доступом до спортзалу, терасою на даху та консьєржем. День вiдкритих дверей - субота, 18 сiчня, о 13:00, або запишiться на приватний перегляд на premierproperties.com/schedule. Деталi: premierproperties.com/listing/apt-12c"

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

Стандартний канал даних у реальному час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в зам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тка: Канал даних у реальному час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?" з використанням актуальних даних.

Порада: Ви можете використовувати будь-який публiчний API, який повертає JSON або звичайний текст — данi про погоду, цiни акцiй, курси валют тощо. Замiнiть його на власну кiнцеву точку, коли будете готовi.

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