Powrót do panelu

Dokumentacja

Dowiedz się, jak korzystać z Asyntai

Dane w czasie rzeczywistym

Connect your chatbot to live data sources for dynamic responses

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.

Wystarczy podać adres URL zwracający Twoje dane (JSON lub zwykły tekst), a chatbot automatycznie uwzględni 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 pobiera dane — AI odczytuje cały kanał z każdą wysłaną wiadomością, zapewniając, że odpowiedzi zawsze korzystają z najnowszych danych
  3. Dynamiczne odpowiedzi — odpowiedzi zawierają dane w czasie rzeczywistym z Twojego źródła
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

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

1
Utwórz swój punkt końcowy danych Set up a URL that returns your live data (API or webpage)
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

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

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 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. Toggle "Enable Dynamic Product Cards" ON
  4. Zapisz ustawienia

Format danych

Include product details in your feed with fields like:

  • 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 pozycję, 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: Możesz użyć dowolnego publicznego API zwracającego JSON lub zwykły tekst — dane pogodowe, kursy akcji, kursy walut i inne. Zastąp je własnym punktem końcowym, gdy będziesz gotowy.