Инструкция «Хват»: от установки до готовой базы в CRM

1. Что делает «Хват»

«Хват» — расширение для браузера Google Chrome (версия расширения — 3.7.3). Оно открывает те же страницы Яндекс.Карт и 2ГИС, что и вы, читает карточки организаций из выдачи, добирает контакты, приводит телефоны к единому виду, склеивает повторы и складывает результат в локальную базу на вашем компьютере. Дальше базу можно выгрузить в файл, в Google Таблицу или отправить прямо в CRM.

С какими сайтами работает

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

• Яндекс.Карты — yandex.ru/maps, yandex.by/maps, yandex.kz/maps;
• 2ГИС — 2gis.ru, 2gis.kz.

Если открыта любая другая страница, пульт напишет в правом верхнем углу «не карта» и подскажет: «Откройте поиск на Яндекс.Картах или 2ГИС, чтобы начать сбор».

Какие поля попадают в базу: все 34 колонки

Состав колонок вы собираете сами в конструкторе (раздел «База лидов»). Ниже — полный список системных полей расширения. Галочка «по умолчанию» означает, что колонка включена сразу после установки, «правится» — что значение можно исправить прямо в таблице.

К этим 34 колонкам добавляются поля сессии — ваши собственные метки (например «Услуга для прозвона → окна ПВХ»). Каждое такое поле становится отдельной колонкой в таблице и в выгрузке. Подробно — в разделе «Пульт».

Заполненность зависит от ниши и города, а не от программы: «Хват» переносит в таблицу ровно то, что компания сама указала о себе в открытом справочнике. В нишах вроде салонов красоты или автосервисов телефон есть почти у всех, в оптовой торговле чаще встречаются пустые поля.

Чего «Хват» не делает

• не работает в фоне при закрытом браузере — сбор идёт, только пока открыта вкладка карт;
• не обходит защиты сервисов и не притворяется другим приложением;
• не собирает персональные данные физических лиц;
• не отправляет собранное на наши серверы.

2. Что нужно для работы

Мобильные браузеры расширения не поддерживают — это ограничение самих браузеров, а не «Хвата». Safari тоже не подойдёт: у него другой формат расширений.

3. Установка расширения

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

Способ А: из магазина расширений

«Хват» опубликован в Chrome Web Store. Оттуда же он ставится в Яндекс Браузере: своего каталога расширений у Яндекса нет, он берёт их из каталогов Chrome и Opera. В Opera расширение сейчас на модерации — до публикации пользователям Opera подойдёт тот же Chrome Web Store либо установка из архива (способ Б).

1. Откройте страницу «Хвата» в магазине Прямой адрес: chromewebstore.google.com/detail/fibcpdckkjfggipbhjblocmjnkgkfjco. Ссылки на все доступные магазины собраны также в блоке «Установить расширение» на главной странице.
2. Нажмите «Установить» Браузер спросит подтверждение — согласитесь. Расширение просит доступ только к страницам Яндекс.Карт и 2ГИС.
3. Закрепите значок на панели Нажмите на иконку пазла справа от адресной строки и кликните булавку рядом с «Хватом». Значок останется на виду, и пульт всегда будет под рукой.

Способ Б: из архива, через режим разработчика

1. Распакуйте архив в постоянную папку Например Документы\Хват. Если папку потом переименовать, перенести или удалить — расширение отключится. База при этом останется в браузере, но станет недоступна, пока папку не вернуть на место.
2. Откройте chrome://extensions Скопируйте этот адрес в адресную строку и нажмите Enter. Включите «Режим разработчика» переключателем в правом верхнем углу.
3. Нажмите «Загрузить распакованное расширение» Выберите папку из первого шага. В списке появится «Хват — сбор организаций с Яндекс.Карт и 2ГИС».
4. Закрепите значок на панели Иконка пазла справа от адресной строки → булавка рядом с «Хватом».

Что откроется сразу после установки

Любым способом — расширение само откроет вкладку «Хват установлен». Это страница знакомства, на ней собрано всё для первого запуска: три шага до первого сбора, условия бесплатного доступа, таблица тарифов и кнопки «Получить ключ», «Полная инструкция», «Открыть Базу лидов».

Вкладку можно просто закрыть — на работу расширения она не влияет. Вернуться к ней позже нельзя, но всё то же самое есть в этой инструкции и в кнопке «📖 Инструкция» внутри пульта.

4. Активация ключа

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

Где взять ключ

• Ключ приходит на почту сразу после оплаты — письмо отправляется с адреса info@hvatbiz.ru. Если письма нет, проверьте папку «Спам».
• Ключ начинается с названия тарифа: DAY-…, WEEK-…, MONTH-…, PRO-… (полугодовой). В поле ввода подсказка — MONTH-XXXX-XXXX.
• Бесплатный демо-ключ — просто слово DEMO.

Как ввести

