Powrót do panelu

Dokumentacja

Dowiedz się, jak korzystać z Asyntai

Dane w czasie rzeczywistym

Połącz swojego chatbota z danymi na żywo, aby uzyskiwać dynamiczne odpowiedzi

Konfiguruj źródło danych
Plany Standard i Pro

Przegląd

Źródło danych w czasie rzeczywistym umożliwia Twojemu chatbotowi dostęp do bieżących danych z Twoich systemów. Zamiast statycznych odpowiedzi, Twoje AI może dostarczać aktualne informacje, takie jak dostępność, ceny, czas oczekiwania czy stany magazynowe.

Po prostu podaj URL, który zwraca Twoje dane (JSON, CSV lub zwykły tekst), a chatbot automatycznie wykorzysta te informacje przy odpowiadaniu na odpowiednie pytania.

Standardowe Źródło danych w czasie rzeczywistym obsługuje źródła do 200 000 znaków (~500 pozycji). W przypadku większych źródeł danych zobacz Źródło danych w czasie rzeczywistym Max, które obsługuje do 10 000 000 znaków (~25 000 pozycji).

Jak to działa

  1. Podajesz adres URL — punkt końcowy API lub stronę zwracającą Twoje bieżące dane
  2. Chatbot indeksuje Twoje dane - Twój feed jest automatycznie indeksowany i utrzymywany na bieżąco. Dla każdej rozmowy AI znajduje i wykorzystuje najbardziej odpowiednie elementy z Twojego feedu
  3. Dynamiczne odpowiedzi — odpowiedzi zawierają dane w czasie rzeczywistym z Twojego źródła

Wskazówka: Zmiany w istniejących pozycjach, takich jak ceny, poziomy zapasów i dostępność, są odzwierciedlane natychmiast. Gdy dodasz zupełnie nowe produkty lub pozycje do swojego feedu, pojawią się one w odpowiedziach chatbota w ciągu 24 godzin.

Asystent AI
Czy macie wolne pokoje na dzisiejszą noc?
Tak! Mamy dostępność na dzisiejszą noc:

Apartament Deluxe — pozostały 3 pokoje po 299 $/noc
Pokój standardowy — pozostało 8 pokoi po 149 $/noc

Czy chciałbyś, abym pomógł Ci zarezerwować?
A co z jutrem?
Na jutro mamy:

Apartament Deluxe — 2 pokoje po 299 $/noc
Pokój standardowy — 5 pokoi po 149 $/noc

Przypadki użycia

Źródła danych w czasie rzeczywistym są idealne dla firm, które muszą dostarczać aktualne informacje:

Hotele Dostępność pokoi i ceny według daty
Restauracje Czas oczekiwania, dostępność stolików, godziny otwarcia
E-commerce Stany magazynowe i dostępność produktów
Usługi Wolne terminy i harmonogramy

Konfiguracja

Dodanie źródła danych w czasie rzeczywistym zajmuje tylko kilka kroków:

1
Utwórz swój punkt końcowy danych Skonfiguruj adres URL, który zwraca Twoje dane na żywo (API lub strona internetowa)
2
Przejdź do Źródła danych w czasie rzeczywistym W menu swojej strony kliknij "Źródło danych w czasie rzeczywistym"
3
Wprowadź swój adres URL Wklej adres URL zwracający Twoje dane i kliknij Zapisz

Wskazówka: Upewnij się, że Twój punkt końcowy jest publicznie dostępny (bez wymaganej autoryzacji), aby chatbot mógł pobrać dane.

Weryfikacja połączenia

Po zapisaniu adresu URL źródła danych Asyntai automatycznie weryfikuje połączenie. Zobaczysz kartę statusu pokazującą:

  • Status połączenia — czy adres URL został pomyślnie osiągnięty
  • Format danych — wykryty format (JSON, HTML/XML lub zwykły tekst)
  • Rozmiar odpowiedzi — ile danych zostało zwróconych
  • Podgląd treści — fragment odpowiedzi, dzięki któremu możesz potwierdzić, że to właściwe dane

Jeśli bezpośrednie połączenie się nie powiedzie, Asyntai automatycznie spróbuje użyć zapasowego proxy, aby dotrzeć do Twojego adresu URL. Jeśli obie metody zawiodą, Twój adres URL zostanie mimo to zapisany — zobaczysz jedynie powiadomienie z sugestiami rozwiązywania problemów.

Obsługiwane formaty

URL Twojego feedu danych powinien zwracać dane w jednym z tych formatów:

