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

Идентификаторы пользователей с бизнес-целями | Документация для разработчиков

Идентификаторы пользователей с бизнес-целями

Обновлено: 31 марта 2026 г
Данный документ был существенно обновлен 18 марта 2026 года. Подробности в журнале изменений
WhatsApp планирует запустить функцию присвоения имен пользователям в конце 2026 года.
Имена пользователей — это дополнительная функция для пользователей и компаний. Если пользователь WhatsApp использует имя пользователя, вместо номера телефона в приложении будет отображаться его имя пользователя. Однако имена пользователей для компаний не предназначены для обеспечения конфиденциальности. Использование имени пользователя для компании не приведет к скрытию номера телефона вашей компании в приложении.
Для поддержки имен пользователей Meta будет использовать новый идентификатор пользователя в бэкэнде, называемый идентификатором пользователя с привязкой к бизнесу (business-scoped user ID, или BSUID). BSUID однозначно идентифицирует пользователя WhatsApp и привязан к конкретной компании.
В этом документе описывается, как добавление имен пользователей повлияет на запросы API, ответы API и полезные нагрузки веб-хуков. Дополнительные изменения, необходимые для поддержки имен пользователей до того, как эта функция станет доступна, будут зафиксированы здесь.
Любые изменения, описанные в этом документе, могут быть внесены.

Имена пользователей

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

Идентификатор пользователя с бизнес-областью

Идентификаторы BSUID начнут появляться в веб-хуках в начале апреля 2026 года.
BSUID — это уникальный идентификатор пользователя, который можно использовать для отправки сообщений пользователю WhatsApp, если вам неизвестен его номер телефона. BSUID будет присвоен параметру user_id и будет отображаться во всех веб-хуках сообщений , независимо от того, включена ли функция указания имени пользователя или нет.
Идентификаторы BSUID привязаны к отдельным бизнес-портфелям. Это означает, что любой номер телефона компании, принадлежащий данному портфелю, может быть использован для отправки сообщения с идентификатором BSUID, привязанным к тому же портфелю, а попытки отправить сообщение с использованием номера телефона, принадлежащего другому портфелю, завершатся неудачей.
Идентификаторы BSUID будут следующими:
    сгенерировано автоматически двухбуквенного пользователя по стандарту ISO 3166 alpha-2 и точки, за которым следуют до 128 буквенно-цифровых символов (например, US.13491208655302741918 ).Уникальные для каждой пары «бизнес-портфель — пользователь» ( ранее бизнес-портфели назывались «бизнес-менеджерами»).Создаётся заново, если пользователь меняет свой номер телефона (что запускает веб-перехватчик системных сообщений о состоянии ).
    шаблонов аутентификации с одним касанием, без касания и копирования кода , для которых требуются номера телефонов пользователей.
    При отправке API-запросов с использованием BSUID, указывайте полное значение BSUID: код страны, точку и все буквенно-цифровые символы. Отсутствие или изменение кода страны, точки или буквенно-цифровых символов приведет к ошибке запроса.
    Если вы являетесь управляемой компанией с несколькими бизнес-портфелями и хотите использовать BSUID, которые будут работать во всех из них, см. раздел « Идентификаторы пользователей, относящиеся к родительскому бизнесу» .

    Идентификаторы родительских пользователей, относящиеся к бизнес-задачам

    Если вы являетесь управляемой компанией и хотите связать бизнес-портфели, вы можете обратиться к своему контактному лицу в Meta, чтобы проверить, соответствуете ли вы требованиям. Если вы соответствуете требованиям и ваши бизнес-портфели будут связаны, родительские BSUID будут включены во все веб-хуки сообщений и присвоены новому parent_user_id .
    Родительские BSUID можно использовать вместо обычных BSUID для отправки сообщений пользователям. Функционально родительские BSUID обладают теми же свойствами, что и обычные BSUID, но могут использоваться для любого номера телефона компании в наборе связанных портфелей. Родительские BSUID имеют тот же формат, что и обычные BSUID, но включают ENT между кодом страны и буквенно-цифровым идентификатором (например, US.ENT.11815799212886844830 ).
    Обратите внимание, что вы по-прежнему можете отправлять сообщения пользователям, используя их обычный BSUID, привязанный к вашему бизнес-портфелю.

    Номера телефонов

    Если пользователь WhatsApp включает функцию указания имени пользователя, его номер телефона не будет включаться в веб-хуки, если вы ранее не взаимодействовали с этим пользователем, как объяснено ниже. Поэтому, независимо от того, включил ли пользователь эту функцию или нет, BSUID пользователя будет включен в любые веб-хуки, которые обычно содержат его номер телефона, и будет присвоен новому свойству user_id.
    Чтобы уменьшить вероятность потери контекста разговора с существующими пользователями, которые включили функцию имен пользователей, номера телефонов пользователей будут включаться в веб-хуки, если выполняется любое из следующих условий:
      Вы отправляли сообщение или звонили на номер телефона пользователя в течение последних 30 дней до срабатывания веб-хукаВы получали сообщение или звонок с номера телефона пользователя в течение последних 30 дней с момента срабатывания веб-хукаПользователь находится в вашей книге контактов.
      Обратите внимание, что указанные выше условия 30-дневного периода проверки оцениваются для каждого корпоративного номера телефона. Если вы отправляете сообщение пользователю с одного из ваших корпоративных номеров телефонов, веб-хуки, связанные с другим корпоративным номером телефона в вашем портфеле, не будут включать номер телефона пользователя, если только этот конкретный номер также не отправлял или не получал сообщения или звонки на номер телефона пользователя или с него в течение последних 30 дней.
      Идентификаторы BSUID начнут отображаться в веб-хуках в начале апреля 2026 года. Однако наши API не будут поддерживать отправку сообщений, адресованных пользователям с BSUID, до мая 2026 года (точная дата уточняется). Как только наши API начнут поддерживать BSUID в мае, вы сможете отправлять сообщения пользователям, используя их BSUID, номер телефона или и то, и другое.
      Если вы являетесь поставщиком решений и предоставляете своим корпоративным клиентам услуги обмена сообщениями через WhatsApp, ваши клиенты смогут использовать ваше приложение для отправки сообщений другим пользователям, используя номера телефонов своих корпоративных портфелей и любые BSUID, привязанные к их портфелю. Однако, если вы попытаетесь использовать один из BSUID вашего корпоративного клиента с вашим собственным номером телефона, это не удастся, поскольку BSUID привязаны к портфелям (и, по сути, к активам, которыми владеет портфель).
      Если вы не уверены в принадлежности актива:
        Отправьте GET-запрос к API клиентских бизнес-аккаунтов WhatsApp, чтобы получить список аккаунтов WABA, которые вам не принадлежат, но которыми с вами поделились.Отправьте GET-запрос к API принадлежащих вам бизнес-аккаунтов WhatsApp, чтобы получить список принадлежащих вам аккаунтов WABA.Отправьте GET-запрос к API телефонных номеров , чтобы получить список телефонных номеров, принадлежащих указанной WABA.

        Requesting phone numbers from users

        Эта функция станет доступна в начале мая 2026 года.
        To make it easier to request phone numbers from WhatsApp users, a REQUEST_CONTACT_INFO button type is available that can be added to полезность и маркетинг templates.
        If a user taps this button, their virtual contact card and WhatsApp phone number will be shared in the message thread, and a contacts webhook will be triggered, containing the user’s phone number and vCard⁠.
        Если вы используете функцию контактной книги, номер телефона пользователя также будет автоматически добавлен в вашу контактную книгу. Для компаний, включивших локальное хранилище, Meta извлекает номер телефона пользователя из общей контактной карточки (vCard) и сохраняет его в вашей контактной книге в центрах обработки данных Meta. Извлекается и сохраняется только номер телефона; никакие другие данные vCard не сохраняются после стандартного периода использования данных.
        Чтобы добавить кнопку запроса контактной информации в шаблон служебной или маркетинговой формы, используйте следующую структуру полезной нагрузки при создании или редактировании шаблона служебной или маркетинговой формы:
        { "type": "buttons", "buttons": [ { "type": "REQUEST_CONTACT_INFO" },<!-- Additional button objects would go here, if using --> ] }
        Кнопки запроса контактной информации нельзя настроить, поэтому вам не нужно указывать значения каких-либо параметров при отправке шаблона.
        Пример полезной нагрузки веб-перехватчика для связи с использованием vCard:
        { "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<USER_DISPLAY_NAME> ", "имя пользователя": "<USERNAME> ", }, "ID пользователя": "<BSUID> " } ], "messages": [ { "id": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "type": "contacts", "origin": "contact_request/other",<!-- ADDED --> "контакты": [ { "vcard": "<VCARD> ",<!-- ADDED --> "телефоны": [ { "телефон": "<USER_PHONE_NUMBER> " } ] } ] } ] }, "поле": "сообщения" } ] } ] }
        Книга контактов
        

        В начале апреля 2026 года, для обеспечения непрерывности переписки, будет выпущена функция контактной книги, которая будет хранить контактную информацию пользователей WhatsApp. Контактная книга предоставляется и размещается компанией Meta; никаких работ по интеграции не требуется.
        

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

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

        Данные из контактной книги будут сохраняться до тех пор, пока вы не отключите эту функцию или не деактивируете свою учетную запись. При желании вы можете отключить эту функцию в любое время после 16 марта 2026 года в  Meta Business Suite > Настройки бизнеса > Информация о бизнесе . Если вы отключите контактную книгу, она перестанет хранить информацию о пользователях, и вся уже сохраненная информация будет удалена. Если вы снова включите контактную книгу позже, она снова начнет хранить информацию о пользователях, но ранее сохраненную информацию восстановить будет невозможно.
        

        Ограничения:
        

          Если вы используете локальное хранилище и пользователь делится с вами своим номером телефона, нажав кнопку «Поделиться контактной информацией», Meta извлекает номер телефона пользователя из предоставленной контактной карточки (vCard) и сохраняет его в вашей телефонной книге в центрах обработки данных Meta. Извлекается и сохраняется только номер телефона; никакие другие данные vCard не сохраняются после стандартного периода хранения данных в локальном хранилище .Контактные книги привязаны к бизнес-портфелям. Это означает, что если у вас есть связанные портфели, номер телефона пользователя и BSUID должны быть записаны в контактную книгу каждого портфеля отдельно; контактная информация пользователей не передается и не синхронизируется между связанными портфелями.

          

          

          

          коды стран
          

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

          

          

          

          Имена пользователей для бизнеса
          

          Компании также смогут использовать корпоративное имя пользователя. Однако, если вы используете корпоративное имя пользователя, это не приведет к скрытию вашего корпоративного номера телефона в WhatsApp или WhatsApp Business.
          

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

          Имена пользователей для корпоративных пользователей должны соответствовать следующему формату:
          

            может содержать только английские буквы (az), цифры (0-9), точку (.) и символ подчеркивания (_)Неанглийские символы (например, ñ, é, ü) не поддерживаются и приведут к ошибке запросаДлина текста должна составлять от 3 до 35 символовдолжен содержать хотя бы одну английскую букву (az, AZ)не должен начинаться или заканчиваться точкой, а также не должен состоять из двух последовательных точекне должен начинаться с wwwНе должен заканчиваться доменным именем (например, .com, .org, .net, .int, .edu, .gov, .mil, .us, .in, .html и т. д.)Регистр не учитывается при сравнении имен пользователей, но точка и символ подчеркивания — нет; например, myID и myid — это одно и то же имя пользователя, но myid, my.id и my_id — это разные имена пользователей

            

            

            

            Зарезервированные имена пользователей
            

            До того, как функция присвоения имени пользователя станет доступна, у вас будет возможность зарезервировать для вас имя пользователя, которое WhatsApp уже зарезервировал. В качестве альтернативы вы можете выбрать другое имя пользователя, соответствующее вашим фирменным требованиям. Зарезервированное имя пользователя можно зарезервировать через WhatsApp Manager, Meta Business Suite или через API . Зарезервированные имена пользователей, получившие одобрение, станут активными после того, как функция присвоения имени пользователя станет доступна.
            

            Если для вашей страницы в Facebook или аккаунта в Instagram уже используется зарезервированное имя пользователя, вам необходимо привязать номер телефона вашей компании к вашей странице в Facebook или аккаунту в Instagram, прежде чем вы сможете зарезервировать это имя пользователя.
            

            Вы можете привязать свой номер телефона при подтверждении имени пользователя в Meta Business Suite или WhatsApp Manager, либо зайдя на свою страницу в Facebook или в аккаунт Instagram и добавив номер телефона напрямую .
            

            Для привязки номера телефона вам необходим полный доступ к странице или учетной записи, либо базовый частичный доступ с разрешением manage_phone. Информацию о контроле/доступе и разрешениях см.  разделе «О разрешениях для бизнес-портфеля и бизнес-активов» .
            

            

            

            

            Приоритет отображения окна чата
            

            При отображении информации о вашей компании в окнах чата в приложении будет соблюдаться следующий приоритет (в порядке убывания приоритета). Ваши рабочие номера телефонов всегда будут отображаться в вашем профиле компании.
            

              Сохраненное имя контактаПодтвержденное название компании или официальное название Имя пользователяНомер телефона

              

              

              

              Поддерживать
              

                По любым вопросам вы можете обратиться к своему менеджеру по работе с партнерами.Вы можете обратиться в любую из стандартных служб поддержки ; для интеграции API, пожалуйста, создайте заявку в службу поддержки Direct, указав тип вопроса: Интеграция API с именами пользователей WA .Для сообщения о случаях выдачи себя за другое лицо используйте  «Сообщить  » через службу прямой поддержки Для сообщения о нарушении авторских прав используйте нашу  обратной связи по вопросам интеллектуальной собственности в WhatsApp 

                

                

                Adopt