1. Нажмите на значок «Хват» справа от адресной строки Откроется пульт с экраном активации.
2. Вставьте ключ в поле и нажмите «Активировать» Пока идёт проверка, кнопка называется «Проверка ключа…». Регистр не важен: поле само переводит ввод в заглавные буквы. Можно нажать Enter вместо кнопки.
3. Дождитесь зелёного уведомления Внизу появится сообщение с названием тарифа, например «Тариф 1 Месяц», и откроется главный экран пульта.

Промокод

На экране активации есть кнопка «У меня есть промокод». Нажмите её, впишите код в поле ПРОМОКОД и нажмите «Применить промокод». Расширение пишет прямо в пульте: «Промокод выдаёт ключ со скидкой или пробный доступ. Применяется один раз и привязывается к этому компьютеру».

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

Демо-ключ

Что показывает пульт после активации

Под счётчиками появляется полоса тарифа. В ней шесть подписей, и все они живые:

• слева — название тарифа: «Тариф 1 Сутки», «Тариф 1 Неделя», «Тариф 1 Месяц», «Тариф 6 Месяцев» или «Демо-режим (до 15 строк)»;
• справа — заполненность: например 1248 / 5000. На полугодовом тарифе вместо числа стоит без лимита;
• ниже слева — срок: «действует до 18.09.2026» либо «бессрочный доступ», либо «срок истёк»;
• ниже справа — остаток: «осталось 24 дн.», «осталось 3 дня», «остался 1 день» или «сегодня последний день» (последние три дня подсвечиваются жёлтым);
• ещё ниже слева — «Рабочих мест: 1 из 1»;
• и справа — как называется это рабочее место, например «это: Chrome, Windows».

Сама полоса меняет цвет: зелёная до 80 % лимита, жёлтая после 80 %, красная при 100 %. Если навести на неё мышь, при исчерпанном лимите появится подсказка: «Лимит исчерпан. Откройте Базу лидов, выгрузите данные и очистите базу».

Одно рабочее место на один ключ

По умолчанию один ключ работает на одном компьютере — на всех тарифах. Это защита от раздачи ключа по знакомым. Число рабочих мест по конкретному ключу можно увеличить по договорённости до оплаты: напишите нам, сколько мест нужно, и ключ выпустят сразу на это количество. Демо-ключ — исключение: он общий и к компьютеру не привязывается.

Кнопка 🚪 — отвязать ключ от этого компьютера

Значок двери в правом верхнем углу пульта. Расширение переспросит: «Отвязать ключ от этого компьютера? Сбор будет остановлен. Собранная база останется на месте, а сохранённые доступы к CRM (вебхук Битрикс24, токен amoCRM, адрес Google Таблицы) будут удалены». После подтверждения появится сообщение «Ключ отвязан, доступы к CRM удалены».

База лидов при этом не удаляется — стирается только лицензия и сохранённые доступы к CRM. Так сделано специально: на общем или передаваемом компьютере следующий человек не должен получить доступ к чужой CRM.

Другие сообщения при активации

5. Первый сбор за 5 минут

1. Откройте карты и введите запрос Яндекс.Карты или 2ГИС, обычный поиск: «стоматологии Казань», «автосервисы Юго-Запад». Годится и переход по рубрике справочника.
2. Дождитесь, пока слева появится список организаций Пока список не отрисовался, собирать нечего. Правильная страница — это именно выдача со списком слева, а не карточка одной компании и не главная страница сервиса.
3. Включите сбор Либо в виджете в правом нижнем углу страницы — кнопка «▶ Включить сбор», либо в пульте — кликните по строке «Сбор выключен».
4. Не трогайте эту вкладку Вкладку можно свернуть или переключиться на другую — в быстром режиме виджет прямо пишет: «Можно свернуть вкладку — сбор продолжится». Закрывать вкладку нельзя: сессия завершится. Листать список руками не нужно, «Хват» прокручивает его сам.
5. Дождитесь надписи «Сбор завершён» Виджет добавит: «Новых организаций в выдаче нет. Сдвиньте карту или измените запрос».
6. Откройте Базу лидов и выгрузите файл Кнопка «Открыть Базу лидов» внизу пульта.

6. Пульт: каждая кнопка

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

Интерфейс обновляется — в вашей версии он может отличаться, изображения приведены как пример.

Что за что отвечает

Если открыть пульт на обычной странице, а не на картах, переключатель будет бледным и не нажмётся, а при попытке включить сбор появится сообщение: «Откройте вкладку с Яндекс.Картами или 2ГИС».

Поля сессии

Это ваши собственные метки для текущего сбора. По умолчанию в пульте три пустые строки: «Услуга для прозвона», «Направление деятельности», «Источник». Название поля станет заголовком колонки, значение подставится во все карточки, собранные с этого момента. Кнопка «+» добавляет ещё одну строку, «×» — удаляет.

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

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

«Не добавлять без телефона»

Галочка отбрасывает карточки без телефона в момент записи в базу. Она экономит лимит тарифа: карточки без телефона не занимают строки. По умолчанию выключена.

