Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Переход на BSUID в 2026 году

Раньше WhatsApp идентифицировал пользователя по номеру телефона. Теперь Meta перешла на идентификатор BSUID — уникальный ID пользователя WhatsApp, который работает даже если номер скрыт.

В течение 2026 года пользователи смогут скрывать номер телефона, указав в своем профиле username. После чего отправка по phone может перестать работать, если вы до этого не сохранили связку BSUID ↔ phone. BSUID становится новым способом идентификации, а интеграции, завязанные только на phone, со временем будут ломаться.

BSUID — это уникальный идентификатор, который WhatsApp присваивает каждому пользователю в рамках именно вашего бизнес-портфеля.

BSUID мы передаем в webhooks, а ввод username начнется в июне 2026 года на уровне отдельных стран, после чего внедрение будет происходить постепенно до конца года.

Обратная совместимость

Мы позаботились о том, чтобы ваши текущие интеграции продолжили работать без изменений.

Начиная с мая 2026 года 1MSG сохраняет внутреннюю связку вашего клиента:

BSUID ↔ phone

Это позволяет нам проводить внутренний роутинг. А именно вы сможете:

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

  • отправлять исходящее сообщение любым способом: либо по номеру телефона, либо по BSUID, как удобно;

  • обеспечивать совместимость со старыми интеграциями.

Обратим внимание: если в базе 1MSG нет связки BSUID ↔ phone, а у клиента скрыт номер телефона в WhatsApp, вы не сможете написать ему первым по номеру телефона — сообщение не доставится. Чтобы создать связку BSUID ↔ phone на 1MSG, клиент должен либо сам написать вам, либо получить от вас сообщение до того, как скроет номер телефона.

Отправлять исходящее сообщение вы сможете, используя как номер телефона, так и BSUID:

  • через phone — принимает и {{phone}}, и {{bsuid}};

  • через chatID — принимает и {{phone@c.us}}, {{bsuid@lid}} and {username}@username;

  • через bsuid — принимает {{bsuid}}

Новые поля в webhook'ах

Мы сохраняем у себя связку BSUID ↔ phone, однако вы также можете получить и сохранить их у себя в интеграции. Напомним, что BSUID уникален в рамках именно вашего бизнес-портфеля.

Входящие сообщения

Уже сейчас во всех входящих webhook'ах доступны дополнительные поля:

Поле
Описание

authorBsuid

BSUID отправителя входящего (RU.1504711984690866)

authorUserName

Username пользователя WhatsApp

Whatsapp Business API documentationdocs.1msg.io

Webhook'и отправки, доставки и прочтения

В webhook'ах ack:

  • отправки сообщений;

  • доставки;

  • прочтения;

теперь также передаются:

Поле
Описание

bsuid

BSUID клиента

phone

Номер телефона клиента (если доступен)

username

Username клиента (если передан Meta)

Whatsapp Business API documentationdocs.1msg.io

Изменение логики ChatID

Так как Meta постепенно переходит на новую модель, где пользователь может:

  • скрыть свой номер телефона, используя username;

  • взаимодействовать с бизнесом через внутренний идентификатор BSUID.

  • номер телефона перестает быть основным идентификатором

Полу chatId будет поддерживать сохранение двух форматов.

Убедитесь, что ваша интеграция корректно обработает новый формат и длину поля chatId: RU.1504711984690866@lid

Формат BSUID

Начинаться с двухбуквенного кода страны пользователя по стандарту ISO 3166 alpha-2⁠ и точки, за которыми следует до 128 буквенно-цифровых символов (например, US.13491208655302741918).

Для chatId прибавляется маска @lid.

Текущая логика

Для существующих клиентов ChatID продолжит сохраняться в прежнем формате:

Например:

Новые пользователи без телефона

Если клиент впервые напишет после внедрения новой модели Meta (и нет связки BSUID ↔ phone) и номер телефона клиента скрыт, ChatID будет сохранён в формате:

Например:

Если позже пользователь откроет свой номер телефона или вручную поделится им,

ChatID всё равно останется:

Это сделано специально, чтобы не менять идентификатор диалога.

Почему ChatID не меняется обратно на телефон

BSUID является постоянным идентификатором пользователя внутри новой архитектуры WhatsApp.

Даже если номер телефона позже станет доступен, изменение ChatID могло бы:

  • привести к появлению двух разных чатов;

  • нарушить связи сообщений;

  • вызвать проблемы в CRM и интеграциях.

Поэтому после создания чата через BSUID его идентификатор остаётся неизменным.

Будущий переход на BSUID

Так как Meta постепенно движется к модели BSUID как основной идентификатор, то все чаты с будущем будут использовать формат:

Точные сроки полного перехода пока не объявлены.

Важно

Для корректной работы обратной совместимости между phone ↔ BSUID крайне важно не отключать функцию хранения и синхронизации контактов в WhatsApp Business.

Если отключить сбор контакто в Meta Business Manager:

  • WhatsApp перестанет сохранять связку phone ↔ BSUID;

  • новые пользоватли с скрытым номером телефона могут стать недоступны для отправки сообщений по номеру;

  • часть ранее накопленных связей между phone и BSUID может быть утрачена;

  • это может повлиять на возможность продолжать переписку со старыми клиентами после перехода Meta на новую модель идентификации.

FAQ

Если мой клиент зарегистрирует никнейм, смогу ли я ему писать?

Да, если у вас уже есть их номер телефона из предыдущего диалога, вы можете продолжать отправлять им сообщения независимо от того, зарегистрировал или сменил ли он имя пользователя. В «Книге контактов» эта связь сохраняется автоматически благодаря сопоставлению номера телефона с BSUID на основе всех предыдущих взаимодействий.

Что такое BSUID и зачем он нужен моей системе?

BSUID — это уникальный идентификатор, который WhatsApp присваивает каждому пользователю в рамках вашего бизнес-портфеля. Когда пользователь меняет имя пользователя и перестает сообщать свой номер телефона, вместо него ваша система получает BSUID. Без этого идентификатора вы не сможете идентифицировать таких пользователей и отвечать им.

Мы используем рекламу с переходом по ссылке в WhatsApp. Что это значит для нас?

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

Каков реальный срок выполнения?

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

Мы работаем с несколькими клиентами в разных портфелях. Будет ли у одного и того же клиента разный идентификатор в каждом из них?

Да. Идентификаторы BSUID привязаны к бизнес-портфелю, поэтому один и тот же клиент будет отображаться с разными идентификаторами BSUID в каждом портфеле.

Last updated