Airtable

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

---

Преглед

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

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

---

Изисквания

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

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

---

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

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

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

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

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

1. Влезте в своя акаунт в AI SmartTalk
2. Навигирайте до Настройки → Интеграции
3. Намерете Airtable и кликнете на Connect
4. Поставете вашия API ключ в полето Personal Access Token
5. Кликнете на Validate

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

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

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

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

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

---

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

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

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

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

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

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

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

---

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

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

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

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

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

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

Планиране с SmartFlow

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

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

---

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

Каталог на продукти/услуги

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

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

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

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

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

---

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

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

---

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

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

---

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

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