Правильный порядок расширение подсказывает само: «Надёжнее собрать всё, а пустые отсеять потом в Базе лидов кнопкой „Удалить без телефона“ — результат тот же, а сбор не потеряется».

«Бережный режим»

Удлиняет паузы и дольше ждёт каждую карточку. Дословно из пульта: «Дольше ждёт, пока карточка догрузится, и делает до трёх попыток, прежде чем идти дальше. Собирает медленнее, но не оставляет пустых телефонов. Включается автоматически, если расширение заметит, что ответы приходят долго».

Включайте на медленном интернете или слабом компьютере. Когда режим работает, в виджете на карте рядом с режимом появляется приписка «· бережно».

Где режим заметен. Он работает на обоих источниках, но сильнее всего — на 2ГИС: там телефон приходит отдельным запросом после открытия карточки, и лишние полсекунды ожидания решают, попадёт он в базу или нет. На Яндекс.Картах режим тоже действует — удлиняет паузы между страницами выдачи, — но разница там меньше, потому что телефон обычно приходит вместе со списком. Рядом с названием настройки в пульте стоит метка «2ГИС и Яндекс» — она про это же.

«Очистить сессию»

Кнопка спросит: «Удалить лиды, собранные в ТЕКУЩЕЙ сессии? Историческая база прошлых сборов не пострадает». После подтверждения появится сообщение «Сессия очищена», счётчики сессии обнулятся, а буфер на вкладке карт очистится. Это не то же самое, что «Очистить базу полностью» из Базы лидов — там удаляется вообще всё.

7. Виджет на странице карт

Чтобы не переключаться между вкладкой карт и пультом, в правом нижнем углу страницы появляется виджет со счётчиками. Он дублирует пульт и показывает, что происходит прямо сейчас. Виджет можно свернуть треугольником в его правом верхнем углу — подсказка на кнопке: «Свернуть виджет „Хват“» или «Развернуть виджет „Хват“».

Интерфейс обновляется — в вашей версии он может отличаться, изображения приведены как пример.

Шесть счётчиков виджета

Надпись режима рядом с заголовком

Все состояния виджета

Заголовок виджета всегда честно называет, что происходит. Ниже — полный список состояний, дословный текст сообщения, подпись кнопки и что делать человеку.

8. Особенности 2ГИС

2ГИС устроен иначе, чем Яндекс.Карты, и это влияет на скорость и на порядок действий.

В списке выдачи 2ГИС телефонов нет вообще. Там только название, адрес и рейтинг. Телефон и почта появляются, только когда карточка организации раскрыта. Поэтому сбор всегда двухэтапный: сначала список, затем добор контактов по каждой карточке.

Что из этого следует практически

1. Сбор по 2ГИС идёт медленнее, чем по Яндексу, — это нормально и правильно.
2. Галочку «Не добавлять без телефона» на 2ГИС держите выключенной.
3. Если счётчик «найдено» сильно опережает «в базу», а «без тел.» большой — значит, идёт добор. Дайте ему доработать, не выключайте сбор.
4. Если виджет пишет «Обхожу карточки 2ГИС по одной, чтобы собрать телефоны. Не закрывайте вкладку» — вкладка должна оставаться активной, сворачивать её в этом режиме нельзя.

Если карточки начали приходить без телефонов — типично для медленного интернета — включите «Бережный режим» в пульте: «Хват» будет дольше ждать каждую карточку и сделает до трёх попыток, прежде чем идти дальше. Расширение включает этот режим и само, когда замечает, что ответы приходят долго.

9. База лидов

Отдельная вкладка со всем собранным. Открывается кнопкой «Открыть Базу лидов» внизу пульта. Здесь данные фильтруются, правятся и выгружаются. При первом открытии показывается приветствие «Добро пожаловать в „Хват“» с кнопкой «Понятно, поехали».

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

Шапка и дашборд

В шапке — четыре плашки и четыре кнопки:

• «в базе N» — всего уникальных компаний;
• тариф — например «Тариф 1 Месяц · 1248/5000» или «Тариф 6 Месяцев · без лимита»;
• срок — «до 18.09.2026 г.», «бессрочный доступ» или «срок истёк»;
• «показано N» — сколько строк проходит через текущие фильтры;
• кнопки «🛑 Стоп-лист», «📖 Инструкция», «🩺 Диагностика» и «Обновить» (перечитать данные из базы).

Ниже — четыре карточки дашборда: «всего компаний», «с телефоном», «с сайтом», «с e-mail». По ним сразу видно качество базы: если из 1200 компаний телефон есть у 300, дело не в расширении, а в нише.

Фильтры

Первая строка — четыре поля:

• «Поиск по названию, городу, телефону, сайту» — живой поиск по всей базе. Ищет по названию, адресу, категории, городу, сайтам, телефонам и почтам одновременно;
• статус — «Любой статус», «Новые», «Выгружены в CRM»;
• источник — «Яндекс и 2ГИС», «Только Яндекс», «Только 2ГИС»;
• сортировка — «Сначала новые», «Сначала старые», «По названию», «По рейтингу».

