> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/russkii/api-1msg/perekhod-na-bsuid-v-2026-godu.md). # ❗️ Переход на BSUID в 2026 году Раньше WhatsApp идентифицировал пользователя по номеру телефона.\ Теперь Meta постепенно переходит на идентификатор BSUID — уникальный ID пользователя WhatsApp, который работает даже если номер скрыт. В течение 2026 года пользователи смогут скрывать номер телефона, указав в своем профиле username. После чего отправка по phone может перестать работать, если вы до этого не сохранили связку BSUID ↔ phone. BSUID становится новым способом идентификации, а интеграции, завязанные только на phone, со временем будут ломаться. {% hint style="info" %} BSUID — это уникальный идентификатор, который WhatsApp присваивает каждому пользователю в рамках именно вашего бизнес-портфеля. {% endhint %} BSUID мы уже передаем в webhooks, а ввод username начнется в июне 2026 года на уровне отдельных стран, после чего внедрение будет происходить постепенно. ## Обратная совместимость Мы позаботились о том, чтобы ваши текущие интеграции продолжили работать без изменений. Начиная с мая 2026 года 1MSG сохраняет внутреннюю связку вашего клиента: ``` BSUID ↔ phone ``` Это позволяет нам проводить внутренний роутинг. А именно вы сможете: * отправить исходящее сообщение как обычно по номеру телефона, даже если ваш клиент скрыл свой номер, так как мы уже сохранили BSUID и автоматически проведем роутинг на BSUID; * отправлять исходящее сообщение любым способом: либо по номеру телефона, либо по BSUID, как удобно; * обеспечивать совместимость со старыми интеграциями. {% hint style="info" %} Обратим внимание: если в базе 1MSG нет связки BSUID ↔ phone, а у клиента скрыт номер телефона в WhatsApp, вы не сможете написать ему первым по номеру телефона — сообщение не доставится. Чтобы создать связку BSUID ↔ phone на 1MSG, клиент должен либо сам написать вам, либо получить от вас сообщение до того, как скроет номер телефона. {% endhint %} Отправлять исходящее сообщение вы сможете, **используя как номер телефона, так и BSUID:** * через `phone` — принимает и {{phone}}, и {{bsuid}}; * через `chatID` — принимает и {{}}, и {{bsuid\@lid}}; Ожидаемые изменения в API doc: В тело запроса отправки сообщения помимо `phone` и `chatID` будет введен параметр `bsuid` . Парамерт будет доступен после открытия meta отправки сообщения по bsuid. Мы об этом дополнительно уведомим.
Варианты параметров определения получателя: * `phone` — принимает и {{phone}}, и {{bsuid}}; * `chatID` — принимает и {{}}, и {{bsuid\@lid}}; * `bsuid` — принимает {{bsuid}}.
*** ## Новые поля в webhook'ах Мы сохраняем у себя связку BSUID ↔ phone, однако вы также можете получить и сохранить их у себя в интеграции. Напомним, что BSUID уникален в рамках именно вашего бизнес-портфеля. ### Входящие сообщения Уже сейчас во всех входящих webhook'ах доступны дополнительные поля:
ПолеОписание
authorBsuidBSUID отправителя входящего (RU.1504711984690866)
authorUserName

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

(пока не введено Meta)

{% embed url="" %} *** ### Webhook'и отправки, доставки и прочтения В webhook'ах ack: * отправки сообщений; * доставки; * прочтения; теперь также передаются: | Поле | Описание | | ---------- | --------------------------------------- | | `bsuid` | BSUID клиента | | `phone` | Номер телефона клиента (если доступен) | | `username` | Username клиента (пока не введено Meta) | {% embed url="" %} *** ## Изменение логики ChatID Так как Meta постепенно переходит на новую модель, где пользователь может: * скрыть свой номер телефона, используя username; * взаимодействовать с бизнесом через внутренний идентификатор BSUID. * номер телефона перестает быть основным идентификатором Полу chatId будет поддерживать сохранение двух форматов. ``` chatId: 796700000001@c.us или chatId: RU.1504711984690866@lid ``` {% hint style="warning" %} Убедитесь, что ваша интеграция корректно обработает новый формат и длину поля chatId: RU.1504711984690866\@lid {% endhint %} **Формат BSUID** Начинаться с двухбуквенного кода страны пользователя по стандарту [ISO 3166 alpha-2⁠](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.iso.org%2Fiso-3166-country-codes.html%3Ffbclid%3DIwZXh0bgNhZW0CMTAAYnJpZBExbUpMa0FuMkpWVFJYUmxtMHNydGMGYXBwX2lkEDIyMjAzOTE3ODgyMDA4OTIAAR6P_S6nCQUgx7AzyxVd5BI9vF24MUVFStXn8kKYWyypudnxJh9YgTM3g_54Iw_aem_3DWw9PNrpfY7WYI3xf9ikg\&h=AUC2IKqMc6Cktrb8tYGq6DENaziEMtOLYE2s9vlieVw4QGdTmKl3Bw_o4LMbJrO7ftbZ19p-5NQAqWiuf9txVRlQY5iWWMX85HTz04FrimUbwbJZdm85o57ZBfhVDR_-xrpxjRt8vfZgbJ_-Dn3ijQ) и точки, за которыми следует до 128 буквенно-цифровых символов (например, `US.13491208655302741918`). Для chatId прибавляется маска @lid. ### Текущая логика Для существующих клиентов ChatID продолжит сохраняться в прежнем формате: ``` {{phone@c.us}} ``` Например: ``` 796700000001@c.us ``` *** ### Новые пользователи без телефона Если клиент впервые напишет после внедрения новой модели Meta (и нет связки BSUID ↔ phone) и номер телефона клиента скрыт, ChatID будет сохранён в формате: ``` {{bsuid@lid}} ``` Например: ``` RU.1504711984690866@lid ``` Если позже пользователь откроет свой номер телефона или вручную поделится им, ChatID всё равно останется: ``` {{bsuid@lid}} ``` Это сделано специально, чтобы не менять идентификатор диалога. ### Почему ChatID не меняется обратно на телефон BSUID является постоянным идентификатором пользователя внутри новой архитектуры WhatsApp. Даже если номер телефона позже станет доступен, изменение ChatID могло бы: * привести к появлению двух разных чатов; * нарушить связи сообщений; * вызвать проблемы в CRM и интеграциях. Поэтому после создания чата через BSUID его идентификатор остаётся неизменным. *** ## Будущий переход на BSUID Так как Meta постепенно движется к модели BSUID как основной идентификатор, то все чаты с будущем будут использовать формат: ``` {{bsuid@lid}} ``` Точные сроки полного перехода пока не объявлены. *** ## Важно Для корректной работы обратной совместимости между 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 в каждом портфеле.