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

Отображаемые имена | Документация для разработчиков

Отображаемые имена

Обновлено: 24 марта 2026 г
При указании имени пользователя необходимо указать отображаемое имя регистрация Рабочий телефонный номер. Отображаемое имя отображается в вашем рабочем телефонном номере число'число'Профиль WhatsApp:
В профиле WhatsApp для бизнеса отображается имя пользователя
Оно также может отображаться вверху отдельных чатов и списка чатов , если ваш рабочий номер телефона одобрен с помощью подтверждения отображаемого имени . Обратите внимание, что если пользователь WhatsApp изменит ваше имя профиля в клиенте WhatsApp, вместо него будет отображаться имя, которое он установил.

Рекомендации по отображению имен

Посмотрите наши Рекомендации по отображаемым именам для платформы WhatsApp Business⁠? Статья в Справочном центре с рекомендациями по именованию.

Проверка отображаемого имени

Когда вы достигнете более высокий лимит сообщенийваш рабочий телефон число'число'Отображаемое имя автоматически проходит проверку на основе рекомендации по отображению имен⁠?Когда процесс завершится, номер_имя_телефона_обновление Срабатывают веб-перехватчик и уведомление Meta Business Suite.
Если ваше отображаемое имя одобрено, веб-перехватчик получает значение « Одобрено» , а name_status в вашем рабочем номере телефона также получает значение «Одобрено» .
Если ваше отображаемое имя отклонено, веб-хук.. решение установить на ОТКЛОНЕННЫЙи name_status Поле в вашем рабочем номере телефона установлено на ОТКЛОНЕННЫЙ. Просмотрите рекомендации по отображению имен⁠? и изменить отображаемое имя⁠? соответственно, или подать апелляцию через Поддержка разработчиков или Поддержка корпоративных разработчиков.

Просмотреть отображаемое имя в Менеджере WhatsApp

Ваш рабочий телефон число'число'Отображаемое имя отображается в Имя колонка в Менеджер WhatsApp⁠? > Инструменты учетной записи > Номера телефонов панель.

Получать Отображение имени и статуса отображаемого имени через API

Запросить проверенное_имя и name_status В поле «Имя пользователя» в вашем идентификаторе бизнес-телефона WhatsApp вы можете узнать его отображаемое имя и статус отображаемого имени. См ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> Для получения списка возвращаемых значений и их значений используйте справочный материал.
Он проверенное_имя Значение не указывает, одобрено ли отображаемое имя. Оно представляет собой строку отображаемого имени, которая проходит проверку, если соответствует требованиям name_status В этом поле указан статус его утверждения.

Пример запроса

curl 'https://graph.facebook.com/v25.0/106540352242922?fields=verified_name%2Cname_status' \ -H 'Авторизация: Bearer EAAJB...'

Пример ответа

В случае успеха:
{ "verified_name": "Lucky Shrub", "name_status": "APPROVED", "id": "106540352242922" }
Обновить отображаемые имена
Вы можете изменить отображаемое имя 10 раз в течение 30-дневного периода. После утверждения изменения отображаемого имени у вас есть 14 дней, чтобы изменить его перерегистрируйте номер телефонаЕсли 14-дневный срок истечет без повторной регистрации, вам необходимо будет снова отправить отображаемое имя на проверку.
Примечание: Если в вашем рабочем телефонном номере есть Официальный бизнес-аккаунт статус, контакт прямая поддержка Чтобы изменить отображаемое имя.
Изменить отображаемое имя через WhatsApp Manager
Чтобы изменить отображаемое имя через WhatsApp Manager:
    Перейти к Менеджер WhatsApp⁠ > Инструменты учетной записи > Номера телефонов.Выберите номер телефона вашей компании.Нажмите Профиль вкладка.В Отображаемое имя в этом разделе нажмите Редактировать Нажмите кнопку и завершите процесс.
    После завершения процесса ваше отображаемое имя будет обработано проверка отображаемого имени Ещё раз. После утверждения отображаемого имени вы должны перерегистрируйте номер телефонаПовторная регистрация до получения одобрения не имеет никакого эффекта.
    Эта информация также доступна в нашем Как изменить отображаемое имя в WhatsApp Business⁠ Статья из Справочного центра.
    Обновление отображаемого имени через API
    Используйте ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> конечных точек новое_отображаемое_имя поле для обновления отображаемого имени через API.
    Пример запроса
    curl -X POST 'https://graph.facebook.com/v25.0/106540352242922?new_display_name=Lucky%20Shrub' \ -H 'Авторизация: Bearer EAAJB...'

    Пример ответа
    В случае успеха:
    { "success": true }
    В случае успеха ваше отображаемое имя будет изменено проверка отображаемого имениДля проверки статуса подтверждения запросите.. новое_отображаемое_имя и новый_имя_статус поля в идентификаторе номера вашего рабочего телефона:
    Пример запроса
    curl 'https://graph.facebook.com/v25.0/106540352242922?fields=new_display_name,new_name_status' \ -H 'Авторизация: Bearer EAAJB...'

    Пример ответа
    В случае успеха:
    { "new_display_name": "Новый счастливый кустарник", "new_name_status": "ОЖИДАЕТСЯ ПРОВЕРКА", "id": "106540352242922" }
    После утверждения обновленного отображаемого имени, номер телефона вашей компании также будет обновлен проверенное_имя и name_status Поля обновляются, чтобы отразить ваше новое отображаемое имя и статус имени, и номер_имя_телефона_обновление Веб-хуки срабатывают. Затем вы должны перерегистрируйте номер телефонаПовторная регистрация до получения одобрения не имеет никакого эффекта.
    Повторная регистрация после подтверждения отображаемого имени
    После обновления отображаемого имени через Менеджер WhatsApp или APIДля подтверждения нового отображаемого имени на серверах WhatsApp вам необходимо повторно зарегистрировать свой номер телефона.
      Дождитесь номер_имя_телефона_обновление веб-хук с решение установить на ОДОБРЕННЫЙ.Вызов ПОЧТА /<PHONE_NUMBER_ID> /register для повторной регистрации номера телефона. См Зарегистрируйте номер телефона для бизнеса Для получения подробной информации о конечной точке.
      Важный: Дождитесь подтверждения изменения отображаемого имени, прежде чем перерегистрироваться. Перерегистрация до подтверждения не даст никаких результатов.
      Вы можете повторно зарегистрироваться программно через API нет необходимо отправить бизнес Встроенная регистрация снова.
      Пример запроса
      curl 'https://graph.facebook.com/v25.0/106540352242922/register' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "pin": "212834" }'

      Пример ответа
      В случае успеха:
      { "success": true }
      Узнать больше
      

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

        О отображаемом имени в WhatsApp Business⁠?Как изменить отображаемое имя в WhatsApp Business⁠?
        
    
                
        
    
        

            
        
        
        
    
        

    
        

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