Смарт-фильтры

Вторая строка — четыре переключателя-таблетки. Нажатая подсвечивается голубым:

• «📞 Только с телефоном» — скрыть компании без телефона;
• «🌐 Только с сайтом» — скрыть компании без сайта;
• «✉️ Только с e-mail» — скрыть компании без почты;
• «⭐ Рейтинг 4.0+» — оставить компании с рейтингом от 4,0.

Фильтры складываются друг с другом и с диапазоном дат из блока выгрузки. Важно: выгружается ровно то, что показано — все фильтры влияют на любую выгрузку, и в файл, и в CRM.

Правка прямо в таблице

Ячейки редактируемых колонок правятся на месте: кликните в ячейку, исправьте текст и нажмите Enter — появится сообщение «Сохранено». Esc вернёт прежнее значение. Уход мышкой в другое место тоже сохраняет правку.

Править можно: «Название», «Телефон», «Все телефоны», «E-mail», «Все e-mail», «Категория», «Город», «Адрес», «Короткое название». Колонки-ссылки («Сайт», «Карточка», «Фото») не редактируются — по ним кликают, чтобы перейти.

Таблица показывает по 300 строк, внизу — кнопка «Показать ещё» и надпись «Показано 300 из 4128».

Массовые операции

Отметьте строки галочками — снизу всплывёт панель с числом «N выбрано». Галочка в шапке таблицы выделяет только показанные строки; если фильтру соответствует больше, рядом появляется кнопка «Выделить все», которая захватывает все строки под текущими фильтрами (после нажатия покажет «Выделено строк: N»).

Длинные операции идут пачками по 500 строк и показывают окно «Обработка…» с полосой прогресса и подписью «Не закрывайте вкладку».

Стоп-лист

Кнопка «🛑 Стоп-лист» в шапке. В окне написано: «Компании с этими телефонами будут отбрасываться при сборе — они даже не попадут в базу и не израсходуют лимит».

• Вставьте номера в поле «Телефоны через запятую или с новой строки…» и нажмите «Добавить». Формат номера не важен: 8, +7, скобки, пробелы — расширение приводит всё к единому виду. Если разобрать не удалось, появится сообщение «Не распознал ни одного номера».
• «Очистить список» удаляет весь стоп-лист (с подтверждением «Полностью очистить стоп-лист?»).
• Ниже видно «Номеров в списке: N» и сами номера, у каждого — кнопка «Удалить». Показываются последние 300; если номеров больше, будет приписка «Показаны последние 300 из N. Остальные тоже действуют».

Загрузите туда телефоны действующих клиентов — и они не попадут в будущие выгрузки как холодные лиды. Стоп-лист живёт отдельно от базы и при очистке базы не стирается.

Конструктор колонок и пресеты

Правая колонка, блок «Конструктор колонок». Каждая строка — одна колонка, и у неё четыре управляющих элемента:

• ↑ и ↓ — поднять или опустить колонку. Порядок в списке — это порядок столбцов в таблице и в файле;
• галочка — показывать колонку в таблице и выгрузке;
• название — заголовок колонки в выгрузке. Можно переименовать «Категория» в «Ниша», если так удобнее менеджерам. Стерли название — вернётся заводское;
• поле «ID CRM» — куда положить эту колонку в CRM: UF_CRM_1234567 для Битрикс24 или числовой ID поля для amoCRM. Пусто — значение уйдёт в комментарий к карточке.

Кнопки «Включить всё» и «Снять всё» переключают все колонки разом. Колонки полей сессии подсвечены голубым фоном.

Пресеты — сохранённые схемы колонок. Выпадающий список наверху блока, рядом две кнопки: 💾 сохранить текущую схему под именем (спросит «Название пресета:») и 🗑 удалить выбранный. Пресет «По умолчанию» удалить нельзя — расширение ответит «Базовый пресет удалить нельзя». Удобно держать разные наборы: «для обзвона» (название, телефон, категория, город), «для рассылки» (название, почта, сайт), «полный».

«Удалить компании без телефона»

Кнопка внизу правой колонки. Проходит по всей базе, а не только по видимым строкам. Спросит: «Удалить N компаний без телефона? Это освободит место в лимите тарифа». Если таких нет, ответит «Все компании в базе с телефонами». После работы — «Удалено без телефона: N».

Это правильный способ сэкономить лимит: собрать всё, а пустые убрать потом. В отличие от галочки «Не добавлять без телефона», здесь вы ничего не теряете во время сбора.

«Очистить базу полностью»

Красная кнопка в самом низу. Подпись под ней: «После очистки счётчик лимита обнулится и можно собирать следующую партию».

Расширение спросит дважды. Сначала: «Удалить ВСЮ базу лидов — N компаний? Данные будут потеряны безвозвратно. Сначала выгрузите их в файл или CRM. Стоп-лист, пресеты и настройки CRM сохранятся». Затем: «Точно удалить? Отменить это действие будет нельзя». В конце — «База очищена. Лимит тарифа освобождён».

