· 2 min read

Проверка номеров Viber — Проверьте регистрацию учетной записи Viber через API

Массовая проверка Viber: файл E.164, task_type viber, /v1/gettasks. docs.checknumber.ai.

Массовая проверка Viber: файл E.164, task_type viber, /v1/gettasks. docs.checknumber.ai.

Проверьте, зарегистрирован ли номер телефона в Viber.

Viber — защищённый мессенджер, которым пользуются миллионы людей по всему миру, особенно в Восточной Европе, Азии и на Ближнем Востоке. Проверка регистрации в Viber критически важна для компаний, работающих с этими регионами.

Зачем проверять регистрацию номера в Viber?

  • Региональный маркетинг: Viber широко распространён на отдельных географических рынках
  • Диверсификация каналов: узнайте, где ваши клиенты предпочитают общаться
  • Качество базы данных: убедитесь, что контактные списки содержат активных пользователей Viber
  • Международный охват: необходим для B2B-коммуникаций на рынках, где доминирует Viber

API массовой проверки номеров Viber

Официальная документация: Viber Bulk CheckNumber API.

CheckNumber проверяет номера телефонов пакетно: загрузите файл .txt или .csv (один номер E.164 в строке), опрашивайте статус задачи, затем скачайте файл результатов.

Создать задачу

POST https://api.checknumber.ai/v1/tasks

ПараметрОписание
fileОдин номер телефона в строке, формат E.164
task_typeviber — проверка регистрации в Viber
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="viber"'

Проверить статус задачи

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'

Когда status принимает значение exported, скачайте результаты по ссылке result_url.

Столбцы результата

ПолеОписаниеПример
NumberНомер телефона в формате E.164+41798284651
viberЗарегистрирован в Viberyes, no

Поля ответа задачи

ПолеОписание
created_atВремя создания задачи
updated_atВремя последнего обновления статуса
task_idИдентификатор задачи
statuspending, processing или exported
totalКоличество номеров в файле
successОбработанные строки
failureСтроки с ошибкой
result_urlСсылка на скачивание при статусе exported

HTTP-коды состояния

КодОплатаЗначение
200списываетсяЗадача создана или статус возвращён
400бесплатноНеверные параметры или файл
500бесплатноОшибка сервера — повторите позже

Чек-лист интеграции

  1. Используйте только номера в формате E.164.
  2. Опрашивайте /v1/gettasks, пока задача не завершится.
  3. Следуйте официальной документации.
  4. Цены: страница тарифов.