Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

Feed Dati in Tempo Reale

Connect your chatbot to live data sources for dynamic responses

Configura il Feed Dati
Piani Standard e Pro

Panoramica

Il Feed Dati in Tempo Reale consente al tuo chatbot di accedere ai dati in tempo reale dai tuoi sistemi. Invece di risposte statiche, la tua IA può fornire informazioni aggiornate come disponibilità attuale, prezzi, tempi di attesa o livelli di inventario.

Fornisci semplicemente un URL che restituisce i tuoi dati (JSON o testo semplice), e il chatbot includerà automaticamente queste informazioni quando risponde a domande pertinenti.

Il Feed Dati in Tempo Reale standard supporta feed fino a 200.000 caratteri (~500 articoli). Per feed di dati più grandi, consulta Feed Dati in Tempo Reale Max che supporta fino a 10.000.000 di caratteri (~25.000 articoli).

Come Funziona

  1. Fornisci un URL - Un endpoint API o una pagina che restituisce i tuoi dati in tempo reale
  2. Il chatbot recupera i dati - L'IA legge l'intero feed con ogni messaggio inviato, garantendo che le risposte utilizzino sempre i dati più recenti
  3. Risposte dinamiche - Le risposte includono dati in tempo reale dalla tua fonte
Assistente IA
Avete camere disponibili per stasera?
Sì! Abbiamo disponibilità per stasera:

Suite Deluxe - 3 camere rimaste a $299/notte
Camera Standard - 8 camere rimaste a $149/notte

Vuoi che ti aiuti a prenotare?
E per domani?
Per domani abbiamo:

Suite Deluxe - 2 camere a $299/notte
Camera Standard - 5 camere a $149/notte

Casi d'uso

I feed di dati in tempo reale sono perfetti per le aziende che devono fornire informazioni aggiornate:

Hotel Disponibilità delle camere e prezzi per data
Ristoranti Tempi di attesa, disponibilità tavoli, orari
E-commerce Livelli di scorta e disponibilità dei prodotti
Servizi Slot per appuntamenti e pianificazione

Configurazione

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

1
Crea il tuo endpoint dati Set up a URL that returns your live data (API or webpage)
2
Vai al Feed Dati in Tempo Reale Dal menu del tuo sito web, clicca "Feed Dati in Tempo Reale"
3
Inserisci il tuo URL Incolla l'URL che restituisce i tuoi dati e clicca Salva

Suggerimento: Assicurati che il tuo endpoint sia accessibile pubblicamente (nessuna autenticazione richiesta) in modo che il chatbot possa recuperare i dati.

Verifica della Connessione

Dopo aver salvato l'URL del tuo feed dati, Asyntai verifica automaticamente la connessione. Vedrai una scheda di stato che mostra:

  • Stato della connessione — se l'URL è stato raggiunto con successo
  • Formato dei dati — formato rilevato (JSON, HTML/XML o Testo Semplice)
  • Response size — how much data was returned
  • Anteprima del contenuto — un estratto della risposta per confermare che si tratti dei dati corretti

Se la connessione diretta fallisce, Asyntai proverà automaticamente un proxy di fallback per raggiungere il tuo URL. Se entrambi i metodi falliscono, il tuo URL viene comunque salvato — vedrai semplicemente un avviso con suggerimenti per la risoluzione dei problemi.

Formati supportati

L'URL del tuo feed dati deve restituire dati in uno di questi formati:

Formato JSON

I dati strutturati funzionano meglio per informazioni complesse come inventario o orari.

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

Formato Testo Semplice

Il testo semplice funziona per informazioni dirette.

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

Schede Prodotto Dinamiche

Se il tuo feed di dati in tempo reale contiene informazioni sui prodotti (come inventario, camere o servizi), puoi abilitare le Schede Prodotto Dinamiche per mostrarli come belle schede visive nella chat.