10. Выгрузка в файлы

Блок «💾 Excel / CSV» в правой колонке Базы лидов открыт по умолчанию. Три кнопки — три формата, файл сохраняется прямо на компьютер, ничего никуда не отправляется.

Имя файла формируется автоматически: Hvat_Leads_2026-09-01.xlsx. После выгрузки появится сообщение вида «XLSX: выгружено строк 1248».

Диапазон дат

Над кнопками — два поля даты: «Выгрузить лиды, собранные начиная с этой даты» и «…и до этой даты включительно». Это обычный фильтр: он влияет и на таблицу, и на все выгрузки, включая CRM. Оставьте оба пустыми, чтобы выгрузить всё.

Если ни одна колонка не включена, расширение не даст выгрузить и напишет «Включите хотя бы одну колонку». Если фильтры не оставили ни одной строки — «Нет данных для выгрузки».

11. Google Таблицы

Блок «📊 Google Таблицы». Доступен на тарифах «1 Месяц» и «6 Месяцев». На остальных вместо полей будет замок с надписью «Google Таблицы недоступны на вашем тарифе» и пояснением «Выгрузка в Google Таблицы доступна на тарифах от 1 месяца. XLSX и CSV работают на всех тарифах».

Связь настраивается через Google Apps Script: маленький скрипт внутри вашей таблицы принимает строки и дописывает их на лист. Ни логин, ни пароль от Google расширению не нужны.

1. Создайте или откройте нужную таблицу в Google Таблицах Работать будем в ней же.
2. Меню «Расширения» → «Apps Script» Откроется редактор скрипта в новой вкладке.
3. В Базе лидов нажмите «Код скрипта» Откроется окно «Код для Google Apps Script». Нажмите «Скопировать код» — появится подтверждение «Код скопирован».
4. Вставьте код в редактор Apps Script вместо того, что там было Сохраните проект.
5. «Начать развёртывание» → «Веб-приложение» В параметрах разверните доступ: «У кого есть доступ» — «Все». Это обязательный пункт.
6. Скопируйте выданный адрес и вставьте в поле «URL веб-приложения (…/exec)» Адрес должен выглядеть так: https://script.google.com/macros/s/…/exec.
7. Нажмите «Отправить в таблицу» Строки уедут пачками по 400. В конце — «Отправлено строк: N». На листе «Лиды» появится жирная закреплённая шапка и данные.

Если связь оборвётся на середине, «Хват» пометит выгруженными только те строки, которые таблица действительно приняла, — при повторной отправке они не поедут второй раз.

12. Выгрузка в amoCRM и Битрикс24

Доступна на тарифах «1 Месяц» и «6 Месяцев». На остальных вместо формы будет замок: «amoCRM недоступна на вашем тарифе» / «Битрикс24 недоступен на вашем тарифе» и подпись «Интеграция доступна на тарифах от 1 месяца».

Битрикс24: входящий вебхук

1. В портале: «Приложения» → «Разработчикам» → «Другое» → «Входящий вебхук» Из прав отметьте CRM (crm). Остальные права выдавать не нужно — «Хват» ими не пользуется.
2. Скопируйте ссылку целиком, вместе со слешем на конце Вид: https://ваш-портал.bitrix24.ru/rest/1/abcdef123456/. Если формат не тот, расширение подскажет: «Вебхук должен иметь вид https://портал.bitrix24.ru/rest/1/КОД/».
3. Вставьте её в поле «Входящий вебхук» и нажмите «Проверить связь» Портал должен ответить именем пользователя, от которого создан вебхук. Браузер при этом спросит разрешение на доступ к домену портала — его нужно дать.

Возможные ответы при проверке: «вебхук не принят порталом. Проверьте, что у него есть право „CRM“», «портал не знает такого вебхука — возможно, он удалён», «нет связи с порталом. Проверьте интернет и разрешите расширению доступ к порталу».

amoCRM: субдомен и долгосрочный токен

1. «Настройки» → «Интеграции» → создать интеграцию Права: чтение и запись сделок, контактов, компаний.
2. Вкладка «Ключи и доступы» → «Долгосрочный токен» Токен показывается один раз — скопируйте его сразу. Начинается он обычно с eyJ0eXAiOiJKV1Qi…
3. Заполните два поля в Базе лидов «Субдомен портала» — вида mycompany.amocrm.ru; «Долгосрочный токен» — сам токен. Затем «Проверить связь». Если адрес введён неверно, появится «Адрес портала должен быть вида мойпортал.amocrm.ru», если пустой токен — «Укажите долгосрочный токен интеграции».

Где взять код воронки и стадии

Поля «Статус воронки» и «Стадия сделки» — необязательные. Оставите пустыми — сделка попадёт в первую стадию воронки по умолчанию, и это нормальный рабочий вариант. Если нужна конкретная стадия:

