> 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 в каждом портфеле.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.1msg.io/docs/russkii/api-1msg/perekhod-na-bsuid-v-2026-godu.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.