Înapoi la tabloul de bord

Documentație

Aflați cum să utilizați Asyntai

Flux de date în timp real

Conectează chatbot-ul tău la surse de date live pentru răspunsuri dinamice

Configurează fluxul de date
Planuri Standard și Pro

Prezentare generală

Fluxul de date în timp real permite chatbot-ului tău să acceseze date live din sistemele tale. În loc de răspunsuri statice, AI-ul tău poate furniza informații actualizate precum disponibilitatea curentă, prețurile, timpii de așteptare sau nivelurile de inventar.

Furnizează pur și simplu un URL care returnează datele tale (JSON sau text simplu), iar chatbot-ul va include automat aceste informații când răspunde la întrebări relevante.

Fluxul standard de date în timp real acceptă fluxuri de până la 200.000 de caractere (~500 de articole). Pentru fluxuri de date mai mari, vezi Flux de date în timp real Max care acceptă până la 10.000.000 de caractere (~25.000 de articole).

Cum funcționează

  1. Furnizezi un URL - Un endpoint API sau o pagină care returnează datele tale live
  2. Chatbot-ul preia datele - AI-ul citește întregul flux cu fiecare mesaj trimis, asigurând că răspunsurile folosesc întotdeauna cele mai recente date
  3. Răspunsuri dinamice - Răspunsurile includ date în timp real din sursa ta
Asistent AI
Aveți camere disponibile în seara aceasta?
Da! Avem disponibilitate pentru în seara aceasta:

Suită Deluxe - 3 camere rămase la 299$/noapte
Cameră Standard - 8 camere rămase la 149$/noapte

Doriți să vă ajut cu o rezervare?
Dar mâine?
Pentru mâine avem:

Suită Deluxe - 2 camere la 299$/noapte
Cameră Standard - 5 camere la 149$/noapte

Cazuri de utilizare

Fluxurile de date în timp real sunt perfecte pentru afacerile care trebuie să furnizeze informații curente:

Hoteluri Disponibilitatea camerelor și prețurile pe date
Restaurante Timpii de așteptare, disponibilitatea meselor, programul
E-commerce Niveluri de stoc și disponibilitatea produselor
Servicii Intervalele de programare și planificarea

Configurare

Adăugarea unui flux de date în timp real necesită doar câțiva pași:

1
Creează endpoint-ul tău de date Configurează un URL care returnează datele tale live (API sau pagină web)
2
Mergi la Fluxul de date în timp real Din meniul site-ului tău, apasă "Flux de date în timp real"
3
Introdu URL-ul tău Lipește URL-ul care returnează datele tale și apasă Salvează

Sfat: Asigură-te că endpoint-ul tău este accesibil public (fără autentificare necesară) pentru ca chatbot-ul să poată prelua datele.

Verificarea conexiunii

După salvarea URL-ului fluxului de date, Asyntai verifică automat conexiunea. Vei vedea un card de stare care afișează:

  • Starea conexiunii — dacă URL-ul a fost accesat cu succes
  • Formatul datelor — formatul detectat (JSON, HTML/XML sau Text simplu)
  • Dimensiunea răspunsului — câte date au fost returnate
  • Previzualizare conținut — un fragment din răspuns pentru a confirma că sunt datele corecte

Dacă conexiunea directă eșuează, Asyntai va încerca automat un proxy de rezervă pentru a accesa URL-ul tău. Dacă ambele metode eșuează, URL-ul tău este totuși salvat — vei vedea doar o notificare cu sugestii de depanare.

Formate acceptate

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

Format JSON

Datele structurate funcționează cel mai bine pentru informații complexe precum inventarul sau programările.

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

Format text simplu

Textul simplu funcționează pentru informații directe.

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

Carduri de produse dinamice

Dacă fluxul tău de date în timp real conține informații despre produse (precum inventar, camere sau servicii), poți activa Carduri de produse dinamice pentru a le afișa ca și carduri vizuale atractive în chat.