Format JSON

Dane strukturalne najlepiej sprawdzają się w przypadku złożonych informacji, takich jak asortyment czy harmonogramy.

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

Format CSV

Wartości rozdzielone przecinkami świetnie sprawdzają się w katalogach produktów, eksportach inwentarza i danych arkuszy kalkulacyjnych.

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

Format zwykłego tekstu

Zwykły tekst sprawdza się w przypadku prostych informacji.

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

Dynamiczne karty produktów

Jeśli Twoje źródło danych w czasie rzeczywistym zawiera informacje o produktach (takich jak asortyment, pokoje lub usługi), możesz włączyć Dynamiczne karty produktów, aby wyświetlać je jako atrakcyjne wizualne karty na czacie.

Jak włączyć

  1. Przejdź do ustawień Źródła danych w czasie rzeczywistym
  2. Dodaj adres URL swojego źródła danych (zobacz przykład)
  3. Przełącz \"Włącz dynamiczne karty produktów\" na ON
  4. Zapisz ustawienia

Format danych

Dołącz szczegóły produktów w swoim feedzie z polami takimi jak:

  • name — nazwa produktu/pozycji (wymagane)
  • price — wyświetlana cena (np. "99,99 $")
  • description — krótki opis
  • image_url — adres URL obrazu produktu
  • button_link — link dla przycisku akcji
  • in_stock — status dostępności (true/false)

Oto przykład, jak powinno wyglądać Twoje źródło JSON (zobacz przykładowy plik 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
    }
  ]
}

Wskazówka: Dynamiczne karty produktów świetnie sprawdzają się w przypadku asortymentu e-commerce, pokoi hotelowych, przedmiotów do wynajmu lub dowolnych produktów, które często się zmieniają. W przypadku produktów statycznych użyj Kart produktów.

Przykłady branżowe

Oto szczegółowe przykłady, jak różne firmy mogą strukturyzować swoje źródła danych w czasie rzeczywistym:

To tylko przykłady — możesz uwzględnić dowolne pola istotne dla Twojej firmy. AI zrozumie i wykorzysta dowolne dane, które dostarczysz.
Sklep e-commerce Dostępność produktów, ceny, adresy URL i promocje
{
  "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"
  }
}
Klient: "Czy macie bezprzewodowe słuchawki w magazynie?"
AI: "Tak! Bezprzewodowe słuchawki Pro są dostępne — mamy 23 sztuki. Obecnie są w promocji za 119,99 $ (regularnie 149,99 $). Możesz je zobaczyć i kupić tutaj: techgadgets.com/products/wireless-headphones-pro. Dodatkowo użyj kodu SAVE20, aby uzyskać dodatkowe 20% zniżki na zamówienia powyżej 100 $!"
Opieka zdrowotna / Klinika medyczna Dostępność wizyt i czas oczekiwania
{
  "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"
  }
}
Pacjent: "Muszę umówić się do dermatologa w tym tygodniu"
AI: "Najwcześniejsza wizyta dermatologiczna jest w sobotę 18 stycznia o 10:00 lub 11:00. Jeśli te terminy nie odpowiadają, więcej dostępnych godzin jest w poniedziałek 20 o 9:00, 14:00 lub 15:00. Możesz zarezerwować online na downtownmedical.com/book."
Centrum fitness / Siłownia Harmonogramy zajęć i pojemność obiektu
{
  "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"
}
Członek: "Jakie zajęcia jogi macie w tym tygodniu?"
AI: "Oto zajęcia jogi w tym tygodniu: środa 19:00 Yoga Flow z Sarah (12 miejsc), piątek 7:00 Yoga Flow z Sarah (15 miejsc) i sobota 10:30 Joga rodzinna z Sarah (10 miejsc). Możesz zarezerwować na fitlifegym.com/classes."
Wynajem samochodów / Usługi motoryzacyjne Dostępność pojazdów według daty i lokalizacji
{
  "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"}
  ]
}
Klient: "Potrzebuję SUV-a na ten weekend"
AI: "Mamy dostępne SUV-y w piątek (3 pozostałe po 89,99 $/dzień) i sobotę (1 pozostały po 99,99 $/dzień), ale niedziela jest wyprzedana. Rezerwuj szybko! Użyj kodu WEEKEND15, aby uzyskać 15% zniżki. Zarezerwuj na quickrent.com/book."
Wydarzenia / Miejsce rozrywki Spektakle, bilety i harmonogramy
{
  "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}
      ]
    }
  ]
}
Klient: "Jakie spektakle macie w ten weekend?"
AI: "W ten weekend mamy „The Musical Experience” w piątek i sobotę o 19:30 (również popołudniówka o 14:00 w sobotę) — bilety po 85 $. W sobotę i niedzielę o 20:00 „Comedy Night Live” po 45 $. Piątkowy wieczór sprzedaje się szybko — zostało tylko 43 miejsca! Rezerwuj na grandtheater.com/tickets."
Nieruchomości / Zarządzanie nieruchomościami Oferty, ceny i harmonogramy oglądania
{
  "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"
}
Klient: "Jakie mieszkania macie poniżej 1500 $?"
AI: "Mamy 1-pokojowe mieszkanie przy 789 Pine Road za 1200 $/miesiąc, dostępne od 15 lutego. Ma 60 m² z dostępem do siłowni, tarasem na dachu i portierem. Dzień otwarty w sobotę 18 stycznia o 13:00 lub umów prywatne oględziny na premierproperties.com/schedule. Szczegóły: premierproperties.com/listing/apt-12c"

