Airtable

Синхронизирайте вашите Airtable таблици в базата знания на AI SmartTalk. Превърнете структурирани данни в знания, които могат да бъдат запитвани от AI — перфектно за продуктови каталози, често задавани въпроси, директории на екипи и много други.

---

Преглед

Интеграцията с Airtable ви позволява да:

• Свържете вашата Airtable база чрез API ключ
• Синхронизирате данни от таблици като записи в базата знания
• Запитвате вашите данни разговорно чрез AI
• Поддържате данните актуални с ръчни или планирани синхронизации

---

Изисквания

Преди да започнете, уверете се, че имате:

• Активен акаунт в AI SmartTalk
• Акаунт в Airtable с поне една база
• API ключ на Airtable (Личен достъпен токен)

---

Стъпка по стъпка настройка

Стъпка 1: Генерирайте вашия Airtable API ключ

1. Влезте в своя Airtable акаунт
2. Отидете на Настройки на акаунта → Developer hub
3. Щракнете Създайте нов токен
4. Конфигурирайте вашия токен:
   • Име: AI SmartTalk Integration
   • Обхвати: Изберете data.records:read и schema.bases:read
   • Достъп: Изберете конкретните бази, които искате да свържете
5. Щракнете Създайте токен и го копирайте незабавно

Важно: Запазете токена си на сигурно място — Airtable го показва само веднъж!

Стъпка 2: Свържете се с AI SmartTalk

1. Влезте в своя AI SmartTalk акаунт
2. Отидете на Настройки → Интеграции
3. Намерете Airtable и щракнете Свържете
4. Поставете вашия API ключ в полето Личен достъпен токен
5. Щракнете Потвърдете

Стъпка 3: Изберете таблици за синхронизиране

След потвърждение, ще видите наличните си бази и таблици:

1. Прегледайте базите: Щракнете, за да разширите всяка база
2. Изберете таблици: Отметнете таблиците, които искате да синхронизирате
3. Конфигурирайте полета: Изберете кои колони да включите
4. Щракнете Започнете синхронизация

Стъпка 4: Проверете импорта

1. Отидете на Знания в AI SmartTalk
2. Вашите записи от Airtable се появяват като индивидуални записи в базата знания
3. Тествайте вашия AI, като задавате въпроси за вашите данни

---

Какво се синхронизира

Тип данни	Как се обработва
Текстови полета	Синхронизирани като съдържание, което може да се търси
Числови полета	Включени в контекста на записа
Избор/Множествен избор	Обработвани като категории/етикети
Свързани записи	Включени референции
Прикачени файлове	Референции на URL (файловете не се изтеглят)
Формули	Синхронизирани изчислени стойности

Пример: Продуктов каталог

Ако имате таблица "Продукти":

Име	Описание	Цена	Категория
Widget Pro	Професионален клас widget...	$99	Инструменти
Widget Lite	Входно ниво widget...	$49	Инструменти

Вашият AI може да отговори:

• "Какви продукти имате?"
• "Разкажете ми за Widget Pro"
• "Кой е най-евтиният ви инструмент?"

---

Конфигурация на синхронизация

Избор на полета

За всяка таблица можете да конфигурирате:

• Основно поле: Основен идентификатор за всеки запис
• Съдържателни полета: Полета, които да включите в базата знания
• Изключени полета: Вътрешни полета, които да пропуснете (IDs, времеви печати и др.)

Честота на синхронизация

Опция	Описание
Ръчно	Щракнете "Синхронизирайте сега", когато е необходимо
При импорт	Синхронизира, когато задействате импорт
Планирано	Настройте чрез SmartFlow (вижте по-долу)

Планиране с SmartFlow

За автоматично синхронизиране на вашите данни от Airtable:

1. Създайте нов SmartFlow
2. Добавете Планирано задействие (ежедневно, седмично и т.н.)
3. Добавете действието Синхронизиране → Изберете Airtable
4. Запазете и активирайте работния поток

---

Сценарии на употреба

Продуктов/Услужен каталог

Синхронизирайте вашата продуктова база данни, така че клиентите да могат да питат:

• "Какви продукти имате под $100?"
• "Сравнете Widget Pro и Widget Lite"
• "Имате ли нещо в категория Инструменти?"

Често задавани въпроси / База знания

Съхранявайте често задавани въпроси в Airtable с колони Въпрос/Отговор:

• "Как да нулирам паролата си?"
• "Каква е вашата политика за възстановяване на средства?"
• "Къде мога да намеря фактурата си?"

Директория на екипа

Синхронизирайте данни за членове на екипа за вътрешни запитвания:

• "Кой се занимава с обслужване на клиенти?"
• "Каква е ролята на Сара?"
• "Избройте всички в екипа по инженерство"

Данни за събития/график

Синхронизирайте таблици за събития за запитвания за график:

• "Какви събития предстоят?"
• "Кога е следващият уебинар?"
• "Какво се случи на срещата миналия месец?"

---

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

Проблеми с връзката

Проблем	Решение
"Невалиден API ключ"	Генерирайте отново токена в Developer hub на Airtable
"Базата не е намерена"	Уверете се, че токенът има достъп до тази база
"Отказан достъп"	Добавете обхвата data.records:read към вашия токен

Проблеми със синхронизацията

Проблем	Решение
Липсващи записи	Проверете дали записите не са филтрирани/скрити в изгледа
Остарели данни	Щракнете Синхронизирайте сега, за да обновите
Грешни полета се синхронизират	Прегледайте избора на полета в настройките на интеграцията

AI не може да намери данни

Проблем	Решение
Няма резултати за запитвания	Изчакайте синхронизацията да завърши и AI да обработи
Частични отговори	Уверете се, че всички релевантни полета са включени в синхронизацията

---

Управление на връзката

Действие	Как
Актуализирайте API ключа	Настройки → Интеграции → Airtable → Актуализирайте токена
Добавете таблици	Редактирайте връзката → Изберете допълнителни таблици
Премахнете таблици	Отметнете таблиците, които вече не искате да синхронизирате
Прекратете връзката	Настройки → Интеграции → Airtable → Прекратете връзката

---

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

1. Структурирайте за AI: Използвайте ясни, описателни имена на полета
2. Дедуплицирайте данни: Премахнете дублиращи се записи преди синхронизация
3. Използвайте основни полета разумно: Изберете уникални, описателни идентификатори
4. Редовни синхронизации: Поддържайте данните актуални, особено за променящо се съдържание
5. Ограничете обхвата: Синхронизирайте само таблиците, от които AI се нуждае, за да отговаря на въпроси

---

Свързана документация

• Преглед на интеграции
• Управление на база знания
• CSV URL импорт — Алтернатива за статични данни
• Планирани задействия на SmartFlow — Автоматизиране на синхронизации