# Контакты (SyBox)

Где: Настройки > Команда и клиенты > Контакты

Для чего это нужно:

Импорт клиентов из файла CSV или Excel, экспорт клиентов в файл CSV, синхронизация имен клиентов из Google Contacts и очистка базы от пустых контактов, с которыми никогда не было переписки.

У кого есть доступ:

Пользователи с правом «Управление настройками организации». Для импорта также требуется право «Показывать номер контакта». Для экспорта также требуются права «Просматривать справочник контактов» и «Показывать номер контакта».

### Как импортировать контакты из файла

1. Перейдите в Настройки > Контакты. В блоке «Импорт контактов из файла» нажмите «Выбрать файл».
2. Выберите файл CSV или Excel (.xlsx). Каждая строка соответствует одному клиенту. В файле Excel читается первый лист. Файл может содержать до 20 000 строк. Файл CSV, сохранённый из Excel, корректно читается — включая арабские имена — независимо от того, сохранён ли он как «CSV UTF-8» или как обычный «CSV».
3. Оставьте флажок «Первая строка содержит названия столбцов» включённым, если в первой строке указаны заголовки, например «Имя» и «Телефон». Снимите его, если в первой строке уже находятся данные клиента.
4. В поле «Страна для номеров, записанных без кода страны» выберите страну для локальных номеров вида 01001234567. Номера, записанные с кодом страны (+20…, 0020… или 20…), читаются как есть. По умолчанию выбрана страна вашего рабочего пространства.
5. В разделе «Что содержится в каждом столбце» укажите для каждого столбца его содержимое: «Имя», «Номер телефона», «Эл. почта», «Этикетки», «Отделы», одно из ваших полей контакта или «Не импортировать». SyBox автоматически подставляет значения по заголовкам столбцов, когда это возможно. Каждый вариант можно выбрать только для одного столбца. Столбец с номером телефона обязателен.
6. Чтобы заменить имена и адреса эл. почты, которые уже сохранены у ваших клиентов в SyBox, отметьте «Заменять уже сохранённые имена и адреса эл. почты». Иначе импортируемые имя или эл. почта заполнят только пустые поля. Для замены требуется право «Изменить контакт»; без него заполняются только пустые имена и адреса эл. почты.
7. Нажмите «Проверить файл». На этом шаге ничего не сохраняется. Вы увидите, сколько клиентов являются новыми, сколько уже есть в SyBox и будут обновлены, а также сколько строк содержат ошибки. В таблице отображаются первые строки и все строки с ошибками.
8. Нажмите «Импортировать». Сохраняются только те строки, которые прошли проверку. Во время выполнения отображается ход процесса, а по завершении — сводка.
9. Чтобы исправить строки, которые не были импортированы, нажмите «Скачать строки с ошибками», исправьте их в файле и импортируйте этот файл повторно.

Как работает импорт:

- Номер, который уже есть в SyBox, обновляется. Он никогда не создаётся повторно, а его диалог и история переписки остаются прежними.
- Для нового номера создаётся отдельная карточка клиента, готовая к диалогу.
- Этикетки и отделы добавляются к тем, что уже есть у клиента; ничего не удаляется. Несколько значений в одной ячейке указываются через запятую, например «VIP, Каир». Каждое из них должно заранее существовать под тем же названием (на любом из двух языков) в разделе Настройки > Этикетки или Настройки > Отделы. Вы можете добавлять только те отделы, которые вам разрешено назначать. Для добавления этикеток и отделов требуется право «Изменить контакт», а для этикеток также «Назначьте метки контакту»; без этих прав соответствующие столбцы пропускаются.
- Поля контакта заполняются в соответствии с их типом: число для числового поля, дата (2026-11-06 или 6/11/2026) для поля даты, один из вариантов для выпадающего списка и да или нет для поля да / нет.
- Пустая ячейка никогда не удаляет существующие данные.

Возможные ошибки в строке:

- «Некорректный номер телефона»: номер неполный либо записан без кода страны, и выбранная страна к нему не подходит.
- «Этот номер уже встречался в строке выше»: один и тот же клиент указан в файле дважды. Импортируется первая строка.
- «Нет этикетки с таким названием» / «Нет отдела с таким названием»: название в файле не совпадает ни с одной этикеткой или отделом. Остальные данные строки всё равно импортируются.
- «Вы не можете добавлять клиентов в этот отдел»: ваши права не позволяют назначать этот отдел.
- «Это значение не подходит для поля»: содержимое ячейки не соответствует типу данного поля контакта. Остальные данные строки всё равно импортируются.
- «Некорректный адрес эл. почты»: адрес эл. почты пропускается. Остальные данные строки всё равно импортируются.
- «Этот клиент не входит в диалоги, которые вы можете видеть»: номер принадлежит клиенту, к которому у вас нет доступа по правам. Строка не импортируется.