or change a business username
                Эта функция станет доступна позже, в 2026 году.
                Возможность присвоить или изменить корпоративное имя пользователя появится позже в этом году (точная дата будет объявлена ​​дополнительно).
                Синтаксис запроса:
                curl -X POST 'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /username' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "username": "<DESIRED_USERNAME> " }'
                Синтаксис ответа в случае успеха:
                { "статус": "<STATUS> " }
                  статус — The status of the latest requested username. Values can be:
    
                    одобренный — The requested username has been approved and will be visible to WhatsApp users once the usernames feature is made available.reserved — The requested username has been reserved and approved but not yet visible to WhatsApp users. It will appear to WhatsApp users once the feature is available for everyone.
                    Синтаксис ответа в случае сбоя:
                    { "ошибка": { "сообщение": "<MESSAGE> ", "тип": "<TYPE> ", "code": <CODE>, "error_data": { "messaging_product": "whatsapp", "details": " <DETAILS>" }, "error_subcode":<ERROR_SUBCODE> , "fbtrace_id": "<FBTRACE_ID> " } }</details></code>
                    КодПодробностиВозможные причины и решения
                    10
                    Приложение не имеет разрешения на выполнение данного действия
                    Confirm that the system user whose token is used in the request has appropriate business asset access on the WhatsApp Business Account: either Full control или Partial access для Номера телефонов.
                    33
                    Неверный идентификатор
                    (1) The business phone number ID is invalid, (2) the WhatsApp Business Account associated with the business phone number has been deleted, or (3) the user whose token was used in the request has not granted the app the whatsapp_business_management permission (which requires Advanced Access if you are a поставщик решений)
                    100
                    Параметр недействителен
                    Он username format is invalid.
                    147001
                    Имя пользователя недоступно
                    Имя пользователя уже занято, не проходит наши внутренние проверки или недоступно на платформе. Попробуйте запросить другое имя пользователя.
                    147002
                    Учетная запись не соответствует требованиям для запроса имени пользователя
                    The business portfolio that owns the WhatsApp Business Account and business phone number must have a higher лимит сообщений.
                    147003
                    Аккаунт Facebook не привязан
                    You must связь⁠ the phone number to the Facebook Page that already uses the requested username.
                    147004
                    Аккаунт Instagram не привязан
                    You must связь⁠ the phone number to the Instagram account that already uses the requested username
                    133010
                    Учетная запись не зарегистрирована
                    The business phone number must first be registered for API use.
                    Получить текущее имя пользователя
                    

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

                    Синтаксис запроса:
                    

                    

                    локон
                    
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username' \ -H 'Authorization: Bearer <ACCESS_TOKEN>'
                    Синтаксис ответа:
                    

                    

                    {
                    
"username": "<USERNAME>", "status": "<STATUS>" }
                      username — Текущее имя пользователя. Будет опущено, если в рабочем номере телефона нет имени пользователя.статус — Статус пользователя. Возможные значения:

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

                        

                        

                        Получать
reserved usernames
                        Adding a new GET /<BUSINESS_PHONE_NUMBER_ID>/username_suggestions endpoint that returns a list of usernames that have been reserved for your business portfolio.
                        Call the POST /<BUSINESS_PHONE_NUMBER_ID>/username endpoint to claim the desired username from the list, which will then need to be approved. Once approved and usernames become available in your country, it will move to to an “active” status, meaning the business username will start appearing on your business profile, and users will be able to search for it using exact match search.
                        Синтаксис запроса:
                        curl 'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /username_suggestions' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> '
                        Синтаксис ответа:
                        { "данные": [ { "предложения_пользователя": [ "<RESERVED_USERNAME> ",<!-- Additional usernames would follow, if any --> ] } ], }
                          username_suggestions — An array of reserved usernames, if any. These usernames have a higher chance of approval.
                          Удалить имя пользователя
                          

                          Вы можете использовать клавишу DELETE /  /username для удаления имени пользователя, связанного с номером телефона компании.
                          

                          Синтаксис запроса:
                          

                          

                          локон
                          
-X DELETE 'https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username' \ -H 'Authorization: Bearer <ACCESS_TOKEN>'
                          Синтаксис ответа:
                          

                          

                          { "успех":<SUCCESS?> }
                          

                            success — Логическое значение. Будет установлено в true , если имя пользователя удалено успешно, в противном случае — в false .

                            

                            

                            

                            вебхук business_username_updates
                            

                            Будет добавлен новый  business_username_update 
                            

                            Пожалуйста, подпишите каждое из ваших приложений на это поле веб-перехватчика, чтобы получать уведомления об изменениях имени пользователя.
                            

                            

                            {
                            
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "time": <WEBHOOK_TRIGGER_TIMESTAMP>, "changes": [ { "field": "business_username_update", "value": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "username": "<USERNAME>", "status": "<STATUS>" } } ] } ] }
                              id — Идентификатор бизнес-аккаунта WhatsApp.время — метка времени Unix, указывающая момент срабатывания веб-перехватчика.display_phone_number — Номер телефона компании, отображаемый в вашем профиле в приложении (номер, который отображается).username — Имя пользователя, для которого изменился статус. Опускается, если статус установлен как «удален» .статус — Значения могут быть следующими:

                                Одобрено — указывает, что имя пользователя одобрено и видно пользователям WhatsApp. Срабатывает, когда статус имени пользователя меняется с «зарезервировано» на «одобрено» или когда имя пользователя было изменено через приложение WhatsApp Business.Удалено — указывает на то, что имя пользователя было удалено через приложение WhatsApp Business.Зарезервировано — указывает, что имя пользователя зарезервировано для рабочего номера телефона, но не отображается для пользователей WhatsApp. Оно станет видимым, как только функция имен пользователей станет доступна всем.

                                

                                

                                

                                Сообщения
                                

                                

                                

                                Отправлять
