Преминете към основното съдържание

CSV URL Интеграция

Импортирайте документи директно от публично достъпни CSV файлове чрез URL в базата знания на вашия AI асистент.

Бързо стартиране​

Започнете в 3 стъпки:

  1. Навигирайте: Администрация → Моите асистенти → [Име на асистента] → Интеграции → CSV URL
  2. Добавете URL: Въведете публичния си CSV URL и изберете тип на импорта (ЧЗВ/Продукт/По подразбиране)
  3. Импортирайте: Щракнете "Добави URL" и следете статуса

Съвет: Тествайте с малък CSV файл първо, за да се запознаете с процеса.

CSV URL Интеграция Преглед

Какво можете да направите​

  • ✅ Импортиране от публични HTTP/HTTPS CSV URLs
  • ✅ Масово импортиране на множество URLs наведнъж
  • ✅ Автоматично разпознаване на CSV структура (ЧЗВ, Продукт или Общ)
  • ✅ Присвояване на категории и картографиране на персонализирани колони
  • ✅ Проследяване на статус и история на импорта

Предварителни условия​

  • Административен достъп до вашия AI SmartTalk асистент
  • Публично достъпни CSV файлове (без необходимост от удостоверяване)
  • Правилна CSV структура с заглавия на колоните
  • Препоръчително кодиране UTF-8

Типове импортиране​

1. Импорт на ЧЗВ​

Най-добре за: Документация за поддръжка, бази знания

Задължителни колони:

  • question
  • answer

Пример:

question,answer
"Как да нулирам паролата си?","Щракнете 'Забравена парола' и следвайте инструкциите."
"Какви са работните ви часове?","Понеделник-Петък, 9:00 - 18:00."

2. Импорт на Продукт​

Най-добре за: Каталози за електронна търговия, инвентар

Задължителна колона:

  • idProduct (или персонализирана картографирана колона)

По избор:

  • name (или персонализирана картографирана колона)

Пример:

idProduct,name,description,price
"PROD001","Премиум Уиджет","Висококачествен уиджет","99.99"
"PROD002","Стандартен Уиджет","Основен уиджет","49.99"

3. Импорт по подразбиране​

Най-добре за: Общо съдържание, смесени данни

  • Автоматично разпознава структурата на ЧЗВ или Продукт
  • Преминава към общ импорт на документи
  • Обработва различни CSV формати

Стъпка по Стъпка Ръководство​

Стъпка 1: Достъп до Интеграция​

  1. Влезте в AI SmartTalk
  2. Отидете на Администрация → Моите Асистенти → [Вашият Асистент]
  3. Кликнете на Интеграции → CSV URL

Стъпка 2: Добавяне на CSV URL​

Единен URL:

  1. Кликнете на Добавяне на Нов CSV URL
  2. Въведете URL на CSV файла
  3. Предоставете опционално име
  4. Изберете тип на импорта (FAQ/Продукт/По подразбиране)
  5. Изберете категория (по избор)
  6. Кликнете на Добавяне на URL

Форма за Импорт на Единен CSV URL

Масов Импорт:

  1. Кликнете на Масов Импорт на URL
  2. Въведете URL адреси (по един на ред)
  3. Конфигурирайте споделени настройки
  4. Кликнете на Импорт на Всички URL

Масов Импорт на CSV URL

Стъпка 3: Конфигуриране на Съответствие на Колони (Само Продукт)​

Съответствайте колоните на вашия CSV на очакваните полета:

  • ID Колона на Продукта: По подразбиране idProduct → Съответства на product_id, sku и др.
  • Колона за Име: По подразбиране name → Съответства на product_name, title и др.

Стъпка 4: Наблюдение на Импорта​

Следете статуса в История на Импорта:

  • В очакване: Чака за обработка
  • Импортирано: Успешно завършено
  • Грешка: Неуспех (вижте детайлите)

Табло за Статус на Импорта

Стъпка 5: Повторен Импорт (Актуализиране на Данни)​

  1. Намерете URL в историята
  2. Кликнете на Повторен Импорт
  3. Потвърдете действието
  4. Наблюдавайте актуализирания статус

