Retour au tableau de bord

Documentation

Apprenez à utiliser Asyntai

Flux de données en temps réel

Connect your chatbot to live data sources for dynamic responses

Configurer le flux de données
Forfaits Standard et Pro

Aperçu

Le Flux de données en temps réel permet à votre chatbot d'accéder aux données en direct de vos systèmes. Au lieu de réponses statiques, votre IA peut fournir des informations à jour telles que la disponibilité actuelle, les tarifs, les temps d'attente ou les niveaux de stock.

Fournissez simplement une URL qui renvoie vos données (JSON ou texte brut), et le chatbot inclura automatiquement ces informations lorsqu'il répondra aux questions pertinentes.

Le Flux de données en temps réel standard prend en charge les flux jusqu'à 200 000 caractères (environ 500 éléments). Pour les flux de données plus importants, consultez le Flux de données en temps réel Max qui prend en charge jusqu'à 10 000 000 de caractères (environ 25 000 éléments).

Comment ça fonctionne

  1. Vous fournissez une URL - Un endpoint API ou une page qui renvoie vos données en temps réel
  2. Le chatbot récupère les données - L'IA lit l'intégralité du flux à chaque message envoyé, garantissant que les réponses utilisent toujours les données les plus récentes
  3. Réponses dynamiques - Les réponses incluent des données en temps réel provenant de votre source
Assistant IA
Avez-vous des chambres disponibles ce soir ?
Oui ! Nous avons des disponibilités pour ce soir :

Suite Deluxe - 3 chambres restantes à 299 $/nuit
Chambre Standard - 8 chambres restantes à 149 $/nuit

Souhaitez-vous que je vous aide à réserver ?
Et demain ?
Pour demain, nous avons :

Suite Deluxe - 2 chambres à 299 $/nuit
Chambre Standard - 5 chambres à 149 $/nuit

Cas d'utilisation

Les flux de données en temps réel sont parfaits pour les entreprises qui doivent fournir des informations actualisées :

Hôtels Disponibilité des chambres et tarifs par date
Restaurants Temps d'attente, disponibilité des tables, horaires
E-commerce Niveaux de stock et disponibilité des produits
Services Créneaux de rendez-vous et planification

Configuration

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

1
Créer votre point de données Set up a URL that returns your live data (API or webpage)
2
Accéder au flux de données en temps réel Depuis le menu de votre site web, cliquez sur "Real-Time Data Feed"
3
Saisir votre URL Collez l'URL qui renvoie vos données et cliquez sur Save

Astuce : Assurez-vous que votre point d'accès est accessible publiquement (aucune authentification requise) afin que le chatbot puisse récupérer les données.

Vérification de la connexion

Après avoir enregistré l'URL de votre flux de données, Asyntai vérifie automatiquement la connexion. Vous verrez une carte de statut indiquant :

  • Statut de connexion — si l'URL a été atteinte avec succès
  • Format des données — format détecté (JSON, HTML/XML ou texte brut)
  • Taille de la réponse — volume de données renvoyées
  • Aperçu du contenu — un extrait de la réponse pour que vous puissiez confirmer qu'il s'agit des bonnes données

Si la connexion directe échoue, Asyntai essaiera automatiquement un proxy de secours pour atteindre votre URL. Si les deux méthodes échouent, votre URL est tout de même enregistrée — vous verrez simplement un avis avec des suggestions de dépannage.

Formats pris en charge

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

Format JSON

Les données structurées fonctionnent mieux pour les informations complexes comme l'inventaire ou les horaires.

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

Format texte brut

Le texte simple fonctionne bien pour les informations directes.

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

Fiches produit dynamiques

Si votre flux de données en temps réel contient des informations sur les produits (comme l'inventaire, les chambres ou les services), vous pouvez activer les Fiches produits dynamiques pour les afficher sous forme de belles cartes visuelles dans le chat.

Comment activer

  1. Accédez aux paramètres du Flux de données en temps réel
  2. Ajoutez l'URL de votre flux de données (voir l'exemple)
  3. Activez "Activer les fiches produits dynamiques"
  4. Enregistrez vos paramètres

Format des données

Include product details in your feed with fields like:

  • name - Nom du produit/article (requis)
  • price - Prix affiché (ex. : "99,99 $")
  • description - Description courte
  • image_url - URL de l'image du produit
  • button_link - Lien pour le bouton d'action
  • in_stock - Statut de disponibilité (true/false)

