Назад к панели управления

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

Узнайте, как использовать Asyntai

Поток данных в реальном времени

Connect your chatbot to live data sources for dynamic responses

Настройте Data Feed
Тарифы Standard и Pro

Обзор

Поток данных в реальном времени позволяет чат-боту получать актуальные данные из ваших систем. Вместо статических ответов ваш ИИ может предоставлять актуальную информацию: текущую доступность, цены, время ожидания или уровни запасов.

Просто укажите URL, возвращающий ваши данные (JSON или plain text), и чат-бот автоматически включит эту информацию при ответе на соответствующие вопросы.

Стандартная лента данных в реальном времени поддерживает потоки до 200 000 символов (~500 позиций). Для больших потоков данных см. Real-Time Data Feed Max, который поддерживает до 10 000 000 символов (~25 000 позиций).

Как это работает

  1. Вы указываете URL — API-эндпоинт или страница, возвращающая ваши актуальные данные
  2. Чат-бот получает данные — ИИ читает весь фид с каждым отправленным сообщением, обеспечивая использование самых актуальных данных в ответах
  3. Динамические ответы — ответы включают актуальные данные из вашего источника
ИИ-ассистент
Есть ли у вас свободные номера на сегодня?
Да! На сегодня есть свободные места:

Делюкс-люкс — осталось 3 номера по $299/ночь
Стандартный номер — осталось 8 номеров по $149/ночь

Помочь вам с бронированием?
А как насчёт завтра?
На завтра у нас есть:

Делюкс-люкс — 2 номера по $299/ночь
Стандартный номер — 5 номеров по $149/ночь

Случаи использования

Потоки данных в реальном времени идеально подходят для предприятий, которым необходимо предоставлять актуальную информацию:

Отели Наличие номеров и цены по датам
Рестораны Время ожидания, наличие столиков, часы работы
Электронная коммерция Уровни запасов и наличие товаров
Услуги Слоты и расписание записей

Настройка

Adding a real-time data feed takes just a few steps:

1
Создайте your data endpoint Настройте a URL that returns your live data (API or webpage)
2
Перейдите в Real-Time Data Feed В меню сайта нажмите «Поток данных в реальном времени»
3
Введите ваш URL Вставьте URL, возвращающий ваши данные, и нажмите «Сохранить»

Совет: Убедитесь, что ваш эндпоинт общедоступен (аутентификация не требуется), чтобы чат-бот мог получать данные.

Проверка подключения

После сохранения URL канала данных Asyntai автоматически проверяет подключение. Вы увидите карточку статуса с информацией:

  • Статус подключения — удалось ли успешно получить доступ к URL
  • Формат данных — определённый формат (JSON, HTML/XML или простой текст)
  • Размер ответа — объём возвращённых данных
  • Предпросмотр контента — фрагмент ответа, чтобы убедиться, что это нужные данные

Если прямое подключение не удалось, Asyntai автоматически попробует резервный прокси для доступа к вашему URL. Если оба метода не сработают, URL всё равно будет сохранён — вы просто увидите уведомление с советами по устранению проблемы.

Поддерживаемые форматы

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

Формат 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. Перейдите в Real-Time Data Feed settings
  2. Добавьте URL вашей ленты данных (см. пример)
  3. Toggle "Enable Dynamic Product Cards" ON
  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
    }
  ]
}

Совет: Динамические карточки товаров подходят для каталогов интернет-магазинов, номеров отеля и арендуемых товаров. Для статических продуктов используйте Карточки товаров.

Примеры по отраслям

Ниже приведены подробные примеры того, как разные виды бизнеса могут структурировать фиды данных в реальном времени:

Это просто примеры — вы можете включить любые поля, актуальные для вашего бизнеса. ИИ поймёт и будет использовать любые данные, которые вы предоставите.
Интернет-магазин Доступность продукта, цены, 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"
  }
}
Клиент: "Есть ли беспроводные наушники в наличии?"
ИИ: "Да! Беспроводные наушники Wireless Headphones Pro есть в наличии — доступно 23 единицы. Сейчас они продаются по акционной цене $119.99 (обычная цена $149.99). Посмотреть и купить: techgadgets.com/products/wireless-headphones-pro. Плюс используйте код 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"
  }
}
Пациент: "Мне нужно попасть к дерматологу на этой неделе"
ИИ: "Ближайшая запись к дерматологу — в субботу, 18 января, в 10:00 или 11:00. Если эти варианты не подходят, есть свободное время в понедельник, 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"
}
Участник: "Какие занятия йогой у вас есть на этой неделе?"
ИИ: "Вот занятия йогой на этой неделе: среда 19:00 Yoga Flow с Сарой (12 мест), пятница 7:00 Yoga Flow с Сарой (15 мест) и суббота 10:30 Семейная йога с Сарой (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"}
  ]
}
Клиент: "Мне нужен внедорожник на эти выходные"
ИИ: "В пятницу доступны внедорожники (осталось 3 по $89.99/день) и в субботу (остался 1 по $99.99/день), но воскресенье уже забронировано. Бронируйте поскорее! Используйте код 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}
      ]
    }
  ]
}
Клиент: "Какие шоу у вас на эти выходные?"
ИИ: "На этих выходных у нас «The Musical Experience» в пятницу и субботу в 19:30 (а также дневной спектакль в субботу в 14:00) — билеты по $85. В субботу и воскресенье в 20:00 — «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?"
ИИ: "У нас есть однокомнатная квартира по адресу 789 Pine Road за $1 200/месяц, доступна с 15 февраля. Площадь 650 кв. футов, включает доступ в спортзал, крышную террасу и консьержа. День открытых дверей — в субботу 18 января в 13:00, или запишитесь на частный показ: premierproperties.com/schedule. Подробнее: premierproperties.com/listing/apt-12c"

Ограничения по размеру

Стандартная передача данных в реальном времени поддерживает потоки до 200 000 символов. Количество элементов, которые можно включить, зависит от объёма данных в каждом элементе — поток с короткими и лаконичными записями может вместить около 500 элементов, тогда как поток с длинными описаниями может вместить лишь малую часть этого количества. Если ваш поток превышает этот лимит, при попытке сохранения появится уведомление.

Советы по уменьшению размера фида

Если ваш поток данных слишком большой, вот несколько способов уместить его в пределах лимита:

  • Включайте только бестселлеры или популярные товары — сосредоточьтесь на товарах, о которых чаще всего спрашивают клиенты
  • Удаляйте ненужные поля — уберите внутренние ID, метаданные или поля, которые чат-боту не нужны
  • Сокращайте описания — используйте лаконичные описания товаров вместо полных маркетинговых текстов. Ознакомьтесь с рекомендуемой примерной структурой, чтобы увидеть пример того, как сохранять записи компактными
  • Фильтр по наличию — включайте только те товары, которые сейчас в наличии или активны
  • Разбивайте по категориям — создайте ленту для наиболее релевантной категории товаров, а не для всего каталога

Совет: Если вам нужно подключить большую ленту данных с тысячами позиций, используйте Real-Time Data Feed Max (тариф Pro), который поддерживает до 10 000 000 символов (~25 000 позиций).

Лучшие практики

  • Поддерживайте актуальность данных — ваш эндпоинт должен возвращать текущую информацию, а не кешированные данные
  • Добавьте контекст — указывайте даты, время или метки, чтобы ИИ понимал смысл данных
  • Структурируйте чётко — используйте понятные имена полей в JSON, чтобы ИИ мог правильно интерпретировать данные
  • Будьте конкретны — включайте только те данные, которые нужны чат-боту для ответов на вопросы

Важно: URL должен быть публично доступен. Если ваш эндпоинт требует аутентификации, чат-бот не сможет получить данные.

Удалить поток данных

Вы можете удалить поток данных в любой момент, нажав кнопку «Удалить поток данных» в настройках. Чат-бот вернётся к использованию только базы знаний для ответов.

Примечание: Лента данных в реальном времени доступна на тарифах Standard и Pro. Нужно подключить большие потоки данных с тысячами позиций? См. Real-Time Data Feed Max (тариф Pro).

Попробовать

Ещё нет собственного API? Вы можете протестировать функцию с публичным API. Например, попробуйте актуальный курс Bitcoin с Binance:

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

Это возвращает актуальные данные о курсе BTC/USDT. После подключения ваш чат-бот сможет отвечать на вопросы вроде «Какой сейчас курс Bitcoin?» используя актуальные данные.

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