Pular para o conteúdo principal

Integração de URL CSV

Importe documentos diretamente de arquivos CSV acessíveis publicamente via URL para a base de conhecimento do seu assistente de IA.

Início Rápido​

Comece em 3 etapas:

  1. Navegue: Administração → Meus Assistentes → [Nome do Assistente] → Integrações → URL CSV
  2. Adicione URL: Insira sua URL CSV pública e selecione o tipo de importação (FAQ/Produto/Padrão)
  3. Importar: Clique em "Adicionar URL" e monitore o status

Dica: Teste com um pequeno arquivo CSV primeiro para se familiarizar com o processo.

Visão Geral da Integração de URL CSV

O Que Você Pode Fazer​

  • ✅ Importar de URLs CSV públicas HTTP/HTTPS
  • ✅ Importar em massa várias URLs de uma vez
  • ✅ Detectar automaticamente a estrutura CSV (FAQ, Produto ou Genérico)
  • ✅ Atribuir categorias e mapear colunas personalizadas
  • ✅ Rastrear status e histórico de importação

Pré-requisitos​

  • Acesso de administrador ao seu assistente AI SmartTalk
  • Arquivos CSV acessíveis publicamente (sem autenticação necessária)
  • Estrutura CSV adequada com cabeçalhos de coluna
  • Codificação UTF-8 recomendada

Tipos de Importação​

1. Importação de FAQ​

Melhor para: Documentação de suporte, bases de conhecimento

Colunas obrigatórias:

  • question
  • answer

Exemplo:

question,answer
"Como faço para redefinir minha senha?","Clique em 'Esqueci a Senha' e siga as instruções."
"Quais são seus horários?","Segunda a sexta, das 9h às 18h."

2. Importação de Produto​

Melhor para: Catálogos de e-commerce, inventário

Coluna obrigatória:

  • idProduct (ou coluna mapeada personalizada)

Opcional:

  • name (ou coluna mapeada personalizada)

Exemplo:

idProduct,name,description,price
"PROD001","Widget Premium","Widget de alta qualidade","99.99"
"PROD002","Widget Padrão","Widget básico","49.99"

3. Importação Padrão​

Melhor para: Conteúdo geral, dados mistos

  • Detecta automaticamente a estrutura de FAQ ou Produto
  • Reverte para importação de documento genérico
  • Lida com vários formatos de CSV

Guia Passo a Passo​

Passo 1: Acessar Integração​

  1. Faça login no AI SmartTalk
  2. Vá para Administração → Meus Assistentes → [Seu Assistente]
  3. Clique em Integrações → CSV URL

Passo 2: Adicionar URL CSV​

URL Única:

  1. Clique em Adicionar Novo URL CSV
  2. Insira a URL do arquivo CSV
  3. Forneça um nome opcional
  4. Selecione o tipo de importação (FAQ/Produto/Padrão)
  5. Escolha a categoria (opcional)
  6. Clique em Adicionar URL

Formulário de Importação de URL CSV Única

Importação em Massa:

  1. Clique em Importar URLs em Massa
  2. Insira as URLs (uma por linha)
  3. Configure as configurações compartilhadas
  4. Clique em Importar Todas as URLs

Importação de URL CSV em Massa

Passo 3: Configurar Mapeamento de Colunas (Apenas Produto)​

Mapeie suas colunas CSV para os campos esperados:

  • Coluna ID do Produto: Padrão idProduct → Mapeie para product_id, sku, etc.
  • Coluna Nome: Padrão name → Mapeie para product_name, title, etc.

Passo 4: Monitorar Importação​

Acompanhe o status no Histórico de Importação:

  • Pendente: Aguardando processamento
  • Importado: Concluído com sucesso
  • Erro: Falhou (ver detalhes)

Painel de Status da Importação

Passo 5: Reimportar (Atualizar Dados)​

  1. Encontre a URL no histórico
  2. Clique em Reimportar
  3. Confirme a ação
  4. Acompanhe o status atualizado

