Volver al panel

Documentación

Aprende a usar Asyntai

Fuente de datos en tiempo real

Connect your chatbot to live data sources for dynamic responses

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 proporciona una URL que devuelva sus datos (JSON o texto plano), y el chatbot incluirá 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 obtiene los datos - La IA lee todo el feed con cada mensaje enviado, asegurando que las respuestas siempre utilicen los datos más recientes
  3. Respuestas dinámicas - Las respuestas incluyen datos en tiempo real de su fuente
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 verifique 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 guarde — 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 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. Agrega la URL de su feed de datos (ver ejemplo)
  3. Toggle "Enable Dynamic Product Cards" ON
  4. Guarde su configuración

Formato de datos

Incluye 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 proporciones.
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 programa una visite 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:

  • Incluye solo los más vendidos o artículos populares — Enfócate en los productos por los que más preguntan los clientes
  • Elimina campos innecesarios — Quita 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
  • Manténlo 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: Puede usar cualquier API pública que devuelva JSON o texto plano — datos del clima, precios de acciones, tasas de cambio y más. Reemplázala con su propio endpoint cuando estés listo.