Cum să activezi

  1. Mergi la setările Flux de date în timp real
  2. Adaugă URL-ul fluxului tău de date (vezi exemplu)
  3. Toggle "Enable Dynamic Product Cards" ON
  4. Salvează setările

Format de date

Include detalii despre produse în fluxul tău cu câmpuri precum:

  • name - Numele produsului/articolului (obligatoriu)
  • price — Prețul afișat (de ex., "99,99$")
  • description — Descriere scurtă
  • image_url - URL-ul imaginii produsului
  • button_link — Link pentru butonul de acțiune
  • in_stock — Starea disponibilității (true/false)

Iată un exemplu de cum ar trebui să arate fluxul tău JSON (vezi fișierul JSON exemplu):

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

Sfat: Cardurile de produse dinamice funcționează excelent pentru inventar e-commerce, camere de hotel, articole de închiriat sau orice produse care se schimbă frecvent. Pentru produse statice, folosește în schimb Carduri de produse.

Exemple pe industrii

Iată exemple detaliate despre cum diferite afaceri își pot structura fluxurile de date în timp real:

Acestea sunt doar exemple - poți include orice câmpuri relevante pentru afacerea ta. AI-ul va înțelege și va folosi orice date furnizezi.
Magazin e-commerce Disponibilitatea produselor, prețuri, URL-uri și promoții
{
  "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"
  }
}
Client: "Aveți căștile wireless pe stoc?"
AI: "Da! Căștile Wireless Headphones Pro sunt pe stoc, cu 23 de unități disponibile. Sunt momentan la reducere la 119,99$ (în mod normal 149,99$). Le poți vizualiza și cumpăra aici: techgadgets.com/products/wireless-headphones-pro. În plus, folosește codul SAVE20 pentru o reducere suplimentară de 20% la comenzile de peste 100$!"
Sănătate / Clinică medicală Disponibilitatea programărilor și timpii de așteptare
{
  "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"
  }
}
Pacient: "Trebuie să văd un dermatolog săptămâna aceasta"
AI: "Cea mai apropiată programare la dermatologie este sâmbătă, 18 ianuarie, la ora 10:00 sau 11:00. Dacă acestea nu sunt convenabile, există mai multă disponibilitate luni, pe 20, la ora 9:00, 14:00 sau 15:00. Poți programa online la downtownmedical.com/book."
Centru de fitness / Sală de sport Programul cursurilor și capacitatea facilităților
{
  "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"
}
Membru: "Ce cursuri de yoga aveți săptămâna aceasta?"
AI: "Iată cursurile de yoga din această săptămână: miercuri 19:00 Yoga Flow cu Sarah (12 locuri), vineri 7:00 Yoga Flow cu Sarah (15 locuri) și sâmbătă 10:30 Yoga în familie cu Sarah (10 locuri). Poți rezerva la fitlifegym.com/classes."
Închirieri auto / Servicii auto Disponibilitatea vehiculelor pe dată și locație
{
  "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"}
  ]
}
Client: "Am nevoie de un SUV pentru weekendul acesta"
AI: "Avem SUV-uri disponibile vineri (3 rămase la 89,99$/zi) și sâmbătă (1 rămas la 99,99$/zi), dar duminică este epuizat. Rezervă curând! Folosește codul WEEKEND15 pentru 15% reducere. Rezervă la quickrent.com/book."
Evenimente / Loc de divertisment Spectacole, bilete și programe
{
  "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}
      ]
    }
  ]
}
Client: "Ce spectacole aveți în weekendul acesta?"
AI: "Weekendul acesta avem "The Musical Experience" vineri și sâmbătă la 19:30 (și un matineu la 14:00 sâmbătă) - biletele sunt 85$. Sâmbătă și duminică la 20:00 este "Comedy Night Live" la 45$. Vineri seara se vinde rapid, mai sunt doar 43 de locuri! Rezervă la grandtheater.com/tickets."
Imobiliare / Administrare proprietăți Anunțuri, prețuri și programe de vizionare
{
  "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"
}
Client: "Ce apartamente aveți sub 1500$?"
AI: "Avem un apartament cu un dormitor la 789 Pine Road pentru 1.200$/lună, disponibil din 15 februarie. Are 60 mp cu acces la sală de sport, terasă pe acoperiș și portar. Este o vizitare deschisă sâmbătă, 18 ianuarie, la ora 13:00, sau programează o vizionare privată la premierproperties.com/schedule. Vezi detalii: premierproperties.com/listing/apt-12c"

