Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Feed de Dados em Tempo Real

Conecte seu chatbot a fontes de dados ao vivo para respostas dinâmicas

Configurar Feed de Dados
Planos Standard e Pro

Visão Geral

O Feed de Dados em Tempo Real permite que seu chatbot acesse dados ao vivo dos seus sistemas. Em vez de respostas estáticas, sua IA pode fornecer informações atualizadas como disponibilidade atual, preços, tempos de espera ou níveis de estoque.

Basta fornecer uma URL que retorne seus dados (JSON ou texto simples), e o chatbot incluirá automaticamente essas informações ao responder perguntas relevantes.

O Feed de Dados em Tempo Real padrão suporta feeds de até 200.000 caracteres (~500 itens). Para feeds de dados maiores, consulte o Feed de Dados em Tempo Real Max que suporta até 10.000.000 caracteres (~25.000 itens).

Como Funciona

  1. Você fornece uma URL - Um endpoint de API ou página que retorna seus dados ao vivo
  2. O chatbot busca os dados - A IA lê todo o feed a cada mensagem enviada, garantindo que as respostas sempre utilizem os dados mais recentes
  3. Respostas dinâmicas - As respostas incluem dados em tempo real da sua fonte
Assistente IA
Vocês têm quartos disponíveis para hoje à noite?
Sim! Temos disponibilidade para hoje à noite:

Suíte Deluxe - 3 quartos restantes a $299/noite
Quarto Standard - 8 quartos restantes a $149/noite

Gostaria que eu ajudasse com a reserva?
E amanhã?
Para amanhã temos:

Suíte Deluxe - 2 quartos a $299/noite
Quarto Standard - 5 quartos a $149/noite

Casos de Uso

Feeds de dados em tempo real são perfeitos para empresas que precisam fornecer informações atualizadas:

Hotéis Disponibilidade de quartos e preços por data
Restaurantes Tempos de espera, disponibilidade de mesas, horários
E-commerce Níveis de estoque e disponibilidade de produtos
Serviços Horários de agendamento e programação

Configuração

Adicionar um feed de dados em tempo real leva apenas alguns passos:

1
Crie seu endpoint de dados Configure uma URL que retorne seus dados ao vivo (API ou página web)
2
Acesse o Feed de Dados em Tempo Real No menu do seu site, clique em "Feed de Dados em Tempo Real"
3
Insira sua URL Cole a URL que retorna seus dados e clique em Salvar

Dica: Certifique-se de que seu endpoint seja acessível publicamente (sem autenticação necessária) para que o chatbot possa buscar os dados.

Verificação de Conexão

Após salvar a URL do seu feed de dados, o Asyntai verifica automaticamente a conexão. Você verá um cartão de status mostrando:

  • Status da conexão — se a URL foi alcançada com sucesso
  • Formato dos dados — formato detectado (JSON, HTML/XML ou Texto Simples)
  • Tamanho da resposta — quantos dados foram retornados
  • Prévia do conteúdo — um trecho da resposta para que você confirme que são os dados corretos

Se a conexão direta falhar, o Asyntai tentará automaticamente um proxy alternativo para alcançar sua URL. Se ambos os métodos falharem, sua URL ainda será salva — você verá apenas um aviso com sugestões de solução de problemas.

Formatos Suportados

A URL do seu feed de dados deve retornar dados em um destes formatos:

Formato JSON

Dados estruturados funcionam melhor para informações complexas como inventário ou agendas.

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

Formato Texto Simples

Texto simples funciona para informações diretas.

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

Cartões de Produto Dinâmicos

Se o seu feed de dados em tempo real contém informações de produtos (como inventário, quartos ou serviços), você pode ativar os Cartões de Produto Dinâmicos para exibi-los como belos cartões visuais no chat.

Como Ativar

  1. Acesse as configurações do Feed de Dados em Tempo Real
  2. Adicione a URL do seu feed de dados (veja o exemplo)
  3. Ative "Ativar Cartões de Produto Dinâmicos"
  4. Salve suas configurações

Formato dos Dados

Inclua detalhes de produtos no seu feed com campos como:

  • name - Nome do produto/item (obrigatório)
  • price - Preço de exibição (ex.: "$99.99")
  • description - Descrição curta
  • image_url - URL da imagem do produto
  • button_link - Link para o botão de ação
  • in_stock - Status de disponibilidade (true/false)

Veja um exemplo de como seu feed JSON deve ficar (ver arquivo JSON de exemplo):

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

Dica: Os Cartões de Produto Dinâmicos funcionam muito bem para inventário de e-commerce, quartos de hotel, itens de aluguel ou qualquer produto que mude frequentemente. Para produtos estáticos, use os Cartões de Produto.

Exemplos por Indústria

Aqui estão exemplos detalhados de como diferentes empresas podem estruturar seus feeds de dados em tempo real:

