QR-коды против SMS: Какой способ подключения к WhatsApp лучше?

Сторонние сервисы для обмена сообщениями с Whatapp  находятся сегодня на пике развития. Такие сервисы предлагают некоторые функции, недоступные в Whatsapp Business API, например история сообщений, список контактов, групповые чаты. Ключевым моментом  в их работе является используемый метод авторизации.  Самый популярный – это интеграция через WEB интерфейс Whatsapp путем сканирования QR кода в связанных устройствах мобильного приложения. Но есть и другой незаслуженной забытый способ — это интеграция через SMS-верификацию.

Данный способ отошел на второй план вместе с прекращением поддержки библиотеки Yowsup в 2021 г. Но сейчас наблюдаются предпосылки его второго рождения. Важным моментом в этом играет обратная совместимость. Независимо от выбранного способа авторизации, практически все функции Whatsapp, за исключением специфических для мобильного приложения (например, геолокации), будут работать одинаково, а значит API не будет отличаться. Рассмотрим оба способа подробнее:

Авторизация по QR

В Whatsapp заложена функция синхронизации  мобильного приложения с Desktop и Web версиями. Эти версии не могут работать независимо от мобильного приложения. При первом запуске в них генерируется QR код, который нужно отсканировать в мобильном приложении на вкладке «связанные устройства» . QR код содержит публичный ключ клиента, идентификаторы клиента и сервера, версию ватсаппа и кое-что другое. Народные умельцы давно научились генерировать QR своими библиотеками и выдавать себя либо за Web, либо за Desktop версию клиента.

Авторизация по SMS

SMS-верификация в Whatsapp предназначена для проверки подлинности телефонного номера пользователя. Она основывается на отправке текстового кода подтверждения или получение кода через звонок на указанный номер телефона, который затем необходимо ввести в соответствующее поле в приложении. SMS верификация для API бота работает также. Важный момент – к одному номеру телефона может быть привязано только одно приложение Whatsapp, поэтому ввод SMS кода в API сервисе приводит к автоматическому выходу из приложения на телефоне.

QR против SMS

Пример использования API для регистрации телефона

С  авторизацией по QR-коду все понятно. Есть бесчисленное количество сервисов, предоставляющих  такой вариант подключения API. Но что насчет авторизации по СМС коду? API без телефона, чем-то напоминающий Whatsapp Business API, только с расширенными функциями по управлению чатами и контактами, казалось бы, это «вожделенный», хотя и  «кусачий» способ авторизации для альтернативных сервисов Whatsapp API, должен найти своего клиента.

Но данный способ все еще не получил пока широкого распространения. Здесь я приведу последовательность выполнения запросов для авторизации по SMS, которые предоставляются:

Берем подходящий номер телефона и выполняем метод requestRegistrationCode, например, используя библиотеку baileys для nodejs, представляющую собой программную реализацию альтернативного мобильного и веб-клиента WhatsApp

import makeWASocket, { fetchLatestBaileysVersion, makeCacheableSignalKeyStore, useMultiFileAuthState } from "@whiskeysockets/baileys"  const { state, saveCreds } = await useMultiFileAuthState('baileys_auth_info') const { version, isLatest } = await fetchLatestBaileysVersion()  const sock = makeWASocket({     mobile: true,     auth: {         creds: state.creds,         /** caching makes the store faster to send/recv messages */         keys: makeCacheableSignalKeyStore(state.keys, null),     }, })  const { registration } = sock.authState.creds || { registration: {} }  await sock.requestRegistrationCode(registration)

В качестве ответа приходит сырой json из Whatsapp примерно следующего содержания:

{     "flash_type": 0,     "length": 6,     "login": "790012345673442",     "method": "sms",     "notify_after": 86400,     "retry_after": 172805,     "sms_wait": 172805,     "status": "sent",     "voice_wait": -1,     "wa_old_wait": 65 }

Если «status»: «sent», то в течение нескольких секунд мы должны получить SMS сообщение на телефон с проверочным кодом:

Далее выполняем второй запрос register, куда передаем сам код:

const response = await sock.register(whatsappCode)

В ответ получаем json

{     "autoconf_type": 1,     "lid": "64832766259272",     "login": "790012345673442",     "security_code_set": false,     "status": "ok",     "type": "existing" }

Поле «status»: «ok» означает, что номер зарегистрирован в качестве клиента Whatsapp и теперь можно использоваться как API.

Заключение

В заключение следует отметить, что при выборе стороннего сервиса Whatsapp необходимо понимать плюсы и минусы использования QR и SMS авторизации. Если требуется максимальная универсальность, то QR-верификация является более предпочтительным решением. Если же нужно обеспечить максимальную бесшовность и удобство для пользователей, то использование SMS-кодов может быть более подходящим вариантом. Что касается этической стороне вопроса, то зная номера телефонов, есть риск злоупотребления запросами смс-ок, и голосовыми звонками, что несомненно будет раздражать пользователей. Именно поэтому в Whatsapp применяется очень суровый лимит на запрос кодов для одного номера.