BSUID и Username: Новые идентификаторы получателей WhatsApp и изменения в edna Pulse
Собрали ключевую информацию о том, как изменения Meta в WhatsApp повлияют на интеграцию с edna Pulse и что важно запланировать заранее.
Что изменится
С июня 2026 года WhatsApp внедряет имена пользователей (Username), позволяя получателям скрывать номер телефона при взаимодействии с компаниями.
Если пользователь установит Username, отправка исходящих сообщений по номеру телефона может быть недоступна, а в вебхуках о входящих сообщениях вместо но мера телефона будет передаваться BSUID (Business Scoped User ID) — уникальный идентификатор пользователя WhatsApp, используемый для адресации сообщений без номера телефона.
Главное изменение — идентификация получателей больше не будет зависеть только от номера телефона.
- BSUID — становится обязательным идентификатором получателя.
- Username — позволяет скрывать номер телефона при взаимодействии с компаниями.
- Номер телефона — остаётся приоритетным идентификатором, но становится необязательным.
- Parent BSUID — позволяет связывать одного получателя между несколькими бизнес-портфолио.
Если идентификация получателей в ваших системах построена на номере телефона, рекомендуем заранее перейти на использование BSUID как основного идентификатора для WhatsApp.
Новые сущности WhatsApp
BSUID
BSUID (Business Scoped User ID) — уникальный основной идентификатор пары «получатель + бизнес-портфолио».
- Один получатель может иметь несколько BSUID, если вы работаете с разными бизнес-портфолио.
- Для корректного сопоставления диалогов с получателем ориентируйтесь только на BSUID.
- Формат BSUID:
CC.<идентификатор>(например,BR.1A2B...), гдеCC— код страны. Длина идентификатора может достигать 128 символов с учётом кода страны.
developers.facebook.com
Username
Username — публичный идентификатор пользователя WhatsApp.
- Уникальное имя пользователя WhatsApp — аналог
@usernameв Telegram. - Если пользователь WhatsApp включил Username, Meta может не передавать его номер телефона в вебхуках, а отправка сообщений по номеру телефона в некоторых случаях может быть недоступна.
Номер телефона
- Остаётся приоритетным идентификатором, но становится недоступным для использования в некоторых случаях.
- Если номер телефона получателя недоступен для использования, используйте BSUID как основной идентификатор.
- Даже при использовании Username номер телефона может оставаться доступным для использования, если получатель успел добавиться в адресную книгу компании, находящуюся в бизнес-портфолио.
developers.facebook.com - Если у вас идентификация построена только на номере, возрастает риск потери контекста существующих переписок.
developers.facebook.com
Отправка авторизационных сообщений остаётся доступной только по номеру телефона.
Parent BSUID
Parent BSUID нужен для сценариев, где вы консолидируете данные по одному получателю между несколькими бизнес-портфолио.
- По умолчанию Meta не возвращает Parent BSUID.
- Настройка выполняется на стороне Meta. Если вы хотите получить Parent BSUID, обратитесь в Meta Business Support для подтверждения связи ваших бизнес-портфолио.
developers.facebook.com
Как обновления поддержит edna Pulse
edna Pulse поэтапно добавляет поддержку новых идентификаторов и будет:
- сохранять связку идентификаторов получателя
BSUID + номер телефона(когда номер передан Meta); - отображать связки идентификаторов в личном кабинете;
- передавать новые идентификаторы в вебхуках от edna Pulse.
Также будут обновлены API-интеграции для отправки сообщений и работы с новыми идентификаторами получателя.
Рекомендуемые действия
Если вы храните идентификаторы в CRM, CDP или базе данных, заранее запланируйте обновление API-методов и обработки вебхуков в интеграции с edna Pulse и начните использовать BSUID как основной идентификатор получателя для WhatsApp.
Parent BSUID
- Вы принимаете решение о необходимости использования Parent BSUID.
- Для настройки Parent BSUID обратитес ь в Meta Business Support.
- Команда edna Pulse может проконсультировать по настройке.
developers.facebook.com
Адресная книга (Contact Book)
- Адресная книга управляется в Meta.
- Адресная книга автоматически сохраняет и связывает телефонные номера и BSUID получателей, с которыми у вас были взаимодействия, чтобы обеспечить стабильную идентификацию и доступ к номеру телефона даже при использовании Username.
developers.facebook.com
Имя компании (Business Username)
- Вы принимаете решение о необходимости использования имени компании для ваших бизнес-сценариев.
- Для резервирования или настройки имени компании обратитесь в Meta Business Support.
- При изменении статуса имени компании Meta использует событие
business_username_update.
developers.facebook.com
edna Pulse не планирует поддерживать вебхуки, связанные с именем компании.
developers.facebook.com
Дорожная карта изменений на 2026 год
| Период | Что происходит |
|---|---|
| Начало 2026 | Подготовка систем и внедрение поддержки BSUID. |
| Февраль-март 2026 |
|
| Апрель-май 2026 |
|
| Июнь 2026 |
|
| До запуска Username | Открывается возможность зарезервировать имя пользователя. |
| Позднее в 2026 году | Пользователям WhatsApp становятся доступны имена пользователей (Username), а компаниям — назначение и изменение имени компании через API (дата уточняется). |
| В течение 2026 года | Происходит глобальное внедрение новых идентификаторов для компаний и пользователей. |
Информация может изменяться в зависимости от обновлений на стороне Meta.
developers.facebook.com
Чек-лист перехода на BSUID
- Определите, где номер телефона используется как основной идентификатор получателя.
- (Опционально) Подготовьте системы к хранению новых идентификаторов получателей.
- Запланируйте и обновите обработку вебхуков о входящих сообщениях от edna Pulse с учётом новых идентификаторов.
- Проверьте и адаптируйте интеграции с CRM или CDP и другими хранилищами данных.
- Пересмотрите и обновите логику идентификации получателей в систе мах.
- Запланируйте и обновите методы отправки сообщений в интеграции с edna Pulse для возможности использования BSUID.
- (Опционально) Запланируйте и обновите методы работы с получателями в интеграции с edna Pulse.
- Адаптируйте бизнес-процессы под новую модель идентификации получателей.
- (Опционально) Оцените необходимость Parent BSUID и имени компании и запланируйте соответствующие настройки в Meta.
Подробнее про имена пользователей WhatsApp читайте в документации Meta.
FAQ
Можно ли продолжать работать только с номером телефона?
Отправка сообщений по номеру телефона становится возможной только в случаях, предусмотренных условиями Meta.
developers.facebook.com
Если получатель будет добавлен в вашу адресную книгу, работать с номером телефона можно без изменений.
Рекомендуем использовать BSUID как основной идентификатор получателя WhatsApp.
Обязательно ли использовать BSUID?
Да, если вы хотите корректно идентифицировать получателей во всех случаях взаимодействия через WhatsApp.
Что делать, если номер телефона не приходит?
Используйте BSUID и другие идентификаторы получателя. Вы также можете запросить идентификаторы получателя по API или увидеть их в личном кабинете edna Pulse.
Потеряются ли текущие клиенты?
Нет, но без поддержки BSUID возрастает риск потери контекста существующих переписок.
Нужно ли обновлять API-интеграцию?
Да, если вы используете API edna Pulse, храните данные о получателях в своих системах и используете номер телефона как основной идентификатор.
Что будет, если не поддержать изменения?
Интеграция продолжит работать, но часть получателей может перестать корректно идентифицироваться.
Что изменится после поддержки новых идентификаторов?
Вы сможете работать с получателями даже в тех сценариях, где номер телефона скрыт или недоступен.
Что делать при интеграции с edna Pulse по API?
Обновить обраб отку вебхук-событий и поддержать новые идентификаторы в используемых методах API.
Как изменения повлияют на интеграции с CRM и внешними системами?
Внешние системы должны поддержать новые идентификаторы и обновлённую логику работы с получателями.