• Битрикс24. Формат C1:NEW, где C1 — номер направления, NEW — код стадии. Посмотреть можно в адресной строке портала при открытой канбан-доске или в «CRM → Настройки → Воронки продаж».
• amoCRM. Числовой ID статуса. Виден в адресной строке при открытой воронке или в «Настройки → Воронки».

Точные коды знает только ваш портал — их нельзя подсказать со стороны, и это как раз тот случай, когда нужен ваш администратор CRM.

Что означают ответы портала

Тексты ошибок приходят от Битрикс24 и amoCRM и могут отличаться в зависимости от версии вашего портала.

Что создавать в CRM

Поле «Что создавать» одинаково для обеих систем, вариантов три: «Компания (B2B)», «Контакт (B2C)» и «Сделка» (в Битрикс24 этот пункт называется «Лид»).

Галочка «Создавать сделку» добавляет к каждой новой компании или контакту связанную сделку. Поле «Статус воронки» (в Битрикс24 — «Стадия сделки») задаёт, куда эта сделка попадёт: для amoCRM это ID статуса, для Битрикс24 — код вида C1:NEW. Подсказка в расширении: «Оставьте пустым — сделка попадёт в первую стадию воронки по умолчанию».

«Умное обновление (не плодить дубли)»

Галочка включена по умолчанию. Подсказка расширения: «Найдёт карточки с такими же телефонами и допишет в них новые контакты вместо создания дублей».

Что происходит на самом деле:

• Поиск по телефону. Перед отправкой «Хват» ищет в вашей CRM карточки с такими же номерами. В Битрикс24 — штатным поиском дублей по средству связи, в amoCRM — поиском по последним 10 цифрам номера. Ищет не по одному номеру, а по всем телефонам организации (до трёх): у компании часто два номера, и в CRM записан именно второй.
• Дополнение, а не перезапись. Найденная карточка не затирается: расширение забирает то, что уже записано в CRM, и добавляет к нему недостающие телефоны, почты и поля. Всё, что было в карточке до этого, остаётся на месте.
• Осторожность важнее скорости. Если CRM не ответила на проверку дублей по конкретной организации, «Хват» не создаёт карточку вслепую — строка пропускается и попадает в отчёт («пропущена — amoCRM не ответила на проверку дублей»). Создание вслепую — это и есть дубль у вас в портале.
• Ограничение. Для сущности «Сделка» / «Лид» поиск дублей в amoCRM не работает — у сделок нет телефона как признака. Если нужен контроль дублей, выгружайте компании или контакты.

Как проходит выгрузка

После нажатия «Выгрузить в amoCRM» или «Выгрузить в Битрикс24» появится окно «Подтверждение выгрузки». В нём написано, что именно произойдёт, например: «Будет обработано 240 компаний. Из них 30 уже выгружались раньше — они будут дополнены, а не созданы заново. Существующие карточки с такими же телефонами будут дополнены, а не продублированы. Отменить выгрузку после старта нельзя».

Если умное обновление выключено, а среди строк есть уже выгруженные, предупреждение будет жёстче: «Умное обновление выключено, поэтому в CRM появятся дубли!». Кнопки — «Отправить» и «Отмена». Во время отправки видно «Обработано 120 из 240…» и полосу прогресса, а в конце — отчёт со списком отказов CRM, если они были.

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

Забыть сохранённые доступы

Внизу каждой формы есть кнопка «Забыть токен amoCRM» / «Забыть вебхук Битрикс24». Это единственный способ стереть сохранённый доступ: очистка поля ничего не удаляет. Расширение переспросит («Сама CRM и данные в ней не пострадают») и ответит «Доступ к amoCRM удалён». Те же доступы стираются автоматически, если отвязать ключ кнопкой 🚪 в пульте.

Подробный разбор настройки с обеих сторон — в статье о выгрузке лидов в Битрикс24 и amoCRM, а про механику склейки — в статье о дублях и умном обновлении.

13. Как «Хват» склеивает дубли

Дубли склеиваются на входе, в момент записи в базу. Одна организация — одна строка, даже если она встретилась пять раз в разных запросах и в двух разных справочниках. При склейке карточка не заменяется, а дополняется: пустые поля заполняются, списки телефонов и почт объединяются, а из двух непустых значений побеждает то, что пришло из более полной карточки.

Четыре признака, по которым карточки считаются одной компанией

1. Идентификатор в источнике. Самый надёжный признак: у каждой организации на Яндексе и в 2ГИС есть свой внутренний номер. Совпал — это точно одна и та же карточка.
2. Телефон. Номер приводится к единому виду (8 (495) 123-45-67, +7 495 1234567 и 84951234567 — это один номер), добавочные и вторые номера после запятой отрезаются.
3. Домен сайта. Без www и протокола. Соцсети и агрегаторы в расчёт не идут: vk.com, instagram.com, t.me, avito.ru, zoon.ru и им подобные, иначе все компании со ссылкой на соцсеть склеились бы в одну.
4. Название плюс точка на карте. Совпало название и координаты попали в одну клетку примерно 110 × 110 метров — это одна организация. Именно этот признак и склеивает Яндекс с 2ГИС.

