ВойслабВойслабДокументация
Войти

Базы контактов

База контактов — это список телефонных номеров, по которым робот совершает звонки. К каждой базе привязан один робот. Управление базами доступно в разделе Базы контактов.

Создание базы

Нажмите «Создать базу», введите название и выберите робота, который будет обзванивать контакты. Робота можно изменить позже. После создания откроется страница управления базой.

Импорт контактов

На вкладке «Контакты» нажмите «Импорт» и загрузите CSV-файл. Файл должен содержать колонку phone (обязательно) и опционально name. Дополнительные колонки автоматически становятся параметрами контакта.

phone,name,company,city
+79001234567,Иванов Иван,ООО Ромашка,Москва
+79007654321,Петрова Мария,ИП Петрова,Казань
+79005551234,,,Новосибирск

После загрузки система отобразит отчёт: сколько номеров импортировано, сколько пропущено (дубликаты, неверный формат) и детали по каждой ошибке. Также можно добавлять контакты по одному вручную.

Номера из глобального черного списка не добавляются в базу ни вручную, ни через CSV, ни через API/CRM-импорт. Для таких записей система покажет ошибку или пропустит строку в отчёте импорта.

Если контакты приходят из CRM, формы или другой внешней системы, вместо ручного импорта можно использовать вкладку «Интеграции» и загружать контакты автоматически по API.

Параметры контакта (например, company, city) можно использовать в настройках робота. Укажите {company} или {city} в любом поле робота — при звонке плейсхолдеры будут заменены на значения для конкретного контакта.

Встроенные параметры

Встроенные параметры {phone} и {name} доступны всегда — они берутся из телефона и имени контакта. Можно использовать и русские варианты: {телефон} и {имя}.

{phone} / {телефон}Номер телефона контакта
{name} / {имя}Имя контакта

Регистр не имеет значения: {Phone}, {PHONE} и {phone} — одно и то же. Если плейсхолдер не найден в параметрах контакта, он остаётся без изменений.

Расписание обзвона

На вкладке «Расписание» настройте, когда робот может совершать звонки:

  • Часовой пояс — выберите из 11 российских часовых поясов (от Калининграда до Камчатки)
  • Дни недели — выберите дни, в которые разрешён обзвон (по умолчанию Пн–Пт)
  • Рабочие часы — время начала и окончания обзвона с шагом 30 минут

Робот совершает звонки только в указанные дни и часы. Вне расписания обзвон приостанавливается и автоматически возобновляется при наступлении рабочего времени.

Интеграции

На вкладке «Интеграции» можно создать подключение для автоматической загрузки контактов из внешней системы. Для каждой интеграции платформа создаёт уникальный URL, на который внешняя система отправляет POST-запросы с JSON-массивом контактов.

Импорт через интеграцию использует те же правила, что и CSV: проверка телефона, дедупликация и пропуск некорректных записей. Интеграцию можно включать, отключать, редактировать и использовать для постоянной загрузки новых контактов в конкретную базу.

Подробнее о формате JSON-запроса, настройке amoCRM и технических деталях — в разделе API и интеграции.

Управление контактами

На вкладке «Контакты» для каждого номера отображается:

  • Телефон и имя контакта
  • Текущий статус (Ожидает, В процессе, Завершён и др.)
  • История последних попыток дозвона (до 3 иконок с результатами)
  • Время следующего звонка (если назначен перезвон)

Доступные действия: сбросить статус контакта для повторного обзвона, посмотреть все звонки по контакту, удалить контакт. Результаты можно экспортировать в CSV.

Если номер уже существующего контакта позже попал в глобальный черный список, контакт останется в базе, но новые звонки по нему больше не будут выполняться. Разблокировка такого контакта недоступна, пока номер находится в черном списке.

Активация и приостановка

Переключатель «Активна» на странице базы управляет запуском обзвона. Для активации необходимо выбрать робота. Вы можете приостановить обзвон в любой момент и возобновить его позже — система продолжит с того места, где остановилась.