Limity rozmiaru

Standardowe Źródło danych w czasie rzeczywistym obsługuje źródła do 200 000 znaków. Liczba elementów, które możesz uwzględnić, zależy od ilości danych w każdym elemencie — źródło z krótkimi, zwięzłymi wpisami może pomieścić ok. 500 elementów, podczas gdy źródło z długimi opisami może pomieścić tylko ułamek tej liczby. Jeśli Twoje źródło przekroczy ten limit, zobaczysz powiadomienie podczas próby zapisania.

Wskazówki dotyczące zmniejszenia rozmiaru źródła danych

Jeśli Twoje źródło danych jest zbyt duże, oto kilka sposobów na zmieszczenie go w limicie:

  • Uwzględnij tylko bestsellery lub popularne produkty — skup się na produktach, o które klienci pytają najczęściej
  • Usuń zbędne pola — pomiń wewnętrzne identyfikatory, metadane lub pola, których chatbot nie potrzebuje
  • Skróć opisy — używaj zwięzłych opisów produktów zamiast pełnych tekstów marketingowych. Zobacz zalecaną przykładową strukturę, aby dowiedzieć się, jak utrzymać wpisy w zwięzłej formie
  • Filtruj według dostępności — uwzględnij tylko pozycje, które są aktualnie dostępne lub aktywne
  • Podziel według kategorii — utwórz źródło dla najbardziej istotnej kategorii produktów zamiast dla wszystkiego

Wskazówka: Jeśli potrzebujesz połączyć większe źródło danych z tysiącami pozycji, użyj Źródła danych w czasie rzeczywistym Max (plan Pro), które obsługuje do 10 000 000 znaków (~25 000 pozycji).

Najlepsze praktyki

  • Utrzymuj dane aktualne — Twój punkt końcowy powinien zwracać bieżące informacje, a nie dane z pamięci podręcznej
  • Uwzględnij kontekst — dodaj daty, godziny lub etykiety, aby AI rozumiało, co oznaczają dane
  • Strukturyzuj przejrzyście — używaj jasnych nazw pól w JSON, aby AI mogło poprawnie interpretować dane
  • Zachowaj skupienie — uwzględnij tylko dane, których chatbot potrzebuje do odpowiadania na pytania

Ważne: Adres URL musi być publicznie dostępny. Jeśli Twój punkt końcowy wymaga autoryzacji, chatbot nie będzie mógł pobrać danych.

Usuń źródło danych

Możesz usunąć źródło danych w dowolnym momencie, klikając przycisk "Usuń źródło danych" w ustawieniach. Chatbot powróci do korzystania wyłącznie z Twojej bazy wiedzy przy udzielaniu odpowiedzi.

Uwaga: Źródło danych w czasie rzeczywistym jest dostępne w planach Standard i Pro. Potrzebujesz połączyć większe źródła danych z tysiącami pozycji? Zobacz Źródło danych w czasie rzeczywistym Max (plan Pro).

Wypróbuj

Nie masz jeszcze własnego punktu końcowego API? Możesz przetestować funkcje za pomocą publicznego API, aby zobaczyć, jak działa. Na przykład wypróbuj bieżącą cenę Bitcoin z Binance:

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

To zwraca dane o cenie BTC/USDT w czasie rzeczywistym. Po połączeniu Twój chatbot będzie mógł odpowiadać na pytania typu "Jaka jest aktualna cena Bitcoin?" korzystając z bieżących danych.

Wskazówka: 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.