Come Abilitare

  1. Vai alle impostazioni del Feed Dati in Tempo Reale
  2. Aggiungi l'URL del tuo feed dati (vedi esempio)
  3. Attiva "Abilita Schede Prodotto Dinamiche"
  4. Salva le tue impostazioni

Formato dei Dati

Includi i dettagli del prodotto nel tuo feed con campi come:

  • name - Nome del prodotto/articolo (obbligatorio)
  • price - Prezzo visualizzato (es. "$99,99")
  • description - Breve descrizione
  • image_url - URL dell'immagine del prodotto
  • button_link - Link per il pulsante di azione
  • in_stock - Stato di disponibilità (true/false)

Ecco un esempio di come dovrebbe apparire il tuo feed JSON (visualizza il file JSON di esempio):

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

Suggerimento: Le Schede Prodotto Dinamiche funzionano benissimo per inventario e-commerce, camere d'albergo, articoli a noleggio o qualsiasi prodotto che cambia frequentemente. Per prodotti statici, usa le Schede Prodotto.

Esempi per Settore

Ecco esempi dettagliati di come diverse aziende possono strutturare i loro feed di dati in tempo reale:

Questi sono solo esempi - puoi includere qualsiasi campo pertinente alla tua attività. L'IA comprenderà e utilizzerà qualsiasi dato tu fornisca.
Negozio E-commerce Disponibilità dei prodotti, prezzi, URL e promozioni
{
  "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"
  }
}
Cliente: "Avete le cuffie wireless disponibili?"
AI: "Sì! Le Cuffie Wireless Pro sono disponibili con 23 unità in magazzino. Sono attualmente in offerta a $119,99 (prezzo regolare $149,99). Puoi visualizzarle e acquistarle qui: techgadgets.com/products/wireless-headphones-pro. Inoltre, usa il codice SAVE20 per un ulteriore 20% di sconto sugli ordini superiori a $100!"
Sanità / Studio Medico Disponibilità appuntamenti e tempi di attesa
{
  "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"
  }
}
Paziente: "Ho bisogno di vedere un dermatologo questa settimana"
AI: "Il primo appuntamento di dermatologia disponibile è sabato 18 gennaio alle 10:00 o alle 11:00. Se questi orari non vanno bene, c'è più disponibilità lunedì 20 alle 9:00, 14:00 o 15:00. Puoi prenotare online su downtownmedical.com/book."
Centro Fitness / Palestra Orari dei corsi e capienza della struttura
{
  "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"
}
Membro: "Quali corsi di yoga avete questa settimana?"
AI: "Ecco i corsi di yoga di questa settimana: Mercoledì 19:00 Yoga Flow con Sarah (12 posti), Venerdì 7:00 Yoga Flow con Sarah (15 posti) e Sabato 10:30 Yoga in Famiglia con Sarah (10 posti). Puoi prenotare su fitlifegym.com/classes."
Noleggio Auto / Servizi Auto Disponibilità veicoli per data e posizione
{
  "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"}
  ]
}
Cliente: "Ho bisogno di un SUV per questo fine settimana"
AI: "Abbiamo SUV disponibili Venerdì (3 rimasti a $89,99/giorno) e Sabato (1 rimasto a $99,99/giorno), ma Domenica è esaurito. Prenota presto! Usa il codice WEEKEND15 per il 15% di sconto. Prenota su quickrent.com/book."
Eventi / Luoghi di Intrattenimento Spettacoli, biglietti e programmi
{
  "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}
      ]
    }
  ]
}
Cliente: "Quali spettacoli avete questo fine settimana?"
AI: "Questo fine settimana abbiamo 'The Musical Experience' Venerdì e Sabato alle 19:30 (anche una matinée alle 14:00 Sabato) - biglietti a $85. Sabato e Domenica alle 20:00 c'è 'Comedy Night Live' a $45. Venerdì sera si sta esaurendo velocemente con solo 43 posti rimasti! Prenota su grandtheater.com/tickets."
Immobiliare / Gestione Immobili Annunci, prezzi e programmi di visite
{
  "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"
}
Cliente: "Quali appartamenti avete sotto i $1500?"
AI: "Abbiamo un bilocale a 789 Pine Road a $1.200/mese disponibile dal 15 febbraio. È di 60 mq con accesso alla palestra, terrazza sul tetto e portineria. C'è una visita libera Sabato 18 gennaio alle 13:00, oppure programma una visita privata su premierproperties.com/schedule. Vedi dettagli: premierproperties.com/listing/apt-12c"