Voici un exemple de la structure de votre flux JSON (voir le fichier JSON d'exemple) :

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

Astuce : Les fiches produit dynamiques fonctionnent parfaitement pour les inventaires e-commerce, les chambres d'hôtel, les articles de location ou tout produit qui change fréquemment. Pour les produits statiques, utilisez plutôt les Fiches produit.

Exemples par secteur

Voici des exemples détaillés de la façon dont différentes entreprises peuvent structurer leurs flux de données en temps réel :

Ce ne sont que des exemples - vous pouvez inclure tous les champs pertinents pour votre activité. L'IA comprendra et utilisera toutes les données que vous fournissez.
Boutique e-commerce Disponibilité des produits, tarifs, URL et promotions
{
  "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 : "Avez-vous les écouteurs sans fil en stock ?"
IA : "Oui ! Les Wireless Headphones Pro sont en stock avec 23 unités disponibles. Ils sont actuellement en promotion à 119,99 $ (habituellement 149,99 $). Vous pouvez les consulter et les acheter ici : techgadgets.com/products/wireless-headphones-pro. De plus, utilisez le code SAVE20 pour 20% de réduction supplémentaire sur les commandes de plus de 100 $ !"
Santé / Clinique médicale Disponibilité des rendez-vous et temps d'attente
{
  "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"
  }
}
Patient : "J'ai besoin de voir un dermatologue cette semaine"
IA : "Le prochain rendez-vous en dermatologie disponible est samedi 18 janvier à 10h00 ou 11h00. Si cela ne vous convient pas, il y a davantage de disponibilités lundi 20 à 9h00, 14h00 ou 15h00. Vous pouvez réserver en ligne sur downtownmedical.com/book."
Centre de fitness / Salle de sport Horaires des cours et capacité des installations
{
  "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"
}
Membre : "Quels cours de yoga avez-vous cette semaine ?"
IA : "Voici les cours de yoga de cette semaine : mercredi 19h00 Yoga Flow avec Sarah (12 places), vendredi 7h00 Yoga Flow avec Sarah (15 places), et samedi 10h30 Yoga Famille avec Sarah (10 places). Vous pouvez réserver sur fitlifegym.com/classes."
Location de voitures / Services automobiles Disponibilité des véhicules par date et lieu
{
  "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 : "J'ai besoin d'un SUV pour ce week-end"
IA : "Nous avons des SUV disponibles vendredi (3 restants à 89,99 $/jour) et samedi (1 restant à 99,99 $/jour), mais dimanche est complet. Réservez vite ! Utilisez le code WEEKEND15 pour 15% de réduction. Réservez sur quickrent.com/book."
Lieux d'événements / de divertissement Spectacles, billets et horaires
{
  "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 : "Quels spectacles avez-vous ce week-end ?"
IA : "Ce week-end, nous avons « The Musical Experience » vendredi et samedi à 19h30 (ainsi qu'une matinée à 14h00 le samedi) - billets à 85 $. Samedi et dimanche à 20h00, il y a « Comedy Night Live » à 45 $. La soirée de vendredi se remplit vite, il ne reste que 43 places ! Réservez sur grandtheater.com/tickets."
Immobilier / Gestion de biens Annonces, tarifs et horaires de 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"
}
Client : "Quels appartements avez-vous à moins de 1 500 $ ?"
IA : "Nous avons un appartement 2 pièces au 789 Pine Road à 1 200 $/mois, disponible le 15 février. Il fait 60 m² avec accès à la salle de sport, terrasse sur le toit et concierge. Une visite libre est prévue samedi 18 janvier à 13h00, ou planifiez une visite privée sur premierproperties.com/schedule. Voir les détails : premierproperties.com/listing/apt-12c"

Limites de taille

Le Flux de données en temps réel standard prend en charge les flux jusqu’à 200 000 caractères. Le nombre d’éléments que vous pouvez inclure dépend de la quantité de données contenues dans chaque élément — un flux avec des entrées courtes et concises peut contenir environ 500 éléments, tandis qu’un flux avec de longues descriptions ne peut en contenir qu’une fraction. Si votre flux dépasse cette limite, vous verrez une notification lors de la tentative d’enregistrement.

Conseils pour réduire la taille du flux

Si votre flux est trop volumineux, voici quelques moyens de le ramener dans la limite :

  • N'incluez que les meilleures ventes ou articles populaires — Concentrez-vous sur les produits les plus demandés par les clients
  • Supprimez les champs inutiles — Retirez les identifiants internes, métadonnées ou champs dont le chatbot n'a pas besoin
  • Raccourcissez les descriptions — Utilisez des descriptions de produits concises au lieu de textes marketing complets. Consultez la structure d'exemple recommandée pour voir comment garder les entrées compactes
  • Filtrer par disponibilité — N'incluez que les articles actuellement en stock ou actifs
  • Divisez par catégorie — Créez un flux pour votre catégorie de produits la plus pertinente au lieu de tout inclure

Astuce : Si vous devez connecter un flux de données plus volumineux avec des milliers d'éléments, utilisez Real-Time Data Feed Max (plan Pro) qui prend en charge jusqu'à 10 000 000 de caractères (~25 000 éléments).

Bonnes pratiques

  • Gardez les données à jour — Votre endpoint doit renvoyer des informations actuelles, pas des données en cache
  • Incluez du contexte — Ajoutez des dates, heures ou libellés pour que l'IA comprenne la signification des données
  • Structurez clairement — Utilisez des noms de champs clairs en JSON pour que l'IA puisse interpréter correctement les données
  • Restez concentré — N'incluez que les données dont le chatbot a besoin pour répondre aux questions

Important : L'URL doit être accessible publiquement. Si votre point de terminaison nécessite une authentification, le chatbot ne pourra pas récupérer les données.

Supprimer le flux de données

Vous pouvez supprimer le flux de données à tout moment en cliquant sur le bouton "Supprimer le flux de données" dans vos paramètres. Le chatbot reviendra à l'utilisation de votre base de connaissances uniquement pour ses réponses.

Note : Le Flux de données en temps réel est disponible avec les forfaits Standard et Pro. Besoin de connecter des flux de données plus importants avec des milliers d'éléments ? Consultez le Flux de données en temps réel Max (plan Pro).

Essayez-le

Vous n'avez pas encore votre propre point d'accès API ? Vous pouvez tester la fonctionnalité avec une API publique pour voir comment elle fonctionne. Par exemple, essayez le prix du Bitcoin en temps réel depuis Binance :

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

Cela renvoie les données de prix BTC/USDT en temps réel. Une fois connecté, votre chatbot pourra répondre à des questions comme "Quel est le prix actuel du Bitcoin ?" en utilisant des données en direct.

Astuce : Vous pouvez utiliser n'importe quelle API publique qui renvoie du JSON ou du texte brut — données météo, cours boursiers, taux de change, et plus encore. Remplacez-la par votre propre point de terminaison lorsque vous êtes prêt.