Почему филиалы сети с общим номером не склеиваются

Телефон — не уникальный признак организации. Общий номер ресепшена бизнес-центра, единый 8-800 франшизы, номер управляющей компании торгового центра делают «одинаковыми» десятки разных компаний. Поэтому совпадения по телефону и по домену недостаточно — нужны ещё два условия:

• источник не спорит. Если у двух карточек одного и того же справочника разные внутренние идентификаторы, значит, сам справочник считает их разными организациями. С этим «Хват» не спорит и склейку отменяет — ровно это спасает три филиала сети с единым 8-800 и арендаторов бизнес-центра с номером ресепшена;
• названия похожи. Сравнение мягкое, но с оговорками: «Стоматология № 1» и «Стоматология № 2» не склеятся (разные номера в названии — разные точки), «СтройДом» и «ДомСтрой» не склеятся, «Салон красоты Лилия» и «Салон красоты Лиана» тоже не склеятся. Правовая форма («ООО», «ИП», «АО») при сравнении не учитывается.

Логика намеренно осторожная: лучше оставить лишнюю строку, которую видно и которая правится за секунду, чем молча уничтожить контакты второй компании.

Почему одна фирма из Яндекса и из 2ГИС склеивается

У одной организации в двух справочниках разные внутренние номера, а названия почти всегда отличаются: «Дента» и «Стоматология Дента». Поэтому работает четвёртый признак — название и координаты. Если точка одна и та же и названия достаточно похожи, «Хват» объединяет карточки, а в поле источника фиксирует, что компания встретилась в обоих справочниках. Плюс телефон и домен: если у карточек совпал номер или сайт, они склеятся и без координат.

Практический вывод: собирайте оба источника. Яндекс и 2ГИС знают разные компании, а повторы схлопнутся сами.

Что видно в счётчиках

• «дублей» — карточка была признана повтором и новой строки не создала;
• «обновл.» — карточка была признана повтором и при этом принесла что-то новое, поэтому существующая строка дополнена.

14. Лимиты тарифов и очистка базы

Лимит тарифа считается по количеству строк, лежащих в базе, а не по общему объёму за период и не по количеству выгрузок.

Число выгрузок не ограничено ни на одном платном тарифе. Собрали тысячу на недельном тарифе, выгрузили, очистили базу — собираете следующую тысячу. И так сколько угодно раз за неделю. Актуальные цены — в разделе «Тарифы».

Что происходит, когда лимит упирается посреди сбора

«Хват» не выбрасывает лишнее и не останавливается раньше времени. Приходящая пачка карточек обрезается ровно под остаток лимита, обрезанные карточки не помечаются отправленными (после очистки базы они уедут снова), и только после записи расширение проверяет фактическое число строк. Если оно достигло лимита — сбор выключается, а виджет показывает состояние «Лимит тарифа».

Сделано это ради честного счёта: раньше при обрезке сбор выключался сразу, даже если часть карточек оказалась дублями и в базе осталось 4 950 из 5 000. Вы платите за 5 000 строк и получаете 5 000.

Что делать, когда лимит упёрся посреди сбора, разобрано отдельно — в статье про лимит тарифа и очистку базы.

15. Как собрать больше

Самая частая причина маленькой базы — не расширение, а формулировка запроса. Выдача карт ограничена по глубине: сколько бы организаций ни было в справочнике, по одному запросу вы получите ограниченный список.

• Дробите по районам. Двенадцать сборов по округам дают базу в три-четыре раза больше, чем один сбор по городу целиком.
• Собирайте по синонимам. «Автосервис», «СТО», «шиномонтаж», «ремонт двигателей» — списки пересекаются, но не совпадают. Повторы склеятся сами.
• Используйте рубрикатор сервиса. Готовая категория даёт более полную выдачу, чем текстовый запрос своими словами.
• Собирайте оба источника. Яндекс и 2ГИС знают разные компании, а дубли между ними расширение склеит само.
• Двигайте карту. Когда виджет написал «Сбор завершён», сдвиньте карту на соседний район и включите сбор снова — выдача пересчитается.
• Делайте паузы между большими сессиями. Собрали 3–5 тысяч — передохните, а не запускайте следующий город сразу. Это заметно снижает вероятность капчи.

16. Диагностика

Кнопка «🩺 Диагностика» находится в шапке Базы лидов. Открывается страница «Диагностика сбора» — это журнал того, что расширение видит на странице карт. Нужна она в одном случае: когда что-то пошло не так и нужно объяснить нам, что именно.

Что там показано

