> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiployees.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Импортиране на потенциални клиенти
> Импортирайте потенциални клиенти от CSV и Excel файлове с валидация и обработка на грешки
Импортирайте големи количества потенциални клиенти от CSV или Excel файлове с автоматична валидация, фонова обработка и цялостно отчитане на грешки.
## Преглед на процеса на импортиране
Системата за импортиране на потенциални клиенти поддържа:
* **CSV и Excel файлове** (.csv, .xlsx, .xls)
* **Фонова обработка** за големи файлове
* **Автоматична валидация** с отчитане на грешки
* **Вторични контакти** в същия импорт
* **Мапиране на променливи** от конфигурацията на асистента
## Подготовка на вашия файл за импортиране
### Задължителни колони
Вашият файл за импортиране трябва да включва:
* **phone\_number:** Основен телефонен номер за контакт (задължителен)
* **Променливи:** Колони, съответстващи на [конфигурираните променливи на вашия асистент](/ai-assistants/settings/prompt-and-tools#call-variables)
### Незадължителни колони
* **Колони за вторични контакти:** Допълнителни телефонни номера
* **Заместители на променливи:** Персонализирани стойности за конкретни потенциални клиенти
### Пример за формат на файл
```csv theme={null}
phone_number,customer_name,company,budget_range,secondary_phone_1,secondary_phone_2
+14155551234,John Smith,ABC Corp,10k-50k,+14155551235,+14155551236
+14155557890,Jane Doe,XYZ Inc,50k-100k,+14155557891,
+14155554567,Bob Johnson,Tech Start,5k-10k,,
```
## Конфигурация на импортирането
### 1. Изберете кампания
Изберете целевата кампания от падащото меню. Променливите на асистента ще определят кои колони се очакват по време на мапирането.
### 2. Вторични контакти
Изберете колко вторични телефонни номера на потенциален клиент (0-10). Ако вашият файл съдържа допълнителни телефонни номера освен основния контакт, посочете броя тук.
### 3. Формат на телефонен номер
Изберете формата на вашите телефонни номера:
**Международен формат (препоръчителен)**
* Номерата вече включват код на страната с префикс +
* Пример: `+40741234567`, `+14155551234`
* Не е нужен избор на страна
* Можете да смесвате множество страни в един файл
**Национален формат**
* Номера без префикс на кода на страната
* Пример: `0741234567`, `7775551234`
* **Трябва да изберете код на страната** по време на импортирането
* **Важно:** Разделете файла си по страни - всички номера трябва да са от една и съща страна на файл
* Системата ще добави избрания код на страната към всички номера
При използване на национален формат, трябва да импортирате по един файл на страна. Не смесвайте номера от различни страни в един файл.
### 4. Избор на код на страната
Появява се само когато е избран "Национален формат". Изберете страната, която съответства на всички телефонни номера във вашия файл. Системата автоматично ще добави кода на страната пред всички номера.
## Стъпки за импортиране
### 1. Започнете процеса на импортиране
1. **Отидете в секцията Потенциални клиенти** или в раздела за потенциални клиенти на кампанията
2. **Кликнете върху бутона "Импортиране на потенциални клиенти"**
3. **Изберете кампания** за назначаване на потенциални клиенти
4. **Изтеглете примерен** файл, за да видите очаквания формат
### 2. Качете и мапирайте колони
1. **Изберете файл:** Изберете вашия CSV или Excel файл
2. **Мапиране на колони:** Мапирайте колоните на вашия файл към системните полета:
* **Телефонен номер (задължителен):** Изберете колоната, съдържаща телефонните номера
* **Променливи на асистента:** Мапирайте всяка променлива към нейната съответна колона
* **Вторични контакти:** Ако са конфигурирани, мапирайте вторичните телефонни номера и променливи
3. **Автоматично откриване:** Системата автоматично открива мапирания въз основа на общи имена на заглавки
4. **Преглед и импортиране:** Потвърдете мапиранията и кликнете "Импортиране", за да започнете
### 3. Фонова обработка
* **Обработка на опашката:** Големите файлове се обработват на заден план
* **Проследяване на прогреса:** Статусът на импортирането се актуализира автоматично
* **Известие:** Email известие, когато импортирането завърши
* **Отчитане на грешки:** Изтеглете отчет за всички неуспешни редове
## Правила за валидация
### Валидация на телефонен номер
* **Проверка на формата:** Предпочита се международен формат (+1234567890)
* **Откриване на дубликати:** Предотвратява дублиращи се телефонни номера
* **Невалидни номера:** Автоматично се маркират и пропускат
### Валидация на променливи
* **Задължителни полета:** Променливите, маркирани като задължителни, трябва да имат стойности
* **Типове данни:** Валидация на текст, число, булева стойност, където е приложимо
* **Ограничения на дължината:** Се прилагат максимални ограничения на символите
### Валидация на вторичен контакт
* **Формат на телефона:** Същата валидация като основните номера
* **Уникални номера:** Вторичните контакти трябва да се различават от основните
* **Съгласуваност на променливите:** Променливите на вторичните контакти се валидират независимо
## Обработка на грешки
### Автоматична обработка на грешки
Системата за импортиране автоматично обработва грешките в валидацията:
* **Импортирани валидни редове:** Успешно валидираните потенциални клиенти се добавят към кампанията
* **Пропуснати невалидни редове:** Редовете, които не преминават валидацията, се изключват автоматично
* **Генериран отчет за грешки:** Създава се подробен отчет за всички неуспешни редове
* **Частичен успех:** Импортирането завършва успешно с всички валидни потенциални клиенти, неуспешните редове се записват
### Общи грешки в валидацията
* **Невалидни телефонни номера:** Неправилен формат или невъзможни номера
* **Липсващи задължителни полета:** Празни стойности за задължителни променливи
* **Дублиращи се телефонни номера:** Телефонният номер вече съществува в системата
* **Проблеми с формата на файла:** Повреден или неподдържан формат на файл
### Изтегляне на отчет за грешки
След завършване на импортирането:
* **Връзка за изтегляне** се предоставя в известието
* **Подробни описания на грешките** за всеки неуспешен ред
* **Насоки за корекция** за отстраняване на проблемите
* **Възможност за повторно импортиране** с коригирани данни
## Импортиране на вторични контакти
### Множество телефонни номера на потенциален клиент
Включете допълнителни колони за вторични контакти:
```csv theme={null}
phone_number,customer_name,secondary_phone_1,secondary_phone_2,secondary_phone_3
+14155551234,John Smith,+14155551235,+14155551236,+14155551237
```
### Променливи на вторичните контакти
Добавете променливи, специфични за вторичните контакти:
```csv theme={null}
phone_number,customer_name,secondary_phone_1,secondary_1_name,secondary_1_role
+14155551234,John Smith,+14155551235,Jane Smith,Decision Maker
```
### Подредба на контактите
* **Основен контакт:** Винаги се обажда първо
* **Вторична поредност:** Обаждат се в реда на колоните (secondary\_phone\_1, после secondary\_phone\_2, и т.н.)
* **Координация на кампанията:** Спазва настройките за повторни опити на кампанията между контактите
## Работа с големи файлове
### Фонова обработка
* **Автоматично нареждане в опашка:** Файлове над 1000 реда се обработват на заден план
* **Ефективност на паметта:** Поточната обработка предотвратява прекъсвания
* **Проследяване на прогреса:** Актуализации на статуса в реално време
* **Производителност на системата:** Няма въздействие върху производителността на платформата по време на импортиране
### Система за известия
* **Email известия:** Изпращат се, когато импортирането завърши
* **Резюме на успеха:** Брой успешно импортирани потенциални клиенти
* **Резюме на грешките:** Брой и подробности за неуспешните редове
* **Връзки за изтегляне:** Достъп до отчети за грешки и импортирани данни
### Време за обработка
* **Малки файлове (\< 100 реда):** Обикновено завършват в рамките на 1 минута
* **Средни файлове (100-1000 реда):** Типично 2-5 минути
* **Големи файлове (1000+ реда):** 10-30 минути в зависимост от сложността
* **Много големи файлове (10k+ реда):** Може да отнеме няколко часа
## Най-добри практики
* **Използвайте примерен файл:** Изтеглете предоставения шаблон за правилния формат
* **Формат на телефона:** Международен формат без разделители (+1234567890)
* **Почистете данните:** Премахнете празните редове и валидирайте съдържанието
* **Тествайте първо:** Започнете с малка партида, за да проверите формата
* **Съпоставете променливите:** Уверете се, че колоните се съгласуват с конфигурацията на асистента
За подробно отстраняване на неизправности и общи проблеми с импортирането, вижте [Отстраняване на неизправности с потенциални клиенти](/troubleshooting/leads).
За информация относно управлението на импортирани потенциални клиенти, вижте [Управление на потенциални клиенти](/leads/managing-leads).