Passo 6: Verificar Importação​

  1. Verifique a Base de Conhecimento para novos documentos
  2. Teste o chatbot com perguntas sobre o conteúdo importado

Base de Conhecimento Pós-Importação

Requisitos de CSV​

URLs Válidas​

✅ https://example.com/data/products.csv
✅ https://cdn.company.com/catalog.csv
✅ https://raw.githubusercontent.com/user/repo/main/data.csv

❌ ftp://files.company.com/data.csv (FTP não suportado)
❌ https://private.site.com/auth-data.csv (Autenticação necessária)
❌ file:///local/data.csv (Arquivos locais não suportados)

Requisitos do Arquivo​

  • Acesso: Acessível publicamente via HTTP/HTTPS
  • Cabeçalhos: A primeira linha deve conter os nomes das colunas
  • Delimitadores: Vírgula (,) ou ponto e vírgula (;)
  • Codificação: UTF-8 recomendado
  • Tamanho: Máximo de 10MB por arquivo

Solução de Problemas​

Erros Comuns​

ErroSolução
URL Não AcessívelVerifique se a URL é pública e válida
Formato InválidoVerifique o delimitador e os cabeçalhos
Colunas AusentesGaranta que as colunas necessárias existam (pergunta/resposta ou idProduct)
Timeout de Arquivo GrandeDivida o arquivo ou reduza o tamanho abaixo de 10MB

Passos para Resolução​

  1. Teste a URL no navegador
  2. Valide a estrutura e a codificação do CSV
  3. Revise as mensagens de erro no histórico de importação
  4. Teste com um arquivo de amostra menor
  5. Entre em contato com o suporte se o problema persistir

Melhores Práticas​

Gerenciamento de URL​

  • Use URLs estáveis e permanentes
  • Teste URLs mensalmente para acessibilidade
  • Use CDN para melhor desempenho
  • Inclua a versão nos nomes dos arquivos: products-v2024.csv

Organização de Dados​

  • Use nomes de categorias claros
  • Mantenha formatos CSV consistentes
  • Limpe os dados antes da importação (remova linhas vazias)
  • Mantenha os arquivos abaixo de 10MB

Desempenho​

  • Teste com amostras pequenas primeiro
  • Processe grandes importações durante horários de menor movimento
  • Use importação em massa para múltiplas URLs relacionadas
  • Monitore a taxa de sucesso da importação regularmente

Segurança​

  • ✅ Transferências criptografadas em HTTPS
  • ✅ Validação de URL
  • ✅ Controle de acesso baseado em permissões
  • ✅ Processamento de arquivos temporários (sem armazenamento permanente)
  • ✅ Limpeza automática de dados antigos
  • ✅ Registros de auditoria para todas as atividades

Após a Importação​

Uma vez importados, seus dados:

  1. Tornam-se pesquisáveis na base de conhecimento
  2. Potencializam as respostas do chatbot imediatamente
  3. Aparecem organizados por categorias
  4. Podem ser verificados na seção de Base de Conhecimento

Verifique sua importação:

  • Verifique a Base de Conhecimento por novos documentos
  • Teste o chatbot com perguntas sobre o conteúdo importado
  • Revise categorias e organização

Suporte​

Precisa de ajuda?

Resumo​

Agora você pode:

  • ✅ Importar dados CSV de URLs públicas
  • ✅ Lidar com tipos de dados de FAQ, Produto e genéricos
  • ✅ Importar em massa de várias fontes
  • ✅ Mapear colunas personalizadas para produtos
  • ✅ Monitorar e gerenciar importações
  • ✅ Atualizar dados através de re-importações

Próximos passos:

  1. Teste com um CSV de amostra
  2. Importe seus dados de produção
  3. Configure categorias
  4. Programe re-importações regulares
  5. Monitore o desempenho

Dúvidas? Entre em contato com nossa equipe de suporte a qualquer momento.