• Четыре числа сверху: «страниц выдачи перехвачено», «организаций в этих ответах», «из них с телефоном», «записано в базу». По ним сразу видно, на каком шаге теряются данные;
• Вердикт — короткий разбор словами: что не так и что делать;
• Журнал последних 400 событий: время, событие, канал, подробности. Проблемные строки подсвечены. Список можно отфильтровать: «все события», «только проблемы», «страницы выдачи», «записи в базу», «карточки и добор»;
• галочка «обновлять автоматически» — журнал обновляется на ходу, прямо во время сбора.

Как приложить отчёт к обращению

1. Воспроизведите проблему Откройте вкладку карт, запустите сбор и дайте ему поработать хотя бы полминуты — журналу нужны свежие события.
2. Откройте Базу лидов → «🩺 Диагностика» Кнопка в шапке страницы.
3. Нажмите «📋 Скопировать отчёт» В буфер обмена ляжет готовый текст для письма.
4. Если сбор ничего не находит — нажмите ещё «Выгрузить образец ответа» Сохранится файл с обезличенным куском ответа сервиса. По нему мы чиним разбор быстрее всего.
5. Отправьте всё на info@hvatbiz.ru В письме напишите: какой сервис — Яндекс или 2ГИС, какой был поисковый запрос и что именно пошло не так. С отчётом вопрос обычно закрывается одним письмом.

Кнопка «Очистить журнал» стирает накопленные события — удобно нажать её перед тем, как воспроизводить проблему: в отчёт попадёт только относящееся к делу.

17. Что делать, если…

Ниже — ситуации, с которыми обращаются чаще всего. Почти все решаются за минуту без нашего участия.

18. Ограничения и честные оговорки

Чтобы не было завышенных ожиданий, перечислим прямо, чего «Хват» не умеет и где он зависит не от нас.

• Только Яндекс.Карты и 2ГИС. Другие справочники и социальные сети не поддерживаются.
• Только пока открыт браузер. Расширение не работает по расписанию и не собирает данные при закрытом браузере. Вкладку карт можно свернуть, но не закрыть.
• Одна вкладка сбора одновременно. Ускориться, запустив пять вкладок, не получится — это ограничение сознательное: так меньше вероятность капчи.
• Глубина выдачи ограничена самим сервисом. По одному запросу выдача конечна. Большая база набирается дроблением по районам, синонимам и рубрикам, а не одной кнопкой.
• Полнота данных зависит от справочника. Если компания не указала почту, взять её неоткуда. Почта — самое редкое поле, сайт есть примерно у половины, телефон — у большинства.
• Смена формата у сервиса ломает сбор. Это случается несколько раз в год. Расширение честно останавливается и говорит об этом, а не пишет мусор в базу; мы выпускаем обновление за один-два рабочих дня и продлеваем затронутые ключи.
• Капча возможна. Мы не обходим защиту сервисов. Если проверка появилась, её проходит человек.
• База живёт в браузере. Мы её не видим, не храним и не можем восстановить. Удалили расширение, не выгрузив данные — база пропала вместе с ним.
• Один ключ — одно рабочее место. Больше мест — по договорённости до оплаты.
• Умное обновление ищет по телефону. Если в вашей CRM номера записаны в произвольном виде или у организации в CRM нет телефона вовсе, сопоставить карточку не получится.
• Мы не гарантируем результат продаж. «Хват» экономит время на сборе контактов. Что вы скажете в разговоре — вне зоны нашего влияния.

19. Закон и ответственность

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

Подробнее о том, как устроена защита лицензии и где физически лежат данные, — в статье о безопасности. Юридические условия использования программы — в Публичной оферте, обработка данных — в Политике.

«Яндекс.Карты» и «2ГИС» — товарные знаки их правообладателей. «Хват» не связан с этими компаниями, не является их продуктом и не выступает их партнёром.

20. Поддержка

Не нашли ответ или что-то ведёт себя странно — напишите, разберёмся.

• Почта: info@hvatbiz.ru — единственный наш адрес. С него же приходят письма с ключами после оплаты, на него же пишите с любым вопросом
• База знаний и разборы: блог «Хвата»
• Встроенная инструкция всегда под рукой: кнопка «📖 Инструкция» в пульте и в Базе лидов

Чтобы разобраться быстрее, приложите к письму отчёт из «🩺 Диагностики» (кнопка «📋 Скопировать отчёт» в Базе лидов) и напишите: какой сервис — Яндекс или 2ГИС, какой был поисковый запрос и что именно пошло не так. С отчётом вопрос обычно закрывается одним письмом, без переписки на три дня.

Версия расширения указана внизу пульта — сейчас это 3.7.3. Инструкция обновляется вместе с ним.

21. Что почитать дальше

• ОсновыКак собрать контакты организаций с карт: пошагово
• ОшибкиТоп-5 ошибок при сборе контактов и как их избежать
• CRMПочему появляются дубли в CRM и как этого избежать
• ЦифрыСколько разговоров теряет отдел продаж на ручном сборе
• ВопросыЧасто задаваемые вопросы о сборе и выгрузке
• ВыборКак выбрать сервис сбора контактов: 8 критериев