Стъпка 6: Проверка на Импорта​

  1. Проверете Базата Знания за нови документи
  2. Тествайте чатбота с въпроси относно импортираното съдържание

База Знания след Импорт

Изисквания за CSV​

Валидни URL адреси​

✅ 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 не се поддържа)
❌ https://private.site.com/auth-data.csv (Изисква се удостоверяване)
❌ file:///local/data.csv (Локалните файлове не се поддържат)

Изисквания за Файлове​

  • Достъп: Публично достъпен чрез HTTP/HTTPS
  • Заглавия: Първият ред трябва да съдържа имената на колоните
  • Разделители: Запетая (,) или точка и запетая (;)
  • Кодиране: Препоръчително е UTF-8
  • Размер: Максимум 10MB на файл

Отстраняване на Проблеми​

Чести Грешки​

ГрешкаРешение
URL адресът не е достъпенПроверете дали URL адресът е публичен и валиден
Невалиден форматПроверете разделителя и заглавията
Липсващи колониУверете се, че необходимите колони съществуват (въпрос/отговор или idProduct)
Тайм-аут на голям файлРазделете файла или намалете размера под 10MB

Стъпки за Решение​

  1. Тествайте URL адреса в браузъра
  2. Валидирайте структурата и кодировката на CSV
  3. Прегледайте съобщенията за грешки в историята на импорта
  4. Тествайте с по-малък примерен файл
  5. Свържете се с поддръжката, ако проблемът продължава

Най-добри практики​

Управление на URL адреси​

  • Използвайте стабилни, постоянни URL адреси
  • Тествайте URL адресите месечно за достъпност
  • Използвайте CDN за по-добра производителност
  • Включете версия в имената на файловете: products-v2024.csv

Организация на данни​

  • Използвайте ясни имена на категории
  • Поддържайте последователни CSV формати
  • Почистете данните преди импортиране (премахнете празни редове)
  • Дръжте файловете под 10MB

Производителност​

  • Тествайте първо с малки проби
  • Обработвайте големи импорти по време на извънпикови часове
  • Използвайте масов импорт за множество свързани URL адреси
  • Редовно наблюдавайте процента на успешен импорт

Сигурност​

  • ✅ HTTPS криптирани трансфери
  • ✅ Валидиране на URL адреси
  • ✅ Контрол на достъпа на базата на разрешения
  • ✅ Обработка на временни файлове (без постоянно съхранение)
  • ✅ Автоматично почистване на стари данни
  • ✅ Логове за одит на всички дейности

След импорт​

След импортиране, вашите данни:

  1. Стават търсими в базата знания
  2. Подпомагат отговорите на чатбота незабавно
  3. Появяват се организирани по категории
  4. Могат да бъдат проверени в секцията за База знания

Проверете вашия импорт:

  • Проверете Базата знания за нови документи
  • Тествайте чатбота с въпроси относно импортираните съдържания
  • Прегледайте категориите и организацията

Подкрепа​

Нуждаете се от помощ?

Резюме​

Сега можете да:

  • ✅ Импортирате CSV данни от публични URL адреси
  • ✅ Обработвате FAQ, продуктови и общи типове данни
  • ✅ Масово импортирате множество източници
  • ✅ Картографирате персонализирани колони за продукти
  • ✅ Наблюдавате и управлявате импорти
  • ✅ Актуализирате данни чрез повторни импорти

Следващи стъпки:

  1. Тествайте с примерен CSV
  2. Импортирайте вашите производствени данни
  3. Настройте категории
  4. Планирайте редовни повторни импорти
  5. Наблюдавайте производителността

Въпроси? Свържете се с нашия екип за поддръжка по всяко време.

Готови ли сте да повишите вашето
потребителско изживяване?

Разгърнете AI асистенти, които радват клиентите и се разширяват с вашия бизнес.

Съответствие с GDPR
Започнете безплатен пробен периодДостъп до Backoffice