Volver al panel

Documentación

Aprende a usar Asyntai

Fuente de datos en tiempo real

Conecta tu chatbot a fuentes de datos en vivo para respuestas dinámicas

Configurar fuente de datos
Planes Standard y Pro

Descripción general

El Feed de datos en tiempo real permite que su chatbot acceda a datos en vivo de sus sistemas. En lugar de respuestas estáticas, su IA puede proporcionar información actualizada como disponibilidad actual, precios, tiempos de espera o niveles de inventario.

Simplemente proporcione una URL que devuelva sus datos (JSON, CSV o texto plano), y el chatbot utilizará automáticamente esta información al responder preguntas relevantes.

El Feed de datos en tiempo real estándar admite feeds de hasta 200,000 caracteres (~500 elementos). Para feeds de datos más grandes, consulta Feed de datos en tiempo real Max que admite hasta 10,000,000 caracteres (~25,000 elementos).

Cómo funciona

  1. Tú proporcionas una URL - Un endpoint de API o página que devuelve sus datos en vivo
  2. El chatbot indexa sus datos - Su feed se indexa automáticamente y se mantiene actualizado. Para cada conversación, la IA encuentra y utiliza los elementos más relevantes de su feed
  3. Respuestas dinámicas - Las respuestas incluyen datos en tiempo real de su fuente

Consejo: Los cambios en artículos existentes como precios, niveles de stock y disponibilidad se reflejan inmediatamente. Cuando agregue productos o artículos completamente nuevos a su feed, aparecerán en las respuestas del chatbot dentro de 24 horas.

Asistente IA
¿Tienen habitaciones disponibles para esta noche?
¡Sí! Tenemos disponibilidad para esta noche:

Suite Deluxe - 3 habitaciones disponibles a $299/noche
Habitación Standard - 8 habitaciones disponibles a $149/noche

¿Le gustaría que le ayude a reservar?
¿Y para mañana?
Para mañana tenemos:

Suite Deluxe - 2 habitaciones a $299/noche
Habitación Standard - 5 habitaciones a $149/noche

Casos de uso

Los feeds de datos en tiempo real son perfectos para negocios que necesitan proporcionar información actualizada:

Hoteles Disponibilidad de habitaciones y precios por fecha
Restaurantes Tiempos de espera, disponibilidad de mesas, horarios
Comercio electrónico Niveles de stock y disponibilidad de productos
Servicios Horarios de citas y programación

Configuración

Añadir un feed de datos en tiempo real solo requiere unos pocos pasos:

1
Cree su endpoint de datos Configure una URL que devuelva sus datos en vivo (API o página web)
2
Ve a Feed de Datos en Tiempo Real Desde el menú de su sitio web, haga clic en "Real-Time Data Feed"
3
Ingrese su URL Pegue la URL que devuelve sus datos y haga clic en Guardar

Consejo: Asegúrese de que su endpoint sea públicamente accesible (sin autenticación requerida) para que el chatbot pueda obtener los datos.

Verificación de conexión

Después de guardar la URL de su feed de datos, Asyntai verifica automáticamente la conexión. Verá una tarjeta de estado que muestra:

  • Estado de conexión — si se alcanzó la URL exitosamente
  • Formato de datos — formato detectado (JSON, HTML/XML o texto plano)
  • Tamaño de respuesta — cuántos datos se devolvieron
  • Vista previa del contenido — un fragmento de la respuesta para que puedas confirmar que son los datos correctos

Si la conexión directa falla, Asyntai intentará automáticamente un proxy de respaldo para alcanzar su URL. Si ambos métodos fallan, su URL aún se guardará — solo verá un aviso con sugerencias de solución de problemas.

Formatos compatibles

Su URL de feed de datos debe devolver datos en uno de estos formatos:

Formato JSON

Los datos estructurados funcionan mejor para información compleja como inventario u horarios.

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

Formato CSV

Los valores separados por comas funcionan muy bien para catálogos de productos, exportaciones de inventario y datos de hojas de cálculo.

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

Formato de texto plano

El texto simple funciona para información sencilla.

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

Tarjetas de productos dinámicas

Si su feed de datos en tiempo real contiene información de productos (como inventario, habitaciones o servicios), puede habilitar las Tarjetas de producto dinámicas para mostrarlos como hermosas tarjetas visuales en el chat.

Cómo activar

  1. Ve a la configuración del Feed de datos en tiempo real
  2. Agregue la URL de su feed de datos (ver ejemplo)
  3. Activa "Habilitar tarjetas de producto dinámicas"
  4. Guarde su configuración

Formato de datos

Incluya detalles de productos en su feed con campos como:

  • name - Nombre del producto/artículo (obligatorio)
  • price - Precio de visualización (ej., "$99.99")
  • description - Descripción breve
  • image_url - URL de imagen del producto
  • button_link - Enlace para el botón de acción
  • in_stock - Estado de disponibilidad (true/false)

Aquí tiene un ejemplo de cómo debería verse su feed JSON (ver archivo JSON de ejemplo):

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

Consejo: Las tarjetas de producto dinámicas funcionan muy bien para inventario de comercio electrónico, habitaciones de hotel, artículos de alquiler o cualquier producto que cambie frecuentemente. Para productos estáticos, use Tarjetas de producto en su lugar.

Ejemplos por industria

Aquí tiene ejemplos detallados de cómo diferentes negocios pueden estructurar sus feeds de datos en tiempo real:

