Гайды

Проверка базы клиентов в MAX

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

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

Похожий сценарий есть в кейсе проверка базы на MAX. Там Python-скрипт брал Excel-базу, проверял номера через API и отдавал CSV с флагом наличия, chat_id, временем проверки и докачкой после паузы.

Что подготовить

Нужны:

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

Если в таблице есть персональные данные, лучше заранее убрать лишние поля. Для проверки обычно достаточно телефона и технического id строки.

Как выглядит результат

Обычно результат возвращается в CSV или Excel:

  • исходный телефон;
  • нормализованный телефон;
  • найден или не найден;
  • chat_id, если он доступен;
  • время проверки;
  • статус ошибки;
  • комментарий.

Такой файл можно дальше использовать для сегментации, рассылки, аналитики или переноса в CRM. Но рассылки и массовые сообщения нужно считать отдельно. Проверка наличия и отправка сообщений - разные задачи с разными рисками.

Где риск

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

Поэтому сначала делается маленький прогон:

  1. взять 50-100 строк;
  2. нормализовать телефоны;
  3. проверить ответы;
  4. посмотреть лимиты и паузы;
  5. согласовать итоговые колонки;
  6. только потом запускать полную базу.

Если база большая, нужен режим докачки. Тогда при паузе или ошибке скрипт продолжает с нужного места, а не начинает всё заново.

Что не стоит обещать

Нельзя обещать, что все номера будут найдены. Часть людей может не быть в MAX, часть номеров может быть старой, часть проверок может упереться в лимиты.

Правильная цель - получить проверяемую таблицу: кто найден, кто не найден, какие строки требуют ручной проверки и что можно делать дальше.

Обсудить задачу

Опишите задачу — предложу решение и ориентир по срокам.