# Як знайти контакти за файлом?

Функціонал пошуку контактів у файлі корисний, якщо у вас є контакти в Excel-файлі (номери телефонів або chat_id) і ви хочете масово знайти їх у своєму списку контактів для подальшої розсилки.

## Коли знадобиться

- У вас є список контактів у Excel-файлі, які потрібно знайти в системі.
- Потрібно надіслати розсилку клієнтам, які є в зовнішньому файлі.
- Треба імпортувати контакти з іншої системи для розсилки.

## Що важливо знати

- Пошук здійснюється тільки по полям **"Телефон"** або **"chat_id"**.
- Якщо заповнене поле "Телефон", пошук знайде контакти з таким самим номером телефону.
- Якщо заповнене поле "chat_id", знайдуться контакти з відповідним ID чату.
- Якщо вказані обидва поля для пошуку, використовується логічне "І": контакти повинні відповідати обом полям одночасно.

## Перед початком

- [x] Ви увійшли в систему з правами оператора або адміністратора.
- [x] Ви перейшли в модуль `Клієнти` через `Меню -> Клієнти`.
- [x] У вас є Excel-файл з контактами (номери телефонів або chat_id).

## Покрокова інструкція

1. Перейдіть у модуль **"Клієнти"** → **"Дії"** → **"Пошук за файлом"**.
2. Натисніть кнопку **"Завантажити шаблон"** для отримання зразка файлу — завантажиться Excel-файл з прикладом структури.
3. Відкрийте завантажений шаблон та заповніть його своїми контактами:
   - Додайте номери телефонів або chat_id в відповідні стовпці
   - Збережіть файл
4. Натисніть кнопку **"Надіслати файл"** для завантаження заповненого файлу.
5. Оберіть завантажений файл на вашому комп'ютері.
6. Встановіть відповідність полів:
   - **Перший стовпчик**: "Пошук по полю" — оберіть "Телефон" або "chat_id"
   - **Другий стовпчик**: "Стовпчик у файлі" — вкажіть, який стовпчик у вашому файлі містить ці дані
7. Натисніть кнопку **"Створити розсилку"** для початку масової розсилки відібраним контактам.

## Логіка пошуку

- **Пошук по телефону**: Якщо заповнене поле "Телефон", пошук знайде контакти з таким самим номером телефону.
- **Пошук по chat_id**: Якщо заповнене поле "chat_id", знайдуться контакти з відповідним ID чату.
- **Комбінований пошук**: Якщо вказані обидва поля для пошуку, використовується логічне "І": контакти повинні відповідати обом полям одночасно.

## Що відбувається після

Система знайде відповідні контакти у вашій базі та дозволить створити розсилку для знайдених клієнтів. Ви зможете налаштувати та надіслати розсилку відібраним контактам.

## Як переконатися, що все вдалось

- Перевірте, що файл завантажено успішно.
- Переконайтеся, що відповідність полів встановлена правильно.
- Перевірте, скільки контактів знайдено в системі.
- Створіть тестову розсилку для перевірки.

## Пов'язані матеріали

- [Надіслати розсилку з модуля Клієнти](/uk/broadcast/how-to/send-broadcast-from-clients.md)
- [Створити розсилку](/uk/broadcast/how-to/create-broadcast.md)
- [Переглянути результати розсилки](/uk/broadcast/how-to/view-broadcast-results.md)