Обратно към таблото

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

Научете как да използвате Asyntai

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

Свържете вашия чатбот с източници на данни на живо за динамични отговори

Конфигуриране на потока от данни
Планове Standard и Pro

Преглед

Потокът от данни в реално време позволява на вашия чатбот да достъпва данни на живо от вашите системи. Вместо статични отговори, вашият AI може да предоставя актуална информация като текуща наличност, цени, време за чакане или нива на инвентар.

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

Стандартният поток от данни в реално време поддържа потоци до 200 000 символа (~500 елемента). За по-големи потоци от данни вижте Поток от данни в реално време Макс, който поддържа до 10 000 000 символа (~25 000 елемента).

Как работи

  1. Вие предоставяте URL адрес - API крайна точка или страница, която връща вашите данни на живо
  2. Чатботът извлича данни - AI чете целия поток при всяко изпратено съобщение, като гарантира, че отговорите винаги използват най-новите данни
  3. Динамични отговори - Отговорите включват данни в реално време от вашия източник
ИИ асистент
Имате ли свободни стаи за тази вечер?
Да! Имаме свободни места за тази вечер:

Луксозен апартамент - 3 стаи останали на $299/нощ
Стандартна стая - 8 стаи останали на $149/нощ

Искате ли да ви помогна с резервацията?
А утре?
За утре имаме:

Луксозен апартамент - 2 стаи на $299/нощ
Стандартна стая - 5 стаи на $149/нощ

Случаи на употреба

Потоците от данни в реално време са идеални за бизнеси, които трябва да предоставят актуална информация:

Хотели Наличност на стаи и цени по дата
Ресторанти Време за чакане, наличност на маси, работно време
Електронна търговия Нива на наличност и продуктова наличност
Услуги Часове за срещи и планиране

Настройка

Добавянето на поток от данни в реално време отнема само няколко стъпки:

1
Създайте вашата крайна точка за данни Set up a URL that returns your live data (API or webpage)
2
Отидете на Поток от данни в реално време От менюто на вашия уебсайт натиснете "Поток от данни в реално време\
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. Отидете на настройките за Поток от данни в реално време
  2. Добавете URL адреса на вашия поток от данни (вижте пример)
  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
    }
  ]
}

Съвет: Динамичните продуктови карти работят чудесно за инвентар на електронна търговия, хотелски стаи, артикули под наем или всякакви продукти, които се променят често. За статични продукти използвайте Продуктови карти вместо това.

Индустриални примери

Ето подробни примери за това как различни бизнеси могат да структурират своите потоци от данни в реално време:

Това са само примери - можете да включите всякакви полета, свързани с вашия бизнес. AI ще разбере и използва каквито и данни да предоставите.
Магазин за електронна търговия Продуктова наличност, цени, 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: "Да! Безжичните слушалки 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"
  }
}
Пациент: "Трябва да посетя дерматолог тази седмица"
AI: "Най-ранният час при дерматолог е в събота, 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"
}
Член: "Какви уроци по йога имате тази седмица?"
AI: "Ето уроците по йога тази седмица: сряда 19:00 Йога поток със Сара (12 места), петък 7:00 Йога поток със Сара (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"}
  ]
}
Клиент: "Имам нужда от SUV за този уикенд"
AI: "Имаме налични SUV-та за петък (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}
      ]
    }
  ]
}
Клиент: "Какви представления имате този уикенд?"
AI: "Този уикенд имаме '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?"
AI: "Имаме едностаен апартамент на 789 Pine Road за $1200/месец, наличен от 15 февруари. Той е 60 кв.м с достъп до фитнес, покривна тераса и портиер. Има ден на отворени врати в събота, 18 януари, в 13:00, или запазете частен оглед на premierproperties.com/schedule. Вижте детайли: premierproperties.com/listing/apt-12c"

Ограничения на размера

Стандартният поток от данни в реално време поддържа потоци до 200 000 символа. Броят елементи, които можете да включите, зависи от количеството данни, които съдържа всеки елемент — поток с кратки, стегнати записи може да побере ~500 елемента, докато поток с дълги описания може да побере само част от това. Ако вашият поток надхвърли този лимит, ще видите известие при опит за запазване.

Съвети за намаляване на размера на потока

Ако вашият поток е твърде голям, ето няколко начина да го приведете в рамките на лимита:

  • Включете само най-продаваните или популярни артикули — Фокусирайте се върху продуктите, за които клиентите питат най-често
  • Премахнете ненужни полета — Махнете вътрешни идентификатори, метаданни или полета, от които чатботът не се нуждае
  • Съкратете описанията — Използвайте кратки описания на продуктите вместо пълен маркетингов текст. Вижте препоръчителната примерна структура за пример как да запазите записите компактни
  • Филтрирайте по наличност — Включвайте само артикули, които в момента са в наличност или активни
  • Разделете по категория — Създайте поток за най-подходящата ви продуктова категория вместо за всичко

Съвет: Ако трябва да свържете по-голям поток от данни с хиляди елементи, използвайте Поток от данни в реално време Макс (план Pro), който поддържа до 10 000 000 символа (~25 000 елемента).

Най-добри практики

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

Важно: URL адресът трябва да бъде публично достъпен. Ако вашата крайна точка изисква удостоверяване, чатботът няма да може да извлече данните.

Премахване на потока от данни

Можете да премахнете потока от данни по всяко време, като натиснете бутона "Премахване на потока от данни" в настройките си. Чатботът ще се върне към използване само на вашата база знания за отговори.

Забележка: Потокът от данни в реално време е наличен за плановете Standard и Pro. Нуждаете се от свързване на по-големи потоци от данни с хиляди елементи? Вижте Поток от данни в реално време Макс (план Pro).

Изпробвайте

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

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

Това връща данни за цената на BTC/USDT в реално време. След свързване, вашият чатбот ще може да отговаря на въпроси като "Каква е текущата цена на Bitcoin?" с помощта на данни на живо.

Съвет: Можете да използвате всеки публичен API, който връща JSON или обикновен текст — данни за времето, цени на акции, обменни курсове и още. Заменете го с вашата собствена крайна точка, когато сте готови.