Limiti di Dimensione

Il Feed Dati in Tempo Reale standard supporta feed fino a 200.000 caratteri. Il numero di elementi che puoi includere dipende dalla quantità di dati contenuti in ciascun elemento — un feed con voci brevi e concise può contenere circa 500 elementi, mentre un feed con descrizioni lunghe potrebbe contenerne solo una frazione. Se il tuo feed supera questo limite, vedrai una notifica quando provi a salvare.

Suggerimenti per Ridurre la Dimensione del Feed

Se il tuo feed è troppo grande, ecco alcuni modi per portarlo entro il limite:

  • Includi solo i bestseller o gli articoli più popolari — Concentrati sui prodotti di cui i clienti chiedono di più
  • Rimuovi i campi non necessari — Elimina ID interni, metadati o campi di cui il chatbot non ha bisogno
  • Abbrevia le descrizioni — Usa descrizioni di prodotto concise invece del testo di marketing completo. Consulta la struttura di esempio consigliata per un esempio di come mantenere le voci compatte
  • Filtra per disponibilità — Includi solo gli articoli attualmente disponibili o attivi
  • Dividi per categoria — Crea un feed per la categoria di prodotti più rilevante invece di tutto

Suggerimento: Se hai bisogno di collegare un feed di dati più grande con migliaia di articoli, usa Feed Dati in Tempo Reale Max (piano Pro) che supporta fino a 10.000.000 di caratteri (~25.000 articoli).

Buone pratiche

  • Mantieni i dati aggiornati — Il tuo endpoint dovrebbe restituire informazioni attuali, non dati memorizzati nella cache
  • Includi il contesto — Aggiungi date, orari o etichette in modo che l'IA comprenda cosa significano i dati
  • Struttura in modo chiaro — Usa nomi di campo chiari in JSON in modo che l'IA possa interpretare i dati correttamente
  • Mantienilo focalizzato — Includi solo i dati di cui il chatbot ha bisogno per rispondere alle domande

Importante: L'URL deve essere accessibile pubblicamente. Se il tuo endpoint richiede autenticazione, il chatbot non sarà in grado di recuperare i dati.

Rimuovi il Feed Dati

Puoi rimuovere il feed dati in qualsiasi momento cliccando il pulsante "Rimuovi il Feed Dati" nelle tue impostazioni. Il chatbot tornerà a utilizzare solo la tua base di conoscenza per le risposte.

Nota: Il Feed Dati in Tempo Reale è disponibile nei piani Standard e Pro. Hai bisogno di collegare feed di dati più grandi con migliaia di articoli? Consulta Feed Dati in Tempo Reale Max (piano Pro).

Provalo

Non hai ancora un tuo endpoint API? Puoi testare la funzionalità con un'API pubblica per vedere come funziona. Ad esempio, prova il prezzo del Bitcoin in tempo reale da Binance:

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

Questo restituisce i dati del prezzo BTC/USDT in tempo reale. Una volta connesso, il tuo chatbot sarà in grado di rispondere a domande come "Qual è il prezzo attuale del Bitcoin?" utilizzando dati in tempo reale.

Suggerimento: Puoi usare qualsiasi API pubblica che restituisce JSON o testo semplice — dati meteo, prezzi delle azioni, tassi di cambio e altro. Sostituiscila con il tuo endpoint quando sei pronto.