### Как экспортировать контакты

1. Перейдите в Настройки > Контакты. В блоке «Экспорт контактов» нажмите «Скачать CSV».
2. SyBox подготовит файл и покажет, сколько контактов уже добавлено. Затем начнётся скачивание файла.
3. Файл содержит по одной строке на каждого клиента, которого вам разрешено видеть: имя, номер телефона, эл. почту, канал, страну, этикетки, отделы, дату добавления клиента, дату последнего сообщения и по одному столбцу для каждого поля контакта. Даты указываются по часовому поясу страны вашего рабочего пространства.
4. Откройте файл в Excel или Google Sheets. Номера телефонов записываются с кодом страны и без знака «+», поэтому экспортированный файл можно снова импортировать.

Синхронизация с Google Contacts (если опция активна в вашем тарифе):

### Как подключить Google Contacts

1. Перейдите в Настройки > Контакты.
   ![Settings, Contacts: the "Connect Google Contacts" button](https://www.sybox.io/res/sybox/help/ru/connect-google-contacts-1.webp?v=75111af2)
2. Нажмите «Подключить контакты Google».
3. Откроется страница авторизации Google. Выберите нужный аккаунт и предоставьте доступ к адресной книге.
4. Вы вернетесь в SyBox, где подключенный почтовый ящик Google будет отмечен зеленой галочкой.

### Как запустить синхронизацию

- Действие «Синхронизировать контакты сейчас» загружает все контакты Google с корректными международными номерами телефонов. Оно создает новые карточки и заполняет имена. Уже заданные вашей командой имена в SyBox никогда не перезаписываются. По завершении появится сообщение «Контакты синхронизированы» с числом обработанных записей.
- Действие «Обновить только имена» заполняет только пустые имена у тех номеров, которые уже есть в системе. Новые контакты при этом не создаются. Опция удобна, если в вашей книге Google много личных номеров, которые не должны попасть в рабочую среду. По завершении появится сообщение «Имена обновлены» с числом обновленных записей.

### Как отключить Google Contacts

1. Нажмите «Отключить».
2. Прочитайте предупреждение и подтвердите действие. SyBox остановит синхронизацию, а доступ будет отозван и на стороне Google.
3. Уже импортированные контакты останутся в системе. Интеграцию можно подключить заново в любой момент.

### Как удалить неиспользуемые контакты

1. Нажмите «Удалить неиспользуемые контакты».
   ![Settings, Contacts: the red "Delete unused contacts" button](https://www.sybox.io/res/sybox/help/ru/delete-unused-contacts-1.webp?v=05a2cb88)
2. SyBox найдет все контакты, по которым нет ни одного входящего или исходящего сообщения ни в одном канале (WhatsApp, SMS, email, Messenger, Instagram).
3. Если таких контактов нет, появится уведомление «Удалено неиспользуемых контактов (0)», и список останется прежним.
4. Если пустые контакты найдены, система покажет их количество. Подтвердите удаление.
5. Удаление необратимо: восстановить стертые данные невозможно.

**Q: Перезапишет ли синхронизация с Google те имена, которые операторы уже внесли вручную?**

Нет. Имена, измененные или добавленные вашей командой, сохраняются без изменений.

**Q: Мне нужно подтянуть имена только для текущих клиентов, без загрузки всей личной записной книжки.**

Воспользуйтесь кнопкой «Обновить только имена».

**Q: Я не нахожу блок интеграции с Google Contacts.**

Он отображается только в том случае, если эта функция поддерживается конфигурацией вашего рабочего пространства.

**Q: Я не вижу раздел «Импорт контактов из файла» или «Экспорт контактов».**

Для импорта требуется право «Показывать номер контакта». Для экспорта требуются права «Просматривать справочник контактов» и «Показывать номер контакта». Обратитесь к администратору.

**Q: Создаст ли импорт дубликаты клиентов?**

Нет. Номер, который уже есть в SyBox, обновляется, даже если в файле он записан иначе (с пробелами, с начальным 0 или с 00 вместо +).

**Q: В моём файле Excel номера телефонов отображаются как 2.01E+11.**

Так Excel отображает длинное число в узком столбце. Полный номер по-прежнему хранится в ячейке, и SyBox считывает его целиком. Расширьте столбец, чтобы увидеть номер полностью.

Source: https://www.sybox.io/ru/help/contacts