message requests
                                These changes will apply to ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> /сообщения endpoint requests.
                                This example syntax is sending a текст message, but the changes apply to all message types.
                                'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "получатель": "<BSUID> ",<!-- ADDED --> "type": "text", "text": { "body": "<BODY_TEXT> " } }'
                                You can include both к (phone number) and recipient (BSUID or parent BSUID) in your request. If you do, к (phone number) will take precedence. If you prefer, you can also use one or the other:
                                Чтобы отправить сообщение, используя только номер телефона пользователя:
                                  набор к to the user’s phone numberomit the recipient свойство
                                  Чтобы отправить сообщение, используя только BSUID пользователя или родительский BSUID:
                                    набор recipient to the user’s BSUID or parent BSUIDomit the к свойство
                                    Отправить ответное сообщение
                                    These changes apply to ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> /сообщения endpoint responses.
                                    { "messaging_product": "whatsapp", "contacts": [ { "input": "<USER_PHONE_NUMBER_OR_BSUID> ",<!-- CHANGED --> "wa_id": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "ID пользователя": "<BSUID> "<!-- ADDED --> } ], "messages": [ { "id": "<WHATSAPP_MESSAGE_ID> " } ] }
                                      вход — New value (BSUID or parent BSUID).
    
                                        Возвращает номер телефона пользователя, если сообщение было отправлено на этот номер.Возвращает BSUID пользователя или родительский BSUID, если он был отправлен этому BSUID или родительскому BSUID.Вернёт идентификатор группы, отправленный группе.wa_id — New behavior (can be omitted). Will return the user’s phone number, if the message was sent to the user’s phone number. Otherwise, it will be omitted.ID пользователя — New property.
    
                                          Возвращает BSUID пользователя или родительского BSUID, если сообщение было отправлено пользователю с его BSUID или родительскому BSUID.Будет опущено, если сообщение было отправлено на номер телефона пользователя, в том числе, когда в запросе содержатся как номер телефона пользователя, так и BSUID или родительский BSUID (номер телефона имеет приоритет).
                                          Пример ответа на запрос на отправку сообщения, отправленного на номер телефона пользователя (BSUID пользователя или родительский BSUID в запросе не используются):
                                          { "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }
                                          Пример ответа на запрос на отправку сообщения, отправленного на BSUID пользователя (номер телефона пользователя в запросе не использовался):
                                          { "messaging_product": "whatsapp", "contacts": [ { "input": "US.13491208655302741918", "user_id": "US.13491208655302741918" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }
                                          Пример ответа на запрос на отправку сообщения, отправленного на номер телефона пользователя и BSUID (номер телефона пользователя имеет приоритет):
                                          { "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }
                                          коды ошибок
                                          

                                          Добавление нового кода ошибки в ответ на POST-запрос /  /messages .
                                          

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

                                            

                                            

                                            Маркетинг
Messages API for WhatsApp
                                            Отправляйте запросы на маркетинговые сообщения
                                            API маркетинговых сообщений для WhatsApp будет поддерживать как номера телефонов, так и BSUID, а также родительские BSUID. Рекомендуется отправлять сообщения на номера телефонов, в первую очередь для того, чтобы вы могли продолжать получать сообщения на номера телефонов через веб-хуки.
                                            These changes will apply to POST /<BUSINESS_PHONE_NUMBER_ID>/marketing_messages endpoint requests.
                                            'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /marketing_messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "получатель": "<BSUID> ",<!-- ADDED --> "type": "template", "template": {<EXPECTED_TEMPLATE_PARAMETERS> } }'
                                            You can include both к (phone number) and recipient (BSUID or parent BSUID) in your request. If you do, к (phone number) will take precedence. If you prefer, you can also use one or the other:
                                            Чтобы отправить сообщение, используя только номер телефона пользователя:
                                              набор к to the user’s phone numberomit the recipient свойство
                                              Чтобы отправить сообщение, используя только BSUID пользователя или родительский BSUID:
                                                набор recipient to the user’s BSUID or parent BSUIDomit the к свойство
                                                Отправить маркетинговое сообщение в ответ
                                                These changes apply to POST /<BUSINESS_PHONE_NUMBER_ID>/marketing_messages endpoint responses.
                                                { "messaging_product": "whatsapp", "contacts": [ { "input": "<USER_PHONE_NUMBER_OR_ID> ",<!-- CHANGED --> "wa_id": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "ID пользователя": "<BSUID> "<!-- ADDED --> } ], "messages": [ { "id": "<WHATSAPP_MESSAGE_ID> ", "message_status": "<PACING_STATUS> " } ] }
                                                  вход — New value (BSUID or parent BSUID).
    
                                                    Возвращает номер телефона пользователя, если сообщение было отправлено на этот номер.Возвращает BSUID пользователя или родительский BSUID, если он был отправлен этому BSUID или родительскому BSUID.Вернёт идентификатор группы, если сообщение было отправлено группе.wa_id — Will return the user’s phone number, if the message was sent to the user’s phone number. Otherwise, it will be omitted.ID пользователя — New property.
    
                                                      Возвращает BSUID пользователя или родительского BSUID, если сообщение было отправлено пользователю с его BSUID или родительскому BSUID.Будет опущено, если сообщение было отправлено на номер телефона пользователя, в том числе, когда в запросе содержатся как номер телефона пользователя, так и BSUID или родительский BSUID (номер телефона имеет приоритет).
                                                      Пример ответа на отправку шаблонного сообщения на номер телефона пользователя:
                                                      { "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA", "message_status": "accepted" } ] }
                                                      Пример ответа на отправку шаблонного сообщения пользователю с BSUID:
                                                      { "messaging_product": "whatsapp", "contacts": [ { "input": "US.13491208655302741918", "user_id": "US.13491208655302741918" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA", "message_status": "accepted" } ] }
                                                      тестирование вебхуков
                                                      

                                                      Вы можете протестировать полезные нагрузки веб-хуков, отражающие реальные сценарии использования имен пользователей, используя панель управления приложениями > Варианты использования (значок карандаша) > Связь с клиентами через WhatsApp > Настройка >  конфигурации ( панель управления приложениями > WhatsApp > Конфигурация для приложений, созданных до декабря 2025 года). Нажмите  «Тест» рядом с веб-хуком сообщений, чтобы отправить тестовый веб-хук сообщений на вашу конечную точку веб-хука.
                                                      

                                                      Инструмент тестирования поддерживает веб-хуки для входящих сообщений и веб-хуки для сообщений о состоянии отправленных сообщений в следующих сценариях:
                                                      

                                                        Пользователь не указал имя пользователя — в полезные данные веб-хука будут включены поля BSUID и номер телефона, но не имя пользователя. Это состояние по умолчанию для большинства пользователей на момент запуска.Пользователь указал имя пользователя, но номер телефона недоступен — в полезные данные веб-хука будут включены поля имени пользователя и BSUID, но поля номера телефона будут опущены. Ваша интеграция должна корректно обрабатывать этот сценарий. См. раздел «Номера телефонов» для получения информации об условиях включения номеров телефонов.Пользователь указал имя пользователя, и номер телефона доступен — полезная нагрузка веб-хука будет включать все поля: имя пользователя, BSUID и номер телефона.Присутствует родительский BSUID — Для компаний со связанными бизнес-портфелями полезная нагрузка веб-хука будет включать родительский BSUID в дополнение к BSUID уровня портфеля.

                                                        

                                                        

                                                        

                                                        Краткий справочник идентификаторов веб-перехватчиков
                                                        

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

                                                        

                                                        

                                                        

                                                        Веб-хуки статуса исходящих сообщений
                                                        

                                                        Эти идентификаторы применяются к веб-хукам, отображающим статусы отправки, доставки и прочтения сообщений .
                                                        

                                                        

                                                        


Идентификатор
Отправлено на указанный номер телефона
Отправлено в BSUID




                                                        wa_id
                                                        


                                                        Всегда включено
                                                        


                                                        Включено, если номер телефона доступен в соответствии с условиями для номеров телефонов 
                                                        



                                                        ID пользователя
                                                        


                                                        Всегда включено
                                                        


                                                        Всегда включено
                                                        



                                                        parent_user_id
                                                        


                                                        Включается, если родительские BSUID включены
                                                        


                                                        Включается, если родительские BSUID включены
                                                        



                                                        имя пользователя
                                                        


                                                        Включается в список доставленных/прочитанных сообщений, если у пользователя есть имя пользователя
                                                        


                                                        Включается в список доставленных/прочитанных сообщений, если у пользователя есть имя пользователя
                                                        

                                                        

                                                        

                                                        

                                                        Веб-хуки для входящих сообщений
                                                        

                                                        Эти идентификаторы применяются к  входящих сообщений , включая сообщения, инициированные пользователем, и ответы пользователя.
                                                        

                                                        

                                                        


Идентификатор
У пользователя есть имя пользователя
У пользователя нет имени пользователя




                                                        wa_id
                                                        


                                                        Включено, если номер телефона доступен в соответствии с условиями для номеров телефонов 
                                                        


                                                        Всегда включено
                                                        



                                                        ID пользователя
                                                        


                                                        Всегда включено
                                                        


                                                        Всегда включено
                                                        



                                                        parent_user_id
                                                        


                                                        Включается, если родительские BSUID включены
                                                        


                                                        Включается, если родительские BSUID включены
                                                        



                                                        имя пользователя
                                                        


                                                        Всегда включено
                                                        


                                                        Не включено
                                                        

                                                        

                                                        

                                                        

                                                        веб-хуки сообщений
                                                        

                                                        

                                                        

                                                        

                                                        веб-хуки для сообщений о состоянии
                                                        

                                                        Эти изменения будут применяться к  для сообщений о статусе  .
                                                        

                                                        

                                                        {
                                                        
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, <!-- Contacts will be included for sent, delivered, and read status --> "contacts": [ <!-- ADDED --> { "profile": { "name": "<USER_DISPLAY_NAME>", <!-- ADDED --> <!-- Only included if user has enabled the username feature --> "username": "<USERNAME>" <!-- ADDED --> }, "wa_id": "<USER_PHONE_NUMBER>", <!-- ADDED --> "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID>" <!-- ADDED --> } ], "statuses": [ { "id": "<WHATSAPP_MESSAGE_ID>", "status": "<STATUS>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "recipient_id": "<USER_PHONE_NUMBER>", <!-- CHANGED --> "recipient_user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "parent_recipient_user_id": "<PARENT_BSUID>" <!-- ADDED --> } ] }, "field": "messages" } ] } ] }
                                                          contacts — Новый массив. Включается только для сообщений о статусе «отправлено», «доставлено» и «прочитано». Будет полностью опущен для  которые не прошли проверку .

                                                            name — Новое свойство. Значение будет установлено равным отображаемому имени пользователя WhatsApp.Имя пользователя — Новое свойство.

                                                              Если функция отображения имен пользователей включена, то будет установлено имя пользователя WhatsApp.Будет полностью опущено для  отправленных сообщений о статусе или если пользователь не включил функцию имен пользователей.wa_id — Новое свойство.

                                                                 Номера телефонов», он будет установлен на номер телефона пользователя .Номер телефона будет опущен, если его невозможно указать в соответствии с указанными условиями.user_id — Новое свойство. Будет установлено значение BSUID пользователя WhatsApp.parent_user_id  родительский BSUID пользователя . В противном случае свойство будет полностью опущено.статусы

                                                                  recipient_id — Новое поведение (можно опустить).

                                                                    Если вы отправили сообщение на этот номер телефона, значение будет установлено на номер телефона пользователя.Если вы отправили сообщение группе, значение будет установлено на её идентификатор.Этот номер будет пропущен, если вы отправили сообщение пользователю с BSUID или родительским BSUID, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» .recipient_user_id — Новое свойство. Будет установлено значение BSUID пользователя или родительского BSUID, если сообщение было отправлено пользователю с таким же BSUID. В противном случае оно будет опущено.parent_user_id  Если вы включили родительские BSUID,  родительский BSUID пользователя 

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

                                                                    

                                                                    {
                                                                    
"object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "contacts": [ { "profile": { "name": "Pablo M.", "username": "@pablomorales" }, "wa_id": "16505551234", "user_id": "US.13491208655302741918", "parent_user_id": "US.ENT.11815799212886844830" } ], "statuses": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=", "status": "delivered", "timestamp": "1750030073", "recipient_id": "16505551234", "recipient_user_id": "US.13491208655302741918", "parent_recipient_user_id": "US.ENT.11815799212886844830", "pricing": { "billable": true, "pricing_model": "PMP", "type": "regular", "category": "marketing" } } ] }, "field": "messages" } ] } ] }
                                                                    Пример веб-хука для отображения статуса отправленного сообщения, полученного от компании, в которой включены родительские BSUID, пользователю WhatsApp, в котором включена функция указания имени пользователя. В этом примере мы не можем указать номер телефона пользователя в соответствии с условиями, описанными в  Номера телефонов» (поэтому wa_id и recipient_id опущены).
                                                                    

                                                                    

                                                                    {
                                                                    
"объект":
                                                                    
"whatsapp_business_account",
                                                                    
"вход":
                                                                    
[ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "contacts": [ { "profile": { "name": "Pablo M.", "username": "@pablomorales" }, "user_id": "US.13491208655302741918", "parent_user_id": "US.ENT.11815799212886844830" } ], "statuses": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=", "status": "delivered", "timestamp": "1750030073", "recipient_user_id": "US.13491208655302741918", "parent_user_id": "US.ENT.11815799212886844830", "pricing": { "billable": true, "pricing_model": "PMP", "type": "regular", "category": "marketing" } } ] }, "field": "messages" } ] } ] }
                                                                    Веб-хуки для входящих сообщений
                                                                    

                                                                    Эти изменения касаются веб-хуков для входящих сообщений ( текстовых , графических , интерактивных и т. д.), включая входящие сообщения, отправленные пользователями в групповом чате.
                                                                    

                                                                    Приведённый ниже пример синтаксиса предназначен для входящего текстового сообщения, но изменения одинаковы для всех типов входящих сообщений.
                                                                    

                                                                    

                                                                    {
                                                                    
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "contacts": [ { "profile": { "name": "<WHATSAPP_USER_PROFILE_NAME>", <!-- Only included if user has enabled the username feature --> "username": "<USERNAME>" <!-- ADDED --> }, "wa_id": "<WHATSAPP_USER_ID>", <!-- CHANGED --> "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID>" <!-- ADDED --> } ], "messages": [ { "from": "<WHATSAPP_USER_PHONE_NUMBER>", <!-- CHANGED --> "from_user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "from_parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> <!-- Only included if incoming message sent in a group --> "group_id": "<GROUP_ID>", "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "type": "text", "text": { "body": "<MESSAGE_TEXT_BODY>" } } ] }, "field": "messages" } ] } ] }
                                                                      контакты

                                                                        профиль

                                                                          Имя пользователя — Новое свойство.

                                                                            Будет установлено значение, равное имени пользователя, если у пользователя включена функция ввода имени пользователя.Будет пропущено, если пользователь не зарегистрировал имя пользователя.wa_id — Новое поведение (можно опустить).

                                                                               Номера телефонов», он будет установлен на номер телефона пользователя .Номер телефона будет опущен, если его невозможно указать в соответствии с указанными условиями.user_id — Новое свойство, устанавливаемое в значение BSUID пользователя.parent_user_id — Новое свойство. Будет установлено значение родительского BSUID пользователя, если вы включили родительские BSUID. В противном случае оно будет опущено.сообщения

                                                                                из — Новое поведение (можно опустить).

                                                                                   Номера телефонов», он будет установлен на номер телефона пользователя .Номер телефона будет опущен, если его невозможно указать в соответствии с указанными условиями.from_user_id — Новое свойство, устанавливаемое в значение BSUID пользователя.from_parent_user_id — Новое свойство, устанавливаемое равным BSUID родительского пользователя, если вы включили родительские BSUID. В противном случае оно будет опущено.

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

                                                                                  

                                                                                  {
                                                                                  
"объект":
                                                                                  
"whatsapp_business_account",
                                                                                  
"вход":
                                                                                  
[ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "contacts": [ { "profile": { "name": "Sheena Nelson", "username": "@realsheenanelson" }, "user_id": "uUS.13491208655302741918", "parent_user_id": "US.ENT.11815799212886844830" } ], "messages": [ { "from_user_id": "US.13491208655302741918", "from_parent_user_id": "US.ENT.11815799212886844830", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA=", "timestamp": "1749416383", "type": "text", "text": { "body": "Does it come in another color?" } } ] }, "field": "messages" } ] } ] }
                                                                                  вебхуки для сообщений о состоянии системы
                                                                                  

                                                                                  Эти изменения касаются вебхуков для сообщений о состоянии системы 
                                                                                  

                                                                                  

                                                                                  {
                                                                                  
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "messages": [ { "from": "<WHATSAPP_USER_PHONE_NUMBER>", "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "type": "system", "system": { "body": "User...", <!-- CHANGED --> "wa_id": "<NEW_WHATSAPP_USER_ID>", <!-- CHANGED --> "user_id": "<NEW_BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<NEW_PARENT_BSUID>", <!-- ADDED --> "type": "<SYSTEM_CHANGE_TYPE>" <!-- CHANGED --> } } ] }, "field": "messages" } ] } ] }
                                                                                    система

                                                                                      body — Новая строка. Будет установлена ​​на имя пользователя. изменился с к если пользователь изменил свой рабочий номер телефона.wa_id — Новое поведение (можно опустить).

                                                                                        Будет опущено, если пользователь включил функцию указания имени пользователя, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» .Если функция добавления имен пользователей не включена, будет установлен номер телефона пользователя.user_id — Новое свойство. Будет установлено значение нового BSUID пользователя.parent_user_id  родительский BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено. type — Новое значение ( user_changed_user_id ). Будет установлено на user_changed_user_id , если пользователь WhatsApp изменил свой номер телефона.

                                                                                        

                                                                                        

                                                                                        

                                                                                        веб-хуки user_preferences
                                                                                        

                                                                                        Эти изменения будут применяться к  user_preferences .
                                                                                        

                                                                                        

                                                                                        {
                                                                                        
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "contacts": [ { "profile": { "name": "<WHATSAPP_USER_NAME>", <!-- Only included if user has enabled the usernames feature --> "username": "<USERNAME>" <!-- ADDED --> }, "wa_id": "<WHATSAPP_USER_ID>", <!-- CHANGED --> "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if you have enabled parent BSUIDs --> "parent_user_id": "<PARENT_BSUID>" <!-- ADDED --> } ], "user_preferences": [ { "wa_id": "<WHATSAPP_USER_ID>", <!-- CHANGED --> "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if you have enabled parent BSUIDs --> "parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> "detail": "<PREFERENCE_DESCRIPTION>", "category": "marketing_messages", "value": "<PREFERENCE>", "timestamp": <WEBHOOK_SENT_TIMESTAMP> } ] }, "field": "user_preferences" } ] } ] }
                                                                                          контакты

                                                                                            профиль

                                                                                              username — Новое свойство. Будет установлено значение имени пользователя, если функция имени пользователя включена. Свойство опускается, если функция имени пользователя отключена.wa_id — Новое поведение (можно опустить).

                                                                                                Будет опущено, если пользователь включил функцию указания имени пользователя, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» .Если функция добавления имен пользователей не включена, будет установлен номер телефона пользователя.user_id — Новое свойство. Будет установлено значение BSUID пользователя.parent_user_id  родительского BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.пользовательские_настройки

                                                                                                  wa_id — Новое поведение (можно опустить). Будет опущено, если пользователь включил функцию имени пользователя, и мы не можем включить его номер телефона в соответствии с условиями, описанными в разделе « Номера телефонов» . В противном случае будет установлен номер телефона пользователя.user_id — Новое свойство. Будет установлено значение BSUID пользователя.parent_user_id  родительского BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.

                                                                                                  

                                                                                                  

                                                                                                  

                                                                                                  вебхуки user_id_update
                                                                                                  

                                                                                                  Новый  user_id_update будет срабатывать при изменении BSUID пользователя WhatsApp. Подпишите свои приложения на это поле веб-хука, чтобы получать уведомления об изменениях BSUID.
                                                                                                  

                                                                                                  

                                                                                                  {
                                                                                                  
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "contacts": [ { "profile": { "name": "<WHATSAPP_USER_NAME>" }, "wa_id": "<WHATSAPP_USER_ID>" } ], "user_id_update": [ { "wa_id": "<WHATSAPP_USER_ID>", "detail": "User id for <WHATSAPP_USER_PROFILE_NAME> has been updated.", "user_id": { "previous": "<OLD_BSUID>", "current": "<NEW_BSUID>" }, <!-- Only included if parent BSUIDs enabled --> "parent_user_id": { "previous": "<OLD_PARENT_BSUID>", "current": "<NEW_PARENT_BSUID>" }, "timestamp": "<WEBHOOK_SENT_TIMESTAMP>" } ] }, "field": "user_id_update" } ] } ] }
                                                                                                    контакты

                                                                                                      wa_id — Будет установлен на номер телефона пользователя, если он доступен. Будет опущен, если пользователь включил функцию имени пользователя, и мы не можем включить его номер телефона в соответствии с условиями, описанными в разделе « Номера телефонов» .обновление идентификатора пользователя

                                                                                                        wa_id — Будет установлен на номер телефона пользователя, если он доступен. Будет опущен, если пользователь включил функцию имени пользователя, и мы не можем включить его номер телефона в соответствии с условиями, описанными в разделе « Номера телефонов» .Подробности — Удобочитаемое описание обновления.user_id — Объект, содержащий предыдущий и текущий BSUID пользователя.

                                                                                                          предыдущий — Старый BSUID пользователя.current — Новый BSUID пользователя.parent_user_id  BSUID родительского пользователя , если вы включили отображение BSUID родительских пользователей. В противном случае он будет опущен.

                                                                                                            предыдущий — старый родительский BSUID пользователя.current — Новый BSUID родительского узла пользователя.метка времени — метка времени Unix, указывающая, когда был отправлен веб-перехватчик.

                                                                                                            

                                                                                                            

                                                                                                            Группы
API
                                                                                                            Получить информацию о группе
                                                                                                            These changes apply to GET /<GROUP_ID> endpoint responses.
                                                                                                            { "участники": [ { "wa_id": "<USER_PHONE_NUMBER> "<!-- CHANGED --> "ID пользователя": "<BSUID> ",<!-- ADDED --><!-- Only returned if the you have enabled parent BSUIDs --> "parent_user_id": "<PARENT_BSUID> ",<!-- ADDED --><!-- Only returned if the user has enabled the usernames feature --> "имя пользователя": "<USERNAME> "<!-- ADDED --> } ], "предмет": "<GROUP_SUBJECT> ", "идентификатор": "<GROUP_ID> ", "messaging_product": "whatsapp" }
                                                                                                              wa_id — New behavior (can be omitted).
    
                                                                                                                Will be omitted if the user has enabled the username feature and we are unable to include their phone number based on the conditions described in the Номера телефонов раздел.Если функция добавления имен пользователей не включена, будет установлен номер телефона пользователя.ID пользователя — New property. Will be set to the user’s BSUID.parent_user_id — New property. Will be set to the user’s parent BSUID, if you have enabled parent BSUIDs. Otherwise, it will be omitted.имя пользователя — New property.
    
                                                                                                                  Будет установлено значение, равное имени пользователя, если у пользователя включена функция ввода имени пользователя.Будет опущено, если пользователь не использует или отключил функцию ввода имени пользователя.
                                                                                                                  Получать запросы на вступление в группу
                                                                                                                  These changes apply to ПОЛУЧАТЬ /<GROUP_ID> /join_requests endpoint responses.
                                                                                                                  { "data": [ { "join_request_id": "<JOIN_REQUEST_ID> ", "creation_timestamp": "<JOIN_REQUEST_TIMESTAMP> ", "wa_id": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "ID пользователя": "<BSUID> ",<!-- ADDED --><!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID> ",<!-- ADDED --><!-- Only included if user has enabled usernames feature --> "имя пользователя": "<USERNAME> "<!-- ADDED --> } ], "пагинация": { "курсоры": { "перед": "<BEFORE_CURSOR> ", "после": "<AFTER_CURSOR> " } } }
                                                                                                                    wa_id — New behavior (can be omitted).
    
                                                                                                                      Will be omitted if the user has enabled the username feature and we are unable to include their phone number based on the conditions described in the Номера телефонов раздел.Если функция добавления имен пользователей не включена, будет установлен номер телефона пользователя.ID пользователя — New property. Will be set to the user’s BSUID.parent_user_id — New property. Will be set to the user’s parent BSUID, if you have enabled parent BSUIDs. Otherwise, it will be omitted.имя пользователя — New property. Will be set to the user’s username, if the user has enabled the username feature. Will be omitted if the user has not enabled the username feature.
                                                                                                                      Удалить участников группы
                                                                                                                      These changes apply to УДАЛИТЬ /<GROUP_ID> /участники endpoint requests.
                                                                                                                      curl -g -X DELETE 'https://graph.facebook.com/<API_VERSION> /<GROUP_ID> /participants' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "messaging_product": "whatsapp", "participants": [ { "user": "<USER_PHONE_NUMBER> "<!-- CHANGED --> } ] }'
                                                                                                                        пользователь — Will accept a user’s phone number or BSUID.
                                                                                                                        Веб-хуки API групп
                                                                                                                        

                                                                                                                        

                                                                                                                        

                                                                                                                        

                                                                                                                        Веб-хуки для сообщений о состоянии групп
                                                                                                                        

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

                                                                                                                        

                                                                                                                        {
                                                                                                                        
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, <!-- Contacts will be included for delivered and read status --> "contacts": [ <!-- ADDED --> { "profile": { "name": "<USER_DISPLAY_NAME>", <!-- ADDED --> <!-- Only included if user has enabled usernames feature --> "username": "<USERNAME>" <!-- ADDED --> }, "wa_id": "<USER_PHONE_NUMBER>", <!-- ADDED --> "user_id": "<BSUID>", <!-- ADDED --> <-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID>" }, # Additional contact objects would follow, if aggregated { ... } ], "statuses": [ { "id": "<WHATSAPP_MESSAGE_ID>", "status": "<STATUS>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "recipient_id": "<GROUP_ID>", "recipient_type": "group", "recipient_participant_id": "<GROUP_PARTICIPANT_USER_PHONE_NUMBER>", <!-- CHANGED --> "recipient_participant_user_id": "<BSUID>", <-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "recipient_participant_parent_user_id": "<PARENT_BSUID>", <-- ADDED --> <!-- Omitted for v24.0+ unless webhook is for a free entry point conversation --> "conversation": { "id": "<CONVERSATION_ID>", "expiration_timestamp": "<CONVERSATION_EXPIRATION_TIMESTAMP>", "origin": { "type": "<CONVERSATION_CATEGORY>" } }, "pricing": { "billable": <IS_BILLABLE?>, "pricing_model": "<PRICING_MODEL>", "type": "<PRICING_TYPE>", "category": "<PRICING_CATEGORY>" } }, # Additional status objects would follow, if aggregated { ... } ] }, "field": "messages" } ] } ] }
                                                                                                                          contacts — Новый массив. Включается только для сообщений о доставленных и прочитанных сообщениях. Будет полностью опущен для веб-хуков, обрабатывающих сообщения о неудачных попытках получения.

                                                                                                                            name — Новое свойство. Значение будет установлено равным отображаемому имени пользователя WhatsApp.username — Новое свойство. Будет установлено на имя пользователя WhatsApp, если пользователь указал имя пользователя. Будет опущено для веб-хуков отправленных сообщений статуса или если пользователь не включил функцию имен пользователей.wa_id — Новое свойство.

                                                                                                                              Будет опущено, если пользователь зарегистрировал имя пользователя, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» .Если вы отправили сообщение на этот номер телефона, значение будет установлено на номер телефона пользователя.user_id — Новое свойство. Будет установлено значение BSUID пользователя WhatsApp.parent_user_id  Если включена поддержка родительских BSUID,  родительский BSUID пользователя recipient_participant_id — Изменено. Если сообщение было отправлено на этот номер, значение будет установлено на номер телефона пользователя. В противном случае оно будет опущено.recipient_participant_user_id — Будет установлено значение BSUID пользователя или родительского BSUID, если вы отправили сообщение пользователю с его BSUID или родительским BSUID. В противном случае оно будет опущено.recipient_participant_parent_user_id — Новое свойство. Если вы включили родительские BSUID, оно будет установлено на значение родительского BSUID пользователя. В противном случае оно будет опущено.

                                                                                                                              

                                                                                                                              

                                                                                                                              

                                                                                                                              вебхуки group_participants_update
                                                                                                                              

                                                                                                                              Эти изменения касаются  group_participants_update .
                                                                                                                              

                                                                                                                              

                                                                                                                              {
                                                                                                                              
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "groups": [ { "timestamp": <WEBHOOK_TRIGGER_TIMESTAMP>, "group_id": "<GROUP_ID>", <!-- Only if business removes participant from group --> "type": "group_participants_remove", "request_id": "REQUEST_ID", "removed_participants": [ { "input": "<USER_PHONE_NUMBER>", <!-- CHANGED --> } ], "initiated_by": "business" <!-- Only if user removes themself from group --> "type": "group_participants_remove", "request_id": "REQUEST_ID", "removed_participants": [ { "wa_id": "<USER_PHONE_NUMBER>" <!-- CHANGED --> "user_id": "<BSUID>", <!-- ADDED --> "parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> "username": "<USERNAME>" <!-- ADDED --> } ], "initiated_by": "participant" <!-- Only if user joins group via invite link --> "type": "group_participants_add", "reason": "invite_link", "added_participants": [ { "wa_id": "<USER_PHONE_NUMBER>" <!-- CHANGED --> "user_id": "<BSUID>", <!-- ADDED --> "parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> "username": "<USERNAME>" <!-- ADDED --> } ] <!-- Only if join request created --> "type": "group_join_request_created", "join_request_id": "<JOIN_REQUEST_ID>", "wa_id": "<USER_PHONE_NUMBER>", <!-- CHANGED --> "user_id": "<BSUID>", <!-- ADDED --> "parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> "username": "<USERNAME>" <!-- ADDED --> <!-- Only if join request revoked --> "type": "group_join_request_revoked", "join_request_id": "<JOIN_REQUEST_ID>", "wa_id": "<USER_PHONE_NUMBER>" <!-- CHANGED --> "user_id": "<BSUID>", <!-- ADDED --> "parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> "username": "<USERNAME>" <!-- ADDED --> } ] }, "field": "group_participants_update" } ] } ] }
                                                                                                                                Входные данные — Новое значение (BSUID или родительский BSUID).

                                                                                                                                  Если вы удалили пользователя из группы, используя его номер телефона, значение будет установлено на номер телефона пользователя.Значение будет установлено на BSUID пользователя или родительский BSUID, если вы удалили пользователя из группы, используя его BSUID или родительский BSUID.wa_id — Новое поведение (можно опустить).

                                                                                                                                    Этот параметр будет опущен, если пользователь включил функцию указания имени пользователя, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» . В противном случае будет установлен номер телефона пользователя.user_id — Новое свойство. Будет установлено значение BSUID пользователя.parent_user_id  Если включена поддержка родительских BSUID,  родительский BSUID пользователя username — Новое свойство. Будет установлено значение имени пользователя, если функция имени пользователя включена. В противном случае оно будет опущено.

                                                                                                                                    

                                                                                                                                    

                                                                                                                                    Блокировать
Users API
                                                                                                                                    Блокировать или разблокировать запросы пользователей
                                                                                                                                    These changes apply to the POST and DELETE Блокировать пользователей requests. This example is for a block user request syntax, but the changes also apply to unblock requests.
                                                                                                                                    curl 'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /block_users' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKENS> ' \ -d ' { "messaging_product": "whatsapp", "block_users": [ { "user": "<USER_PHONE_NUMBER> " }, { "ID пользователя": "<BSUID> "<!-- ADDED --> } ] }'
                                                                                                                                    You can include both пользователь (phone number) and ID пользователя (BSUID or parent BSUID) in your request. If you do, пользователь (phone number) will take precedence. If you prefer, you can also use one or the other:
                                                                                                                                    Чтобы заблокировать или разблокировать пользователя, используя только его номер телефона:
                                                                                                                                      Набор пользователь to the user’s phone numberOmit the ID пользователя объект
                                                                                                                                      Чтобы заблокировать или разблокировать пользователя, используя только его BSUID или родительский BSUID:
                                                                                                                                        Набор ID пользователя to the user’s BSUID or parent BSUIDOmit the пользователь объект
                                                                                                                                        Блокировать или разблокировать ответы на запросы
                                                                                                                                        These changes will apply to the POST and DELETE Блокировать пользователей request responses.
                                                                                                                                        { "messaging_product": "whatsapp", "block_users": { "added_users": [ { "input": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "wa_id": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "ID пользователя": "<BSUID> "<!-- ADDED --> } ] } }
                                                                                                                                          вход — New value (BSUID or parent BSUID).
    
                                                                                                                                            Значение будет установлено на BSUID пользователя или родительский BSUID, если вы использовали BSUID пользователя или родительский BSUID для блокировки или разблокировки пользователя.Если вы использовали номер телефона пользователя для блокировки или разблокировки, он будет установлен на его номер телефона.wa_id — New behavior (can be omitted).
    
                                                                                                                                              Значение будет опущено, если для блокировки или разблокировки пользователя использовался BSUID пользователя или родительский BSUID.Если вы использовали этот номер телефона для блокировки или разблокировки пользователя, он будет установлен на его номер телефона.ID пользователя — New property.
    
                                                                                                                                                Значение будет установлено на BSUID пользователя или родительский BSUID, если вы использовали BSUID пользователя или родительский BSUID для блокировки или разблокировки пользователя.Эта информация будет опущена, если вы использовали номер телефона пользователя для его блокировки или разблокировки.
                                                                                                                                                Получить заблокированных пользователей
                                                                                                                                                These changes apply to GET Блокировать пользователей responses.
                                                                                                                                                Синтаксис ответа:
                                                                                                                                                { "data": [ { "messaging_product": "whatsapp", "wa_id": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "ID пользователя": "<BSUID> ",<!-- ADDED --><!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID> "<!-- ADDED --> } ], "пагинация": { "курсоры": { "после": "<AFTER_CURSOR> ", "до": "<BEFORE_CURSOR> " } } }
                                                                                                                                                  wa_id — Will be set to the user’s phone number if available. Will be omitted if the user has enabled the username feature and we are unable to include their phone number based on the conditions described in the Номера телефонов раздел.ID пользователя — New property. Will be set to the user’s BSUID.parent_user_id — New property. Will be set to the user’s parent BSUID if you have enabled parent BSUIDs. Otherwise, it will be omitted.
                                                                                                                                                  Вызов API
                                                                                                                                                  Запросы на звонки, инициированные предприятиями
                                                                                                                                                  Изменения касаются запросов к API, инициированных бизнес-процессами.
                                                                                                                                                  'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /calls' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "messaging_product": "whatsapp", "to": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "получатель": "<BSUID> ",<!-- ADDED --> "action": "connect", "session": { "sdp_type": "offer", "sdp": "<RFC_4566_SDP> " } }'
                                                                                                                                                  You can include both к (phone number) and recipient (BSUID or parent BSUID) in your request. If you do, к (phone number) will take precedence. If you prefer, you can also use one or the other:
                                                                                                                                                  Чтобы позвонить пользователю, используя только его номер телефона:
                                                                                                                                                    набор к to the user’s phone numberomit the recipient свойство
                                                                                                                                                    Чтобы позвонить пользователю, используя только его BSUID или родительский BSUID:
                                                                                                                                                      набор recipient to the user’s BSUID or parent BSUIDomit the к свойство
                                                                                                                                                      Получить разрешения на совершение звонков
                                                                                                                                                      The changes apply to get call permissions requests. There are no changes to responses.
                                                                                                                                                      Получение разрешений на совершение звонков с использованием номера телефона пользователя:
                                                                                                                                                      curl 'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /call_permissions?user_wa_id=<USER_PHONE_NUMBER> ' \ -H 'Авторизация: Предъявитель<ACCESS_TOKEN> ' \
                                                                                                                                                        user_wa_id — Set to the user’s phone number.
                                                                                                                                                        Получение разрешений на вызовы с использованием BSUID пользователя или родительского BSUID:
                                                                                                                                                        curl 'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /call_permissions?recipient=<BSUID> ' \ -H 'Авторизация: Предъявитель<ACCESS_TOKEN> ' \
                                                                                                                                                          recipient — Set to the user’s BSUID or parent BSUID.
                                                                                                                                                          Отправить запрос на разрешение вызова
                                                                                                                                                          Видеть send message requests.
                                                                                                                                                          Вызов веб-хуков для запроса разрешения
                                                                                                                                                          These changes will apply to incoming call permission reply interactive messages webhooks.
                                                                                                                                                          { "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<WHATSAPP_USER_PROFILE_NAME> ",<!-- Only included if user has enabled the usernames feature --> "имя пользователя": "<USERNAME> "<!-- ADDED --> }, "wa_id": "<WHATSAPP_USER_ID> ",<!-- CHANGED --> "ID пользователя": "<BSUID> ",<!-- ADDED --><!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID> "<!-- ADDED --> } ], "сообщения": [ { "контекст": { "из": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "идентификатор": "<CONTEXTUAL_WHATSAPP_MESSAGE_ID> " }, "от": "<WHATSAPP_USER_PHONE_NUMBER> ",<!-- CHANGED --> "from_user_id": "<BSUID> ",<!-- ADDED --><!-- Only included if parent BSUIDs enabled --> "from_parent_user_id": "<PARENT_BSUID> "<!-- ADDED --> "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "type": "interactive", "interactive": { "type": "call_permission_reply", "call_permission_reply": { "response": accept, "expiration_timestamp": "<EXPIRATION_TIMTESTAMP> ", "response_source": "<RESPONSE_SOURCE> " } } } ] }, "field": "messages" } ] } ] }
                                                                                                                                                            контакты
                                                                                                                                                              профиль
                                                                                                                                                                имя пользователя — New property. Will be set to the user’s username if the user has adopted a username. Will be omitted if the user is not using a username.wa_id — New property.
        
                                                                                                                                                                  Will be omitted if the user has adopted a username and we are unable to include their phone number based on the conditions described in the Номера телефонов раздел.Если пользователь не указал имя пользователя, будет установлен номер его телефона.ID пользователя — New property. Will be set to the user’s BSUID.parent_user_id — New property. Will be set to the user’s parent BSUID if you have enabled parent BSUIDs. Otherwise, it will be omitted.сообщения
                                                                                                                                                                    от — New behavior (can be omitted).
        
                                                                                                                                                                      Если функция добавления имени пользователя не включена, имя пользователя будет установлено на номер телефона пользователя.Will be omitted if the user has enabled the username feature and we are unable to include their phone number based on the conditions described in the Номера телефонов раздел.from_user_id — New property. Will be set to the user’s BSUID.
                                                                                                                                                                      Веб-хуки для инициированных бизнесом подключенных звонков
                                                                                                                                                                      These changes apply to business-initiated connected calls webhooks.
                                                                                                                                                                      { "entry": [ { "changes": [ { "field": "calls", "value": { "contacts": [<!-- ADDED --> { "профиль": {<!-- Only included if user has enabled the usernames feature --> "имя пользователя": "<USERNAME> "<!-- ADDED --> }, "wa_id": "<USER_PHONE_NUMBER> ",<!-- ADDED --> "ID пользователя": "<BSUID> ",<!-- ADDED --><!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID> "<!-- ADDED --> } ], "вызовы": [ { "biz_opaque_callback_data": "<DATA> ", "session": { "sdp_type": "answer", "sdp": "<SDP> " }, "от": "<BUSINESS_PHONE_NUMBER> ", "идентификатор": "<WHATSAPP_CALL_ID> ", "к": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "to_user_id": "<BSUID> ",<!-- ADDED --><!-- Only included if parent BSUIDs enabled --> "to_parent_user_id": "<PARENT_BSUID> ",<!-- ADDED --> "событие": "подключиться", "метка времени": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "direction": "BUSINESS_INITIATED" } ], "metadata": { "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> ", "display_phone_number": "<BUSINESS_PHONE_NUMBER> " }, "messaging_product": "whatsapp" } } ], "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> " } ], "object": "whatsapp_business_account" }
                                                                                                                                                                        контакты — New array.
    
                                                                                                                                                                          профиль
                                                                                                                                                                            имя пользователя — New property.
            
                                                                                                                                                                              Если пользователь зарегистрировал имя пользователя, оно будет установлено на имя пользователя WhatsApp.Будет опущено для веб-хуков, отправляющих сообщения о статусе, или если пользователь не использует имя пользователя.wa_id — New property.
        
                                                                                                                                                                                Will be omitted if the user has adopted a username and we are unable to include their phone number based on the conditions described in the Номера телефонов раздел.Если вы отправили сообщение на этот номер телефона, значение будет установлено на номер телефона пользователя.ID пользователя — New property. Will be set to the WhatsApp user’s BSUID.parent_user_id — New property. Will be set to the user’s parent BSUID if you have enabled parent BSUIDs. Otherwise, it will be omitted.звонки
                                                                                                                                                                                  к — New behavior (can be omitted). Will be set to the user’s phone number if the user has adopted a username and we are able to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be omitted.to_user_id — New property. Will be set to the user’s BSUID.to_parent_user_id — New property. Will be set to the user’s parent BSUID, if you have enabled parent BSUIDs. Otherwise, the property will be omitted entirely.
                                                                                                                                                                                  Веб-хуки для инициированных пользователем подключенных звонков
                                                                                                                                                                                  These changes will apply to user-initiated connected calls webhooks.
                                                                                                                                                                                  { "entry": [ { "changes": [ { "field": "calls", "value": { "metadata": { "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> ", "display_phone_number": "<BUSINESS_PHONE_NUMBER> " }, "calls": [ { "session": { "sdp_type": "offer", "sdp": "<SDP> " }, "от": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "from_user_id": "<BSUID> ",<!-- ADDED --><!-- Only included if parent BSUIDs enabled --> "from_parent_user_id": "<PARENT_BSUID> ",<!-- ADDED --> "идентификатор": "<WHATSAPP_CALL_ID> ", "к": "<BUSINESS_PHONE_NUMBER> ", "событие": "подключение", "метка времени": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "direction": "USER_INITIATED" } ], "contacts": [ { "wa_id": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "профиль": { "имя": "<USER_DISPLAY_NAME> ",<!-- ADDED --><!-- Only included if user has enabled usernames feature --> "имя пользователя": "<USERNAME> "<!-- ADDED --> }, "ID пользователя": "<BSUID> "<!-- ADDED --> ,<!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID> "<!-- ADDED --> } ], "messaging_product": "whatsapp" } } ], "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> " } ], "object": "whatsapp_business_account" }
                                                                                                                                                                                    звонки
                                                                                                                                                                                      от — New behavior (can be omitted). Will be omitted if the username has enabled the usernames feature and we are unable to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be set to the user’s phone number.from_user_id — New property. Will be set to the user’s BSUID.from_parent_user_id — New property. Will be set to the user’s parent BSUID if you have enabled parent BSUIDs. Otherwise, it will be omitted.контакты
                                                                                                                                                                                        wa_id — New behavior (can be omitted).
        
                                                                                                                                                                                          Will be omitted if the user has adopted a username and we are unable to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be set to the user’s phone number.имя — New property. Will be set to the user’s profile name.имя пользователя — New property. If the user has adopted a username, it will be set to the user’s username. Otherwise, it will be omitted.ID пользователя — New property. Will be set to the user’s BSUID.parent_user_id — New property. Will be set to the user’s parent BSUID if you have enabled parent BSUIDs. Otherwise, it will be omitted.
                                                                                                                                                                                          Веб-хуки для завершения инициированных бизнесом звонков
                                                                                                                                                                                          These changes apply to business-initiated terminated calls webhooks.
                                                                                                                                                                                          { "entry": [ { "changes": [ { "field": "calls", "value": { "calls": [ { "biz_opaque_callback_data": "<BUSINESS_OPAQUE_DATA> ", "от": "<BUSINESS_PHONE_NUMBER> ", "идентификатор": "<WHATSAPP_CALL_ID> ", "к": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "to_user_id": "<BSUID> ",<!-- ADDED --><!-- Only included if parent BSUIDs enabled --> "to_parent_user_id": "<PARENT_BSUID> ",<!-- ADDED --> "событие": "завершить", "метка времени": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "direction": "BUSINESS_INITIATED", "status": "COMPLETED" } ], "metadata": { "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> ", "display_phone_number": "<BUSINESS_PHONE_NUMBER> " }, "контакты": [<!-- ADDED --> { "профиль": {<!-- Only included if user has enabled the usernames feature --> "имя пользователя": "<USERNAME> "<!-- ADDED --> }, "wa_id": "<USER_PHONE_NUMBER> ",<!-- ADDED --> "ID пользователя": "<BSUID> ",<!-- ADDED --><!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID> "<!-- ADDED --> } ], "messaging_product": "whatsapp" } } ], "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> " } ], "object": "whatsapp_business_account" }
                                                                                                                                                                                            звонки
                                                                                                                                                                                              к — New behavior (can be omitted). Will be set to the user’s phone number if the user has adopted a username and we are able to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be omitted.to_user_id — New property. This will be set to the user’s BSUID.to_parent_user_id — New property. Will be set to the user’s parent BSUID if you have enabled parent BSUIDs. Otherwise, it will be omitted.контакты — New array.
    
                                                                                                                                                                                                профиль
                                                                                                                                                                                                  имя пользователя — New property. If the user has adopted a username, it will be set to the user’s username. Otherwise, it will be omitted.wa_id — New property. Will be set to the user’s phone number, if the terminated call was made to the user’s phone number. Otherwise, it will be omitted.ID пользователя — New property. This will be set to the user’s BSUID.parent_user_id — New property. Will be set to the user’s parent BSUID if you have enabled parent BSUIDs. Otherwise, it will be omitted.
                                                                                                                                                                                                  Веб-хуки для завершения вызовов, инициированных пользователем
                                                                                                                                                                                                  These changes will apply to user-initiated terminated calls webhooks.
                                                                                                                                                                                                  { "entry": [ { "changes": [ { "field": "calls", "value": { "metadata": { "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> ", "display_phone_number": "<BUSINESS_PHONE_NUMBER> " }, "вызовы": [ { "продолжительность":<CALL_DURATION> , "start_time": "<CALL_START_TIMESTAMP> ", "biz_opaque_callback_data": "<BUSINESS_OPAQUE_DATA> ", "end_time": "<CALL_END_TIMESTAMP> ", "от": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "from_user_id": "<BSUID> ",<!-- ADDED --><!-- Only included if you have enabled parent BSUIDs --> "from_parent_user_id": "<PARENT_BSUID> ",<!-- ADDED --> "идентификатор": "<WHATSAPP_CALL_ID> ", "к": "<BUSINESS_PHONE_NUMBER> ", "событие": "завершить", "метка времени": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "direction": "USER_INITIATED", "status": "COMPLETED" } ], "contacts": [ { "profile": { "name": "<USER_PROFILE_NAME> "<!-- ADDED --><!-- Only included if user has enabled the usernames feature --> "имя пользователя": "<USERNAME> "<!-- ADDED --> }, "wa_id": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "ID пользователя": "<BSUID> ",<!-- ADDED --><!-- Only included if you have enabled parent BSUIDs --> "parent_user_id": "<PARENT_BSUID> "<!-- ADDED --> } ], "messaging_product": "whatsapp" } } ], "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> " } ], "object": "whatsapp_business_account" }
                                                                                                                                                                                                    звонки
                                                                                                                                                                                                      от — New behavior (can be omitted). Will be omitted if the user has enabled the usernames feature and we are unable to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be set to the user’s phone number.from_user_id — New property. Will be set to the user’s BSUID.from_parent_user_id — New property. Will be set to the user’s parent BSUID if you have enabled parent BSUIDs. Otherwise, it will be omitted.контакты
                                                                                                                                                                                                        профиль
                                                                                                                                                                                                          имя — New property. This will be set to the user’s profile nameимя пользователя — New property. If the user has adopted a username, it will be set to the user’s username. Otherwise, it will be omitted.wa_id — Will be omitted if the user has enabled the usernames feature and we are unable to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be set to the user’s phone number.ID пользователя — New property. This will be set to the user’s BSUID.parent_user_id — New property. Will be set to the user’s parent BSUID, if you have enabled parent BSUIDs. Otherwise, it will be omitted.
                                                                                                                                                                                                          Веб-хуки для отслеживания статуса инициированных бизнес-звонков
                                                                                                                                                                                                          These changes will apply to business-initiated calls status webhooks.
                                                                                                                                                                                                          { "entry": [ { "changes": [ { "field": "calls", "value": { "statuses": [ { "biz_opaque_callback_data": "<BUSINESS_OPAQUE_DATA> ", "идентификатор": "<WHATSAPP_CALL_ID> ", "type": "call", "status": "<STATUS> ", "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "recipient_id": "<USER_PHONE_NUMBER> ",<!-- CHANGED --> "recipient_user_id": "<BSUID> ",<!-- ADDED --><!-- Only included if you have enabled parent BSUIDs --> "recipient_parent_user_id": "<PARENT_BSUID> "<!-- ADDED --> } ], "метаданные": { "идентификатор_номера_телефона": "<BUSINESS_PHONE_NUMBER_ID> ", "display_phone_number": "<BUSINESS_PHONE_NUMBER> " }, "контакты": [<!-- ADDED --> { "профиль": {<!-- Only included if user has enabled the usernames feature --> "имя пользователя": "<USERNAME> "<!-- ADDED --> }, "wa_id": "<USER_PHONE_NUMBER> ",<!-- ADDED --> "ID пользователя": "<BSUID> ",<!-- ADDED --><!-- Only included if you have enabled parent BSUIDs --> "parent_user_id": "<PARENT_BSUID> "<!-- ADDED --> } ], "messaging_product": "whatsapp" } } ], "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> " } ], "object": "whatsapp_business_account" }
                                                                                                                                                                                                            статусы
                                                                                                                                                                                                              recipient_id — New behavior (can be omitted).
        
                                                                                                                                                                                                                Will be omitted if the user has adopted a username and we are unable to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be set to the user’s phone number.recipient_user_id — New property. This will be set to the user’s BSUID.recipient_parent_user_id — New property. Will be set to the user’s parent BSUID, if you have enabled parent BSUIDs. Otherwise, it will be omitted.контакты — New array.
    
                                                                                                                                                                                                                  профиль
                                                                                                                                                                                                                    имя пользователя — New property. Will be set to the user’s username, if the user has enabled the usernames feature. Otherwise, it will be omitted.wa_id — New property. Will be set to the user’s phone number if the call was made to the user’s phone number. Otherwise, it will be omitted.ID пользователя — New property. This will be set to the user’s BSUID.parent_user_id — New property. Will be set to the user’s parent BSUID, if you have enabled parent BSUIDs. Otherwise, it will be omitted.
                                                                                                                                                                                                                    SIP-приглашения для инициированных бизнесом звонков
                                                                                                                                                                                                                    These changes apply to business-initiated calls made using SIP.
                                                                                                                                                                                                                    ПРИГЛАШЕНИЕ: глоток @wa.meta.vc;transport=tls SIP/2.0 Маршрутизация записей: Via: SIP/2.0/TLS 159.65.244.171:5061;received=2803:6081:798c:93f8:5f9b:bfe8:300:0;branch=z9hG4bK0da2.36614b8977461b486ceabc004c723476.0;i=617261 Via: SIP/2.0/TLS 137.184.87.1:35181;rport=56533;received=137.184.87.1;branch=z9hG4bKQNa6meey5Dj2g Max-Forwards: 69 From:  [email protected] >;tag=Kc9QZg4496maQ К:  @wa.meta.vc> Идентификатор вызова: dc2c5b33-1b81-43ee-9213-afb56f4e56ba CSeq: 96743476 INVITE Контакт:  [email protected] :35181;transport=tls;swrad=137.184.87.1~56533~3> User-Agent: SignalWire Allow: INVITE, ACK, BYE, CANCEL, OPTIONS, MESSAGE, INFO, UPDATE, REGISTER, REFER, NOTIFY Supported: timer, path, replaces Allow-Events: talk, hold, conference, refer Session-Expires: 600;refresher=uac Min-SE: 90 Content-Type: application/sdp Content-Disposition: session Content-Length: 2427 X-Relay-Call-ID: dc2c5b33-1b81-43ee-9213-afb56f4e56ba Remote-Party-ID:  [email protected] >;party=calling;screen=yes;privacy=off Content-Type: application/sdp Content-Length: 2427
                                                                                                                                                                                                                      <BSUID_OR_PHONE_NUMBER>— Будет представлять собой BSUID пользователя или родительский BSUID, если звонок был совершен на BSUID пользователя или родительский BSUID, или номер телефона пользователя, если звонок был совершен на его номер телефона.
                                                                                                                                                                                                                      SIP-приглашения для инициированных пользователем вызовов
                                                                                                                                                                                                                      These changes apply to user-initiated calls made using SIP.
                                                                                                                                                                                                                      INVITE sip: [email protected] ;transport=tls SIP/2.0 Via: SIP/2.0/TLS [2803:6080:e888:51aa:d4a4:c5e0:300:0]:33819;rport=33819;received=2803:6080:e888:51aa:d4a4:c5e0:300:0;branch=z9hG4bKPjNvs.IZBnUa1W4l8oHPpk3SUMmcx3MMcE;alias Max-Forwards: 70 От: " "  @wa.meta.vc>;tag=bbf1ad6e-79bb-4d9c-8a2c-094168a10bea К:  [email protected] > Контакт:  @wa.meta.vc;transport=tls;ob>;isfocus Идентификатор вызова: исходящий:wacid.HBgLMTIxOTU1NTA3MTQVAgASGCAzODg1NTE5NEU1NTBEMTc1RTFFQUY5NjNCQ0FCRkEzRhwYCzE3MDE1NTU4ODU3FQIAAA== CSeq: 2824 Маршрут приглашения: X-FB-External-Domain: wa.meta.vc x-wa-meta-user-id: x-wa_meta-parent-user-id: x-wa-meta-user-name: Разрешить: INVITE, ACK, BYE, CANCEL, NOTIFY, OPTIONS User-Agent: Facebook SipGateway Content-Type: application/sdp Content-Length: 1028
                                                                                                                                                                                                                        <BSUID> — Will be set to the user’s BSUID.<BSUID_OR_PHONE_NUMBER> — Will be the user’s BSUID or parent BSUID if the call was made to the user’s BSUID or parent BSUID, or if the user has adopted a username and we are unable to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be the user’s phone number.<PARENT_BSUID> — Will be set to the user’s parent BSUID, if you enabled parent BSUIDs. Otherwise, it will be omitted.<USERNAME> — Will be the user’s username, if the user has enabled the usernames feature. Otherwise, it will be omitted.
                                                                                                                                                                                                                        SIP OK-ответы для звонков, инициированных бизнес-процессом
                                                                                                                                                                                                                        SIP/2.0 200 OK Via: SIP/2.0/TLS 54.172.60.1:5061;received=2803:6080:f934:8894:7eb5:24f9:300:0;branch=z9hG4bK1e5a.0da2ace9cc912d9e5f2595ca4acb9847.0 Via: SIP/2.0/UDP 172.25.10.217:5060;rport=5060;branch=z9hG4bK5cdada8c-cbf0-4369-b02d-cc97d3c36f2b_c3356d0b_54-457463274351249162 Record-Route: Маршрутизация записей: Маршрутизация записей: Маршрутизация записей: Идентификатор вызова: [email protected] От: " "  @meta-voip.example.com>;tag=28460006_c3356d0b_5cdada8c-cbf0-4369-b02d-cc97d3c36f2b К:  [email protected] >;tag=0d185053-2615-46c7-8ff2-250bda494cf1 CSeq: 2 INVITE Allow: INVITE, ACK, BYE, CANCEL, NOTIFY, OPTIONS Supported: timer X-FB-External-Domain: wa.meta.vc  @wa.meta.vc;transport=tls;ob;X-FB-Sip-Smc-Tier=collaboration.sip_gateway.sip.prod>;isfocus x-wa-meta-user-id: x-wa_meta-parent-user-id: x-wa-meta-user-name: Content-Type: application/sdp Content-Length: 645
                                                                                                                                                                                                                          <BSUID> — Will be set to the user’s BSUID.<BSUID_OR_PHONE_NUMBER> — Will be the user’s BSUID or parent BSUID if the call was made to the user’s BSUID or parent BSUID, or if the user has adopted a username and we are unable to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be the user’s phone number.<PARENT_BSUID> — Will be set to the user’s parent BSUID, if you enabled parent BSUIDs. Otherwise, it will be omitted.<USERNAME> — Will be set to the user’s username, if the user has enabled the usernames feature. Otherwise, it will be omitted.
                                                                                                                                                                                                                          SIP BYE-ответы для вызовов, инициированных как компанией, так и пользователем
                                                                                                                                                                                                                          BYE sip: [email protected] :5061;transport=tls SIP/2.0 Via: SIP/2.0/TLS [2803:6080:e800:6746::]:56843;rport;branch=z9hG4bKPj65946b3e6f68128d52b6a498a8fd00a5;alias Record-Route: Маршрутизация записей: Via: SIP/2.0/TLS [2803:6080:e800:6746:3347:2251:14a4:a00]:5061;branch=z9hG4bKPj65946b3e6f68128d52b6a498a8fd00a5 Via: SIP/2.0/TLS [2803:6080:e934:3f82:b543:8a4d:1414:a00]:52767;rport=52767;received=2803:6080:e934:3f82:b543:8a4d:1414:a00;branch=z9hG4bKPj-D8BXdIVMqAUT9MIJIp78LxKUZNnjYKF;alias Max-Forwards: 69 От:  @wa.meta.vc>;tag=0fb8b5f1-2703-49f4-a454-46b1bcb9bfac К:  [email protected] >;tag=2c21fad0-c581-4e54-a707-3bd52abfcc3f Call-ID: 21e38222-6fcb-4631-8e7d-5b94cf849c90 CSeq: 31641 BYE x-wa-meta-user-id: x-wa_meta-parent-user-id: x-wa-meta-user-name: X-FB-External-Domain: wa.meta.vc Allow: INVITE, ACK, BYE, CANCEL, NOTIFY, OPTIONS User-Agent: Facebook SipGateway Content-Length: 0
                                                                                                                                                                                                                            <BSUID> — Will be set to the user’s BSUID.<BSUID_OR_PHONE_NUMBER> — Will be the user’s BSUID or parent BSUID if the call was made to the user’s BSUID or parent BSUID, or if the user has adopted a username and we are unable to include their phone number based on the conditions described in the Номера телефонов section. Otherwise, it will be the user’s phone number.<PARENT_BSUID> — Will be set to the user’s parent BSUID, if you enabled parent BSUIDs. Otherwise, it will be omitted.<USERNAME> — Will be set to the user’s username, if the user has enabled the usernames feature. Otherwise, it will be omitted.
                                                                                                                                                                                                                            Сосуществование
                                                                                                                                                                                                                            

                                                                                                                                                                                                                            

                                                                                                                                                                                                                            

                                                                                                                                                                                                                            

                                                                                                                                                                                                                            История веб-хуков
                                                                                                                                                                                                                            

                                                                                                                                                                                                                            Эти изменения коснутся  истории , описывающих историю чатов в приложении WhatsApp Business для зарегистрированных бизнес-клиентов.
                                                                                                                                                                                                                            

                                                                                                                                                                                                                            

                                                                                                                                                                                                                            {
                                                                                                                                                                                                                            
"object": "whatsapp_business_account", "entry": [ { "id": "<CUSTOMER_WABA_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<CUSTOMER_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<CUSTOMER_PHONE_NUMBER_ID>" }, "history": [ { "metadata": { "phase": <PHASE>, "chunk_order": <CHUNK_ORDER>, "progress": <PROGRESS> }, "threads": [ /* First chat history thread object */ { "id": "<WHATSAPP_USER_PHONE_NUMBER>", <!-- CHANGED --> "context": { <!-- ADDED --> "wa_id": "<WHATSAPP_USER_PHONE_NUMBER>", <!-- ADDED --> "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled before sync request --> "parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> <!-- Only included if user has enabled usernames feature before sync request --> "username": "<USERNAME>" <!-- ADDED --> }, "messages": [ /* First message object in thread */ { "from": "<BUSINESS_OR_WHATSAPP_USER_PHONE_NUMBER>", <!-- CHANGED --> "from_user_id" : "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled before sync request --> "from_parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> "to": "<WHATSAPP_USER_PHONE_NUMBER>", "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<DEVICE_TIMESTAMP>, "type": "<MESSAGE_TYPE>", "<MESSAGE_TYPE>": { <MESSAGE_CONTENTS> }, "history_context": { "status": "<MESSAGE_STATUS>" } }, /* Additional message objects in thread would follow, if any */ ] }, /* Additional chat history thread objects would follow, if any */ ] } ] }, "field": "history" } ] } ] }
                                                                                                                                                                                                                              id — Новое поведение (может быть опущено). Будет опущено, если на момент запроса на синхронизацию истории у пользователя уже включена возможность добавления имен пользователей, и мы не можем включить его номер телефона в соответствии с условиями, описанными в разделе « Номера телефонов» . В противном случае будет установлен номер телефона пользователя.контекст — Новый объект контекста.

                                                                                                                                                                                                                                wa_id — Новое свойство.

                                                                                                                                                                                                                                  Этот параметр будет пропущен, если на момент запроса на синхронизацию у пользователя уже включена функция имен пользователей, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» . В противном случае он будет установлен на номер телефона пользователя.user_id — Новое свойство. Будет установлено значение BSUID пользователя.parent_user_id  равное родительскому BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.Имя пользователя — Новое свойство.

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

                                                                                                                                                                                                                                      из — Новое поведение (можно опустить).

                                                                                                                                                                                                                                        Этот параметр будет пропущен, если на момент запроса на синхронизацию у пользователя уже включена функция имен пользователей, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» . В противном случае он будет установлен на номер телефона пользователя.from_user_id — Новое свойство. Будет установлено значение BSUID пользователя.from_parent_user_id  равное родительскому BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.

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

                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                        {
                                                                                                                                                                                                                                        
"object": "whatsapp_business_account", "entry": [ { "id": "<CUSTOMER_WABA_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<CUSTOMER_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<CUSTOMER_PHONE_NUMBER_ID>" }, "contacts": [ <!-- ADDED --> { <!-- Profile only included if user has enabled the usernames feature --> "profile": { "username": "<USERNAME>", <!-- ADDED --> }, "wa_id": "<WHATSAPP_USER_PHONE_NUMBER>", <!-- ADDED --> "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID>" <!-- ADDED --> }, ], <!-- Only for messages sent from a user to a business --> "messages": [ { "from": "<WHATSAPP_USER_PHONE_NUMBER>", <!-- CHANGED --> "from_user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "from_parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<ORIGINAL_WEBHOOK_TRIGGER_TIMESTAMP>", "type": "<MEDIA_TYPE>", "<MEDIA_TYPE>": { <MEDIA_METADATA> } } ], <!-- Only for messages sent from a business to a user --> "message_echoes": [ { "from": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "to": "<WHATSAPP_USER_PHONE_NUMBER>", <!-- CHANGED --> "to_user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "to_parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "type": "<MESSAGE_TYPE>", "<MESSAGE_TYPE>": { <MESSAGE_CONTENTS> } } ] }, "field": "history" } ] } ] }
                                                                                                                                                                                                                                          Контакты — Новый объект.

                                                                                                                                                                                                                                            профиль

                                                                                                                                                                                                                                              username — Новое свойство. Будет установлено значение имени пользователя, если функция имени пользователя включена. В противном случае оно будет опущено.wa_id — Новое свойство.

                                                                                                                                                                                                                                                Этот параметр будет пропущен, если на момент запроса на синхронизацию у пользователя уже включена функция имен пользователей, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» . В противном случае он будет установлен на номер телефона пользователя.user_id — Новое свойство. Будет установлено значение BSUID пользователя.parent_user_id  равное родительскому BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.сообщения

                                                                                                                                                                                                                                                  из — Новое поведение (можно опустить).

                                                                                                                                                                                                                                                    Этот параметр будет пропущен, если на момент запроса на синхронизацию у пользователя уже включена функция имен пользователей, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» . В противном случае он будет установлен на номер телефона пользователя.from_user_id — Новое свойство. Будет установлено значение BSUID пользователя.from_parent_user_id  равное родительскому BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.message_echoes

                                                                                                                                                                                                                                                      — Новое поведение (можно опустить).

                                                                                                                                                                                                                                                        Этот параметр будет пропущен, если на момент запроса на синхронизацию у пользователя уже включена функция имен пользователей, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» . В противном случае он будет установлен на номер телефона пользователя.to_user_id — Новое свойство. Будет установлено значение BSUID пользователя.to_parent_user_id  равное родительскому BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.

                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                        smb_message_echoes webhooks
                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                        Эти изменения будут применяться к  smb_message_echoes .
                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                        {
                                                                                                                                                                                                                                                        
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "contacts": [ <!-- ADDED --> { <!-- Only included if user has enabled the usernames feature --> "profile": { "username": "<USERNAME>" <!-- ADDED --> }, "wa_id": "<WHATSAPP_USER_PHONE_NUMBER>", <!-- ADDED --> "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID>" <!-- ADDED --> } ], "message_echoes": [ { "from": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "to": "<WHATSAPP_USER_PHONE_NUMBER>", <!-- CHANGED --> "to_user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "to_parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "type": "<MESSAGE_TYPE>", "<MESSAGE_TYPE>": { <MESSAGE_CONTENTS> } } ] }, "field": "smb_message_echoes" } ] } ] }
                                                                                                                                                                                                                                                          Контакты — Новый массив.

                                                                                                                                                                                                                                                            профиль

                                                                                                                                                                                                                                                              username — Новое свойство. Будет установлено значение имени пользователя, если функция имени пользователя включена. В противном случае оно будет опущено.wa_id — Новое свойство. Будет опущено, если на момент использования бизнес-клиентом приложения WhatsApp Business для отправки сообщения пользователю, у пользователя уже была включена функция добавления имен пользователей, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» . В противном случае будет установлен номер телефона пользователя.user_id — Новое свойство. Будет установлено значение BSUID пользователя.parent_user_id  равное родительскому BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.message_echoes

                                                                                                                                                                                                                                                                — Новое поведение (может быть опущено). Будет опущено, если в момент использования бизнес-клиентом приложения WhatsApp Business для отправки сообщения пользователю, у пользователя уже была включена функция имен пользователей, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» . В противном случае будет установлен номер телефона пользователя.to_user_id — Новое свойство. Будет установлено значение BSUID пользователя.to_parent_user_id  равное родительскому BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.

                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                smb_app_state_sync webhooks
                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                Эти изменения будут применяться к  smb_app_state_sync .
                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                {
                                                                                                                                                                                                                                                                
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "state_sync": [ { "type": "contact", "contact": { "full_name": "<CONTACT_FULL_NAME>", "first_name": "<CONTACT_FIRST_NAME>", "phone_number": "<CONTACT_PHONE_NUMBER>", <!-- CHANGED --> "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID>", <!-- ADDED --> <!-- Only included if user has enabled the usernames feature --> "username": "<USERNAME>" <!-- ADDED --> }, "action": "<ACTION>", "metadata": { "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>" } }, <!-- Additional contacts would follow, if any --> ] }, "field": "smb_app_state_sync" } ] } ] }
                                                                                                                                                                                                                                                                  phone_number — Новое поведение (можно опустить). Будет опущено, если на момент запроса на синхронизацию у пользователя уже включена возможность использования имен пользователей, и мы не можем включить его номер телефона в соответствии с условиями, описанными в  Номера телефонов» . В противном случае будет установлен номер телефона пользователя.user_id — Новое свойство. Будет установлено значение BSUID пользователя.parent_user_id  равное родительскому BSUID пользователя , если вы включили родительские BSUID. В противном случае оно будет опущено.username — Новое свойство. Будет установлено значение имени пользователя, если функция имени пользователя включена. В противном случае оно будет опущено.

                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                  Отзыв сообщений через веб-хуки
                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                  Эти изменения будут применяться к  отзыва сообщений .
                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                  {
                                                                                                                                                                                                                                                                  
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "contacts": [ { "profile": { "name": "<WHATSAPP_USER_PROFILE_NAME>", <!-- Only included if user has enabled the usernames feature --> "username": "<USERNAME>" <!-- ADDED --> }, "wa_id": "<WHATSAPP_USER_ID>", "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID>" <!-- ADDED --> } ], "messages": [ { "from": "<WHATSAPP_USER_PHONE_NUMBER>", "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "type": "revoke", "revoke": { "original_message_id": "<ORIGINAL_WHATSAPP_MESSAGE_ID>" } } ] }, "field": "messages" } ] } ] }
                                                                                                                                                                                                                                                                    контакты

                                                                                                                                                                                                                                                                      профиль

                                                                                                                                                                                                                                                                        username — Новое свойство. Будет установлено значение имени пользователя, если функция имени пользователя включена. В противном случае оно будет опущено.user_id — Новое свойство. Будет установлено значение BSUID пользователя.parent_user_id  родительскому BSUID пользователя . В противном случае оно будет опущено.

                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                        Веб-хуки для редактирования сообщений
                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                        Эти изменения будут применяться к  редактирования сообщений .
                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                        {
                                                                                                                                                                                                                                                                        
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "contacts": [ { "profile": { "name": "<WHATSAPP_USER_PROFILE_NAME>", <!-- Only included if the user has enabled usernames --> "username": "<USERNAME>" <!-- ADDED --> }, "wa_id": "<WHATSAPP_USER_ID>", <!-- CHANGED --> "user_id": "<BSUID>", <!-- ADDED --> <!-- Only included if parent BSUIDs enabled --> "parent_user_id": "<PARENT_BSUID>" <!-- ADDED --> } ], "messages": [ { "from": "<WHATSAPP_USER_PHONE_NUMBER>", "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "type": "edit", "edit": { "original_message_id": "<ORIGINAL_WHATSAPP_MESSAGE_ID>", "message": { "context": { "id": "<CONTEXT_ID>" }, "type": "image", "image": { "caption": "<MEDIA_ASSET_CAPTION>", "mime_type": "<MEDIA_ASSET_MIME_TYPE>", "sha256": "<MEDIA_ASSET_SHA256_HASH>", "id": "<MEDIA_ASSET_ID>", "url": "<MEDIA_ASSET_URL>" } } } } ] }, "field": "messages" } ] } ] }
                                                                                                                                                                                                                                                                          контакты

                                                                                                                                                                                                                                                                            профиль

                                                                                                                                                                                                                                                                              username — Новое свойство. Будет установлено значение имени пользователя, если функция имени пользователя включена. В противном случае оно будет опущено.wa_id — Новое свойство. Будет опущено, если на момент редактирования сообщения пользователем WhatsApp функция добавления имен пользователей уже включена, и номер телефона не может быть указан в соответствии с условиями, описанными в  Номера телефонов» . В противном случае оно будет опущено.user_id — Новое свойство. Будет установлено значение BSUID пользователя.parent_user_id  родительскому BSUID пользователя . В противном случае оно будет опущено.

                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              Аналитика
                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              Без изменений.
                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              Выставление счетов и формирование инвойсов
                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              Без изменений.
                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              Часто задаваемые вопросы
                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              Что мне нужно сделать, чтобы добавить поддержку имен пользователей?
                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                              Идентификаторы BSUID и родительские BSUID начнут появляться в полезных нагрузках веб-хуков в марте 2026 года, до того, как имена пользователей станут доступны пользователям WhatsApp. Для обработки сообщений от пользователей, которые включат эту функцию после ее появления, вам потребуется поддерживать BSUID (и родительские BSUID, если вы их включите). Для этого необходимо:
                                                                                                                                                                                                                                                                              

                                                                                                                                                                                                                                                                                Обновите интеграцию веб-хуков, чтобы она поддерживала BSUID (и родительский BSUID , если он используется).Разработайте логику для обработки нескольких идентификаторов (номера телефонов пользователей, не использующих имя пользователя; BSUID пользователей, использующих имя пользователя, если номер телефона отсутствует в веб-хуках), и сопоставьте соответствующие поля с вашей CRM/базой данных.Обновите внутренние и внешние системы, связанные с этими интеграциями, чтобы они могли обрабатывать BSUID и объединяться с предыдущими идентификаторами; в первую очередь, это CRM (как сторонние, так и внутренние базы данных) и любые инструменты или рабочие процессы, запускаемые на основе CRM (например, сообщения, запускаемые в рамках кампаний, управление кампаниями, измерение результатов, выставление счетов и т. д.).Если вам по-прежнему требуются номера телефонов клиентов, обновите своих мессенджеров/сценарии взаимодействия (если они используются), чтобы они запрашивали номера телефонов, обрабатывали сценарии, когда пользователи не сообщают свои номера телефонов, и совершенствуйте эти новые сценарии общения. Общие ограничения в сценариях использования ИИ см . в Условиях использования решения WhatsApp Business .Если у вас несколько бизнес-портфелей в Meta, вам может потребоваться внедрить решение для обеспечения централизованного доступа к CRM для всех этих портфелей, чтобы минимизировать операционные издержки, связанные с использованием и хранением BSUID (и родительских BSUID).

                                                                                                                                                                                                                                                                                Когда я получу BSUID или родительский BSUID, а не номер телефона?
                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                Когда пользователь присваивает себе имя пользователя, обеспечивается конфиденциальность его номера телефона, то есть его номер телефона не будет отображаться в приложении и не будет включаться в веб-хуки. Если номер телефона пользователя отсутствует (отсутствует свойство wa_id), можно использовать его BSUID (или родительский BSUID , если используется), который будет включен и присвоен новому свойству user_id ( parent_user_id для родительских BSUID).
                                                                                                                                                                                                                                                                                

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

                                                                                                                                                                                                                                                                                Обратите внимание, что мы продолжим передавать номер телефона при соблюдении определенных условий . Однако, согласно нашим Условиям использования облачного API, номера телефонов и связанные с ними данные хранятся максимум 30 дней для поддержки таких функций, как повторная доставка сообщений. Могут возникнуть ситуации, когда вы будете получать сообщения от существующих пользователей за пределами этого 30-дневного периода, которые могут выглядеть для вас как сообщения от нового пользователя. Поэтому крайне важно как можно скорее начать поддержку BSUID, чтобы свести к минимуму потерю контекста разговора.
                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                Почему партнерам и компаниям, напрямую интегрированным с Cloud API и использующим его, включая рекламные объявления, ведущие к рекламодателям WhatsApp, необходимо внедрять BSUID?
                                                                                                                                                                                                                                                                                

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

                                                                                                                                                                                                                                                                                Если я ещё не использую BSUID и начинаю получать сообщения от пользователей, использующих эти имена, которые я не могу обработать, есть ли какие-либо варианты решения проблемы?
                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                Если вы еще не внедрили BSUID и не можете обрабатывать сообщения от пользователей, использующих это имя, у вас не будет никаких возможностей для исправления ситуации.
                                                                                                                                                                                                                                                                                

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

                                                                                                                                                                                                                                                                                После добавления поддержки BSUID, запрашивайте номера телефонов у пользователей, реализовав кнопку запроса номера телефона .
                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                Чем отличаются корпоративные имена пользователей от отображаемых имен? В каких случаях пользователь увидит корпоративное имя пользователя, а в каких — отображаемое имя?
                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                Имена пользователей для компаний позволят пользователям связываться с компанией по её имени пользователя, то есть конечный пользователь сможет найти компанию, используя своё точное имя пользователя, и связаться с ней. Поскольку конечные пользователи не могут осуществлять поиск по отображаемым именам, имена пользователей для компаний предоставляют явное преимущество в качестве уникального идентификатора, позволяющего пользователям надёжно находить нужную компанию.
                                                                                                                                                                                                                                                                                

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

                                                                                                                                                                                                                                                                                Имена пользователей для бизнеса уникальны и привязаны один к одному к номерам телефонов, то есть @JaspersMarket будет привязан к одному номеру телефона, а @JaspersMarketCustomerSupport — к другому. Отображаемые имена не привязаны один к одному к номерам телефонов, то есть под отображаемым именем Jasper's Market может быть 10 номеров телефонов.
                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                Когда у компании есть и имя пользователя, и отображаемое имя, отображаемое имя будет отображаться первым (например, в профиле, списке чатов, сообщениях и т. д.), чтобы компания могла завоевать доверие пользователей, а пользователи могли узнать компанию, когда она свяжется с ними.
                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                Журнал изменений документа
                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                31 марта 2026 г
                                                                                                                                                                                                                                                                                

                                                                                                                                                                                                                                                                                  Обновлена ​​дата внедрения веб-перехватчика BSUID: с 31 марта на начало апреля 2026 года.Обновлены  контактной книги : теперь компании, использующие локальное хранилище, автоматически извлекают номера телефонов из общих vCard-файлов и сохраняют их в контактной книге в центрах обработки данных Meta.Обновлена ​​процедура запроса телефонных номеров у пользователей : удалено исключение для локального хранилища, требующее ручной отправки сообщения; заменено автоматическим извлечением телефонных номеров из vCard.Обновлены  по тестированию веб-хуков , исправлен путь навигации в панели управления приложения. Принять или изменить имя пользователя для компании» добавлено предупреждение о доступности .

                                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                                  23 марта 2026 г
                                                                                                                                                                                                                                                                                  

                                                                                                                                                                                                                                                                                    Исправлены  user_id в ответах на сообщения и маркетинговые сообщения : если запрос содержит как номер телефона, так и BSUID или родительский BSUID, ответ не будет содержать user_id , поскольку номер телефона имеет приоритет, и ответ идентичен запросу только с номером телефона. Соответственно обновлен пример ответа для случая с номером телефона и BSUID.

                                                                                                                                                                                                                                                                                    

                                                                                                                                                                                                                                                                                    

                                                                                                                                                                                                                                                                                    

                                                                                                                                                                                                                                                                                    18 марта 2026 г
                                                                                                                                                                                                                                                                                    

                                                                                                                                                                                                                                                                                      Добавлены  быстрого доступа к идентификаторам веб-хуков, содержащие сводную информацию о том, какие идентификаторы встречаются в сообщениях веб-хуков.Добавлен  тестирования веб-хуков, описывающий тестовые сценарии, доступные на панели управления приложения.Добавлен  веб-хуков user_id_update .В раздел «API блокировки пользователей» добавлены  заблокированных пользователях Добавлено  родительского BSUID и обновлены примеры полезных нагрузок для использования  ENT (например, US.ENT.11815799212886844830 ).Добавлена ​​информация о доступности кнопки запроса контактных данных (начало мая 2026 г.).Уточнено, что контактная книга предоставляется и размещается компанией Meta без необходимости интеграции, имеет ограниченный охват на уровне бизнес-портфеля и хранит только те взаимодействия, которые произошли после запуска.Уточнено, что к именам пользователей применяются те же ограничения по формату, что и к именам пользователей в компаниях .Уточнено, что символы, отличные от английских (например, ñ, é, ü), не поддерживаются в бизнес-именах пользователей .Уточнено, что условия 30-дневного ретроспективного анализа в  Номера телефонов» оцениваются для каждого номера телефона компании.Удалена фраза «Вы находитесь в списке контактов пользователя в WhatsApp» из условий включения номера телефона .

                                                                                                                                                                                                                                                                                      

                                                                                                                                                                                                                                                                                      

                                                                                                                                                                                                                                                                                      

                                                                                                                                                                                                                                                                                      18 февраля 2026 г
                                                                                                                                                                                                                                                                                      

                                                                                                                                                                                                                                                                                        Уточнено, что API-запросы, принимающие как номер телефона, так и BSUID или родительский BSUID, могут одновременно содержать оба идентификатора, при этом номер телефона имеет приоритет. Обновлены запросы на отправку сообщений , запросы на отправку маркетинговых сообщений , запросы на звонки, инициированные компанией , и запросы на блокировку или разблокировку пользователей .

                                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                                        6 февраля 2026 г
                                                                                                                                                                                                                                                                                        

                                                                                                                                                                                                                                                                                          Изменено количество буквенно-цифровых символов, составляющих BSUID, с 256 до 128.Изменен способ использования BSUID для отправки сообщений; теперь BSUID необходимо присваивать отдельным свойствам/полям в запросах на отправку сообщений (вместо существующих свойств/полей, поддерживающих как BSUID, так и номера телефонов).Изменен способ отображения кодов стран Добавлена  о родительском BSUID , которую можно использовать во всех связанных бизнес-портфелях.Добавлена  из контактной книги , которая может автоматически сохранять номера телефонов пользователей и BSUID.Добавлена ​​информация о кнопке запроса номера телефона Изменены примеры синтаксиса, примеры полезной нагрузки и описания для всех веб-хуков, которые возвращали пустые строки в случаях, когда пользователь включил функцию имен пользователей. Теперь этим свойствам не будет присваиваться пустая строка. Вместо этого они будут опущены (например,  wa_id в веб-хуках входящих сообщений).Изменен способ отображения ошибок при попытке принять или изменить имя пользователя компании .Изменен синтаксис ответа для получения текущего имени пользователя компании .Удалена возможность отмены ожидающих запросов на присвоение имени пользователя для корпоративных пользователей.Изменен веб-перехватчик phone_number_username_update на  business_username_updates .
    
                                                                                                                                                                                                                                                                                                  
                                                                                                                                                                                                                                                                                          
    
                                                                                                                                                                                                                                                                                          

            
                                                                                                                                                                                                                                                                                          
        
                                                                                                                                                                                                                                                                                          
    
                                                                                                                                                                                                                                                                                          

    
                                                                                                                                                                                                                                                                                          

    
    
                                                                                                                                                                                                                                                                                          
        
                                                                                                                                                                                                                                                                                          
             Вернуться наверх