Estos son solo ejemplos - puede incluir cualquier campo relevante para su negocio. La IA entenderá y usará cualquier dato que proporcione.
Tienda de comercio electrónico Disponibilidad de productos, precios, URLs y promociones
{
  "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: "¿Tienen los auriculares inalámbricos en stock?"
IA: "¡Sí! Los Wireless Headphones Pro están en stock con 23 unidades disponibles. Actualmente están en oferta por $119.99 (precio regular $149.99). Puede verlos y comprarlos aquí: techgadgets.com/products/wireless-headphones-pro. Además, ¡use el código SAVE20 para un 20% adicional de descuento en pedidos superiores a $100!"
Salud / Clínica médica Disponibilidad de citas y tiempos de espera
{
  "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"
  }
}
Paciente: "Necesito ver a un dermatólogo esta semana"
IA: "La cita de dermatología más temprana es el sábado 18 de enero a las 10:00 AM u 11:00 AM. Si esos horarios no le funcionan, hay más disponibilidad el lunes 20 a las 9:00 AM, 2:00 PM o 3:00 PM. Puede reservar en línea en downtownmedical.com/book."
Centro de fitness / Gimnasio Horarios de clases y capacidad de instalaciones
{
  "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"
}
Miembro: "¿Qué clases de yoga tienen esta semana?"
IA: "Aquí están las clases de yoga de esta semana: miércoles 7:00 PM Yoga Flow con Sarah (12 lugares), viernes 7:00 AM Yoga Flow con Sarah (15 lugares) y sábado 10:30 AM Yoga Familiar con Sarah (10 lugares). Puede reservar en fitlifegym.com/classes."
Alquiler de coches / Servicios automotrices Disponibilidad de vehículos por fecha y ubicación
{
  "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: "Necesito un SUV para este fin de semana"
IA: "Tenemos SUVs disponibles el viernes (3 restantes a $89.99/día) y sábado (1 restante a $99.99/día), pero el domingo está agotado. ¡Reserva pronto! Use el código WEEKEND15 para un 15% de descuento. Reserva en quickrent.com/book."
Eventos / Lugar de entretenimiento Espectáculos, entradas y horarios
{
  "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: "¿Qué espectáculos tienen este fin de semana?"
IA: "Este fin de semana tenemos 'The Musical Experience' el viernes y sábado a las 7:30 PM (también una matiné a las 2 PM el sábado) - las entradas cuestan $85. El sábado y domingo a las 8 PM hay 'Comedy Night Live' a $45. ¡La función del viernes por la noche se está vendiendo rápido con solo 43 asientos restantes! Reserva en grandtheater.com/tickets."
Bienes raíces / Gestión de propiedades Listados, precios y horarios de visitas
{
  "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: "¿Qué apartamentos tienen por debajo de $1500?"
IA: "Tenemos un apartamento de 1 dormitorio en 789 Pine Road por $1,200/mes disponible el 15 de febrero. Tiene 650 sqft con acceso al gimnasio, terraza en la azotea y portero. Hay una jornada de puertas abiertas el sábado 18 de enero a la 1:00 PM, o programe una visita privada en premierproperties.com/schedule. Ver detalles: premierproperties.com/listing/apt-12c"

Límites de tamaño

El Feed de datos en tiempo real estándar admite feeds de hasta 200,000 caracteres. La cantidad de elementos que puede incluir depende de la cantidad de datos que contiene cada elemento — un feed con entradas cortas y concisas puede contener aproximadamente 500 elementos, mientras que un feed con descripciones largas puede contener solo una fracción de eso. Si su feed excede este límite, verá una notificación al intentar guardar.

Consejos para reducir el tamaño del feed

Si su feed es demasiado grande, aquí hay algunas formas de ajustarlo dentro del límite:

  • Incluya solo los más vendidos o artículos populares — Enfóquese en los productos por los que más preguntan los clientes
  • Elimine campos innecesarios — Quite IDs internos, metadatos o campos que el chatbot no necesita
  • Acorta las descripciones — Usa descripciones de producto concisas en lugar de textos de marketing completos. Consulta la estructura de ejemplo recomendada para ver un ejemplo de cómo mantener las entradas compactas
  • Filtra por disponibilidad — Incluye solo artículos que estén actualmente en stock o activos
  • Divide por categoría — Cree un feed para su categoría de producto más relevante en lugar de todo

Consejo: Si necesita conectar un feed de datos más grande con miles de artículos, use Feed de datos en tiempo real Max (plan Pro) que admite hasta 10,000,000 caracteres (~25,000 elementos).

Mejores prácticas

  • Mantén los datos actualizados — Su endpoint debe devolver información actual, no datos en caché
  • Incluye contexto — Agrega fechas, horarios o etiquetas para que la IA entienda qué significan los datos
  • Estructura claramente — Use nombres de campos claros en JSON para que la IA pueda interpretar los datos correctamente
  • Mantenlo enfocado — Incluye solo los datos que el chatbot necesita para responder preguntas

Importante: La URL debe ser públicamente accesible. Si su endpoint requiere autenticación, el chatbot no podrá obtener los datos.

Eliminar feed de datos

Puede eliminar el feed de datos en cualquier momento haciendo clic en el botón "Eliminar feed de datos" en su configuración. El chatbot volverá a usar solo su base de conocimiento para las respuestas.

Nota: El Feed de datos en tiempo real está disponible en los planes Standard y Pro. ¿Necesita conectar feeds de datos más grandes con miles de artículos? Consulta Feed de datos en tiempo real Max (plan Pro).

Pruébalo

¿Aún no tiene su propio endpoint de API? Puede probar la función con una API pública para ver cómo funciona. Por ejemplo, pruebe el precio en vivo de Bitcoin de Binance:

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

Esto devuelve datos de precio BTC/USDT en tiempo real. Una vez conectado, su chatbot podrá responder preguntas como "¿Cuál es el precio actual de Bitcoin?" usando datos en vivo.

Consejo: 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.