Limite de dimensiune

Fluxul standard de date în timp real acceptă fluxuri de până la 200.000 de caractere. Numărul de articole pe care le poți include depinde de câte date conține fiecare articol — un flux cu intrări scurte și concise poate conține ~500 de articole, în timp ce un flux cu descrieri lungi poate conține doar o fracțiune din aceasta. Dacă fluxul tău depășește această limită, vei vedea o notificare când încerci să salvezi.

Sfaturi pentru reducerea dimensiunii fluxului

Dacă fluxul tău este prea mare, iată câteva modalități de a-l aduce în limită:

  • Include doar cele mai vândute sau populare articole — Concentrează-te pe produsele despre care întreabă cel mai des clienții
  • Elimină câmpurile inutile — Renunță la ID-urile interne, metadatele sau câmpurile de care chatbot-ul nu are nevoie
  • Scurtează descrierile — Folosește descrieri concise ale produselor în loc de texte complete de marketing. Vezi structura exemplu recomandată pentru un exemplu de cum să păstrezi intrările compacte
  • Filtrează după disponibilitate — Include doar articolele care sunt momentan pe stoc sau active
  • Împarte pe categorii — Creează un flux pentru cea mai relevantă categorie de produse în loc de toate

Sfat: Dacă ai nevoie să conectezi un flux de date mai mare cu mii de articole, folosește Flux de date în timp real Max (planul Pro) care acceptă până la 10.000.000 de caractere (~25.000 de articole).

Cele mai bune practici

  • Păstrează datele actualizate — Endpoint-ul tău ar trebui să returneze informații curente, nu date stocate în cache
  • Include context — Adaugă date, ore sau etichete pentru ca AI-ul să înțeleagă ce înseamnă datele
  • Structurează clar — Folosește nume clare de câmpuri în JSON pentru ca AI-ul să poată interpreta datele corect
  • Păstrează focalizarea — Include doar datele de care chatbot-ul are nevoie pentru a răspunde la întrebări

Important: URL-ul trebuie să fie accesibil public. Dacă endpoint-ul tău necesită autentificare, chatbot-ul nu va putea prelua datele.

Elimină fluxul de date

Poți elimina fluxul de date oricând apăsând butonul "Elimină fluxul de date" din setări. Chatbot-ul va reveni la utilizarea doar a bazei de cunoștințe pentru răspunsuri.

Notă: Fluxul de date în timp real este disponibil pe planurile Standard și Pro. Ai nevoie să conectezi fluxuri de date mai mari cu mii de articole? Vezi Flux de date în timp real Max (planul Pro).

Încearcă

Nu ai încă propriul endpoint API? Poți testa funcția cu un API public pentru a vedea cum funcționează. De exemplu, încearcă prețul live al Bitcoin de pe Binance:

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

Aceasta returnează date de preț BTC/USDT în timp real. Odată conectat, chatbot-ul tău va putea răspunde la întrebări precum "Care este prețul actual al Bitcoin?" folosind date live.

Sfat: Poți folosi orice API public care returnează JSON sau text simplu — date meteo, prețuri bursiere, cursuri de schimb și multe altele. Înlocuiește-l cu propriul tău endpoint când ești pregătit.