Estes são apenas exemplos - você pode incluir quaisquer campos relevantes para o seu negócio. A IA entenderá e usará quaisquer dados que você fornecer.
Loja de E-commerce Disponibilidade de produtos, preços, URLs e promoções
{
  "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: "Vocês têm os fones de ouvido sem fio em estoque?"
IA: "Sim! Os Wireless Headphones Pro estão em estoque com 23 unidades disponíveis. Atualmente estão em promoção por $119.99 (normalmente $149.99). Você pode visualizar e comprar aqui: techgadgets.com/products/wireless-headphones-pro. Além disso, use o código SAVE20 para 20% de desconto adicional em pedidos acima de $100!"
Saúde / Clínica Médica Disponibilidade de consultas e tempos 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: "Preciso consultar um dermatologista esta semana"
IA: "A consulta de dermatologia mais próxima é no sábado, 18 de janeiro, às 10:00 ou 11:00. Se não funcionar, há mais disponibilidade na segunda-feira, dia 20, às 9:00, 14:00 ou 15:00. Você pode agendar online em downtownmedical.com/book."
Academia / Centro de Fitness Horários de aulas e capacidade das instalações
{
  "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: "Quais aulas de yoga vocês têm esta semana?"
IA: "Aqui estão as aulas de yoga desta semana: quarta-feira 19:00 Yoga Flow com Sarah (12 vagas), sexta-feira 7:00 Yoga Flow com Sarah (15 vagas) e sábado 10:30 Yoga em Família com Sarah (10 vagas). Você pode reservar em fitlifegym.com/classes."
Aluguel de Carros / Serviços Automotivos Disponibilidade de veículos por data e localização
{
  "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: "Preciso de um SUV para este fim de semana"
IA: "Temos SUVs disponíveis na sexta-feira (3 restantes a $89.99/dia) e no sábado (1 restante a $99.99/dia), mas o domingo está esgotado. Reserve logo! Use o código WEEKEND15 para 15% de desconto. Reserve em quickrent.com/book."
Eventos / Local de Entretenimento Shows, ingressos e programação
{
  "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: "Quais shows vocês têm neste fim de semana?"
IA: "Neste fim de semana temos 'The Musical Experience' na sexta e no sábado às 19:30 (também uma matinê às 14:00 no sábado) - ingressos a $85. No sábado e domingo às 20:00 tem 'Comedy Night Live' a $45. A noite de sexta está vendendo rápido com apenas 43 lugares restantes! Reserve em grandtheater.com/tickets."
Imóveis / Administração de Propriedades Listagens, preços e horários de visita
{
  "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: "Quais apartamentos vocês têm abaixo de $1500?"
IA: "Temos um apartamento de 1 quarto na 789 Pine Road por $1.200/mês disponível em 15 de fevereiro. São 60m² com acesso à academia, terraço e porteiro. Há um open house no sábado, 18 de janeiro, às 13:00, ou agende uma visita particular em premierproperties.com/schedule. Veja detalhes: premierproperties.com/listing/apt-12c"

Limites de Tamanho

O Feed de Dados em Tempo Real padrão suporta feeds de até 200.000 caracteres. O número de itens que você pode incluir depende da quantidade de dados que cada item contém — um feed com entradas curtas e concisas pode conter aproximadamente 500 itens, enquanto um feed com descrições longas pode conter apenas uma fração disso. Se o seu feed exceder este limite, você verá uma notificação ao tentar salvar.

Dicas para Reduzir o Tamanho do Feed

Se o seu feed for muito grande, aqui estão algumas formas de trazê-lo dentro do limite:

  • Inclua apenas os mais vendidos ou itens populares — Foque nos produtos sobre os quais os clientes mais perguntam
  • Remova campos desnecessários — Elimine IDs internos, metadados ou campos que o chatbot não precisa
  • Encurte as descrições — Use descrições de produtos concisas em vez de textos de marketing completos. Consulte a estrutura de exemplo recomendada para ver um exemplo de como manter as entradas compactas
  • Filtre por disponibilidade — Inclua apenas itens que estejam atualmente em estoque ou ativos
  • Divida por categoria — Crie um feed para a categoria de produto mais relevante em vez de tudo

Dica: Se você precisa conectar um feed de dados maior com milhares de itens, use o Feed de Dados em Tempo Real Max (plano Pro) que suporta até 10.000.000 caracteres (~25.000 itens).

Melhores Práticas

  • Mantenha os dados atualizados — Seu endpoint deve retornar informações atuais, não dados em cache
  • Inclua contexto — Adicione datas, horários ou rótulos para que a IA entenda o significado dos dados
  • Estruture claramente — Use nomes de campos claros no JSON para que a IA possa interpretar os dados corretamente
  • Mantenha o foco — Inclua apenas os dados que o chatbot precisa para responder perguntas

Importante: A URL deve ser acessível publicamente. Se o seu endpoint exigir autenticação, o chatbot não conseguirá buscar os dados.

Remover Feed de Dados

Você pode remover o feed de dados a qualquer momento clicando no botão "Remover Feed de Dados" nas suas configurações. O chatbot voltará a usar apenas a sua base de conhecimento para as respostas.

Nota: O Feed de Dados em Tempo Real está disponível nos planos Standard e Pro. Precisa conectar feeds de dados maiores com milhares de itens? Veja o Feed de Dados em Tempo Real Max (plano Pro).

Experimente

Ainda não tem seu próprio endpoint de API? Você pode testar o recurso com uma API pública para ver como funciona. Por exemplo, experimente o preço ao vivo do Bitcoin da Binance:

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

Isso retorna dados de preço BTC/USDT em tempo real. Uma vez conectado, seu chatbot poderá responder perguntas como "Qual é o preço atual do Bitcoin?" usando dados ao vivo.

Dica: Você pode usar qualquer API pública que retorne JSON ou texto simples — dados meteorológicos, preços de ações, taxas de câmbio e muito mais. Substitua pelo seu próprio endpoint quando estiver pronto.