Отображаемые имена | Документация для разработчиков
Отображаемые имена
Обновлено: 24 марта 2026 г
регистрации рабочего телефонного номера необходимо указать отображаемое имя
Оно также может отображаться вверху отдельных чатов и списка чатов , если ваш рабочий номер телефона одобрен с помощью подтверждения отображаемого имени . Обратите внимание, что если пользователь WhatsApp изменит ваше имя профиля в клиенте WhatsApp, вместо него будет отображаться имя, которое он установил.
Рекомендации по отображению имен
Ознакомьтесь с рекомендациями по именованию отображаемых имен для платформы WhatsApp Business в статье Справочного центра.
Проверка отображаемого имени
При достижении лимита сообщений отображаемое имя вашего рабочего номера телефона автоматически проходит проверку в соответствии с правилами отображения имен . После завершения процесса запускается веб-перехватчик phone_number_name_update
Если ваше отображаемое имя одобрено, веб-перехватчик получает значение
« Одобрено» , а name_status в вашем рабочем номере телефона также получает значение «Одобрено» .Если ваше отображаемое имя отклонено, веб-перехватчик получает значение
« ОТКЛОНЕНО» , а name_status в вашем рабочем номере телефона устанавливается в значение «ОТКЛОНЕНО» . Ознакомьтесь с рекомендациями по отображаемым именам и отредактируйте свое отображаемое имя соответствующим образом или подайте апелляцию через службу поддержки разработчиков или службу поддержки корпоративных разработчиков .Просмотреть отображаемое имя в Менеджере WhatsApp
Отображаемое имя вашего рабочего номера телефона отображается в «Имя» в меню «Менеджер WhatsApp» > «Инструменты учетной записи» > « Номера телефонов» .
Получение отображаемого имени и статуса отображаемого имени через API
Запросите
verified_name и name_status в идентификаторе вашего бизнес-телефона WhatsApp, чтобы получить отображаемое имя и статус отображаемого имени. См. GET / verified_name
, одобрено ли отображаемое имя. Оно представляет собой строку отображаемого имени, которая проходит проверку, если соответствует требованиям. 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 Business» в
Обновление отображаемого имени через API
Используйте POST /
new_display_name конечной точки используется для обновления отображаемого имени через API.Пример запроса
curl -X POST 'https://graph.facebook.com/v25.0/106540352242922?new_display_name=Lucky%20Shrub' \ -H 'Авторизация: Bearer EAAJB...'
Пример ответа
В случае успеха:
{ "success": true }В случае успешной проверки ваше отображаемое имя будет подвергнуто верификации . Чтобы проверить статус верификации, запросите
new_display_name и new_name_status в идентификаторе вашего рабочего телефонного номера:Пример запроса
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" }После утверждения обновленного отображаемого имени
verified_name и name_status обновляются, отражая новое отображаемое имя и статус имени, и phone_number_name_update . Затем необходимо повторно зарегистрировать номер телефона . Повторная регистрация до утверждения не имеет никакого эффекта.Повторная регистрация после подтверждения отображаемого имени
После обновления отображаемого имени через WhatsApp Manager или API вам необходимо повторно зарегистрировать свой номер телефона, чтобы закрепить новое отображаемое имя на серверах WhatsApp.
решением установленным на APPROVED .Позвоните на почту / Для повторной регистрации номера телефона используйте команду /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 }Узнать больше
В следующих статьях Справочного центра представлена дополнительная информация об отображаемых именах.