Перейти к основному содержимому

BSUID и Username: Новые идентификаторы получателей WhatsApp и изменения в edna Pulse

Обновлено: 19 мая 2026

Собрали ключевую информацию о том, как изменения Meta* в WhatsApp повлияют на интеграцию с edna Pulse и что важно запланировать заранее.

Что изменится​

С июня 2026 года WhatsApp внедряет имена пользователей (Username), позволяя получателям скрывать номер телефона при взаимодействии с компаниями.

Если пользователь установит Username, отправка исходящих сообщений по номеру телефона может быть недоступна, а в вебхуках о входящих сообщениях вместо номера телефона будет передаваться BSUID (Business Scoped User ID) — уникальный идентификатор пользователя WhatsApp, используемый для адресации сообщений без номера телефона.

подсказка

Главное изменение — идентификация получателей больше не будет зависеть только от номера телефона.

  • BSUID — становится обязательным идентификатором получателя.
  • Username — позволяет скрывать номер телефона при взаимодействии с компаниями.
  • Номер телефона — остаётся приоритетным идентификатором, но становится необязательным.
  • Parent BSUID — позволяет связывать одного получателя между несколькими бизнес-портфолио.
warning

Если идентификация получателей в ваших системах построена на номере телефона, рекомендуем заранее перейти на использование 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-интеграции для отправки сообщений и работы с новыми идентификаторами получателя.

Рекомендуемые действия​

warning

Если вы храните идентификаторы в 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
warning

edna Pulse не планирует поддерживать вебхуки, связанные с именем компании. developers.facebook.com

Дорожная карта изменений на 2026 год​

ПериодЧто происходит
Начало 2026Подготовка систем и внедрение поддержки BSUID.
Февраль-март 2026
  • В вебхук-событиях тестовых сообщений появляются тестовые BSUID.
  • В Meta* Business Suite становится доступна настройка адресной книги.
Апрель-май 2026
  • Поэтапно запускается функциональность адресной книги.
  • Начинается тестирование BSUID.
  • В вебхук-событиях сообщений начинают передаваться реальные BSUID.
Июнь 2026
  • Становится доступна отправка сообщений с использованием BSUID через новое поле получателя (дата уточняется).
  • В отдельных странах начинается тестирование имён пользователей (Username).
До запуска UsernameОткрывается возможность зарезервировать имя пользователя.
Позднее в 2026 годуПользователям WhatsApp становятся доступны имена пользователей (Username), а компаниям — назначение и изменение имени компании через API (дата уточняется).
В течение 2026 годаПроисходит глобальное внедрение новых идентификаторов для компаний и пользователей.
подсказка

Информация может изменяться в зависимости от обновлений на стороне Meta*. developers.facebook.com

Чек-лист перехода на BSUID​

  1. Определите, где номер телефона используется как основной идентификатор получателя.
  2. (Опционально) Подготовьте системы к хранению новых идентификаторов получателей.
  3. Запланируйте и обновите обработку вебхуков о входящих сообщениях от edna Pulse с учётом новых идентификаторов.
  4. Проверьте и адаптируйте интеграции с CRM или CDP и другими хранилищами данных.
  5. Пересмотрите и обновите логику идентификации получателей в системах.
  6. Запланируйте и обновите методы отправки сообщений в интеграции с edna Pulse для возможности использования BSUID.
  7. (Опционально) Запланируйте и обновите методы работы с получателями в интеграции с edna Pulse.
  8. Адаптируйте бизнес-процессы под новую модель идентификации получателей.
  9. (Опционально) Оцените необходимость Parent BSUID и имени компании и запланируйте соответствующие настройки в Meta*.
подсказка

Подробнее про имена пользователей WhatsApp читайте в документации Meta*.

developers.facebook.com

FAQ​

Можно ли продолжать работать только с номером телефона?​

Отправка сообщений по номеру телефона становится возможной только в случаях, предусмотренных условиями Meta*. developers.facebook.com

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

подсказка

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

Обязательно ли использовать BSUID?​

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

Что делать, если номер телефона не приходит?​

Используйте BSUID и другие идентификаторы получателя. Вы также можете запросить идентификаторы получателя по API или увидеть их в личном кабинете edna Pulse.

Потеряются ли текущие клиенты?​

Нет, но без поддержки BSUID возрастает риск потери контекста существующих переписок.

Нужно ли обновлять API-интеграцию?​

Да, если вы используете API edna Pulse, храните данные о получателях в своих системах и используете номер телефона как основной идентификатор.

Что будет, если не поддержать изменения?​

Интеграция продолжит работать, но часть получателей может перестать корректно идентифицироваться.

Что изменится после поддержки новых идентификаторов?​

Вы сможете работать с получателями даже в тех сценариях, где номер телефона скрыт или недоступен.

Что делать при интеграции с edna Pulse по API?​

Обновить обработку вебхук-событий и поддержать новые идентификаторы в используемых методах API.

Как изменения повлияют на интеграции с CRM и внешними системами?​

Внешние системы должны поддержать новые идентификаторы и обновлённую логику работы с получателями.

         

осторожно

* Деятельность компании Meta запрещена на территории Российской Федерации.