phone_number_name_update webhook reference | Developer Documentation
Check the result of a WhatsApp display name review
After adding a business number or submitting a different display name, check the review result for that exact number. Use this guide when a name decision arrives, a review remains pending or the customer still sees a different name. The display-name guide explains choosing and submitting a suitable name.
Find the current decision
- Open WhatsApp Manager for the business portfolio that owns the connected number.
- Go to Account tools → Phone numbers, select the number and open Profile. Check the submitted display name and its current status.
- Compare the exact spelling and number with any notice you received. Record the notice time and the time you checked the current status, including time zone.
- If the notice describes an earlier submission, identify the name currently under review before changing it again. If the applicable decision is unclear, ask ChatArchitect support to check the number and submission.
Act on the result you can confirm
| Review result | Next check |
|---|---|
| Approved | Compare the approved spelling with the number's WhatsApp business profile. If a customer still sees another name, record the difference and ask support to investigate. |
| Pending or deferred | Keep the submitted name and current status in your record. If you need to know the next step, ask support about that submission; there is no review completion time promised here. |
| Rejected | Record the reason if it is shown. Compare the name with your public business identity and the display-name guide, correct it in WhatsApp Manager and check the new review result. |
| No clear result or edit control | Confirm the selected portfolio and number. Give support the submitted name, available status and a screenshot of the missing or unavailable control. |
Compare the name shown in different places
Record where each name appears: the current WhatsApp Manager entry, the business profile viewed in WhatsApp, or a contact label in your CRM/help desk. Give support the exact location and spelling. A locally saved contact label does not establish the current Meta review decision.
To update the photo, website or description, use the business-profile guide. Display-name review, business verification and an official business badge are separate processes. Approval of a name does not establish a badge or the outcome of a message sent through the integration.
Example: the notice names the previous submission
You edited the name after an earlier rejection and now receive a notice referring to the old spelling. Open the selected number in WhatsApp Manager and check the currently submitted name and status. Keep both observations and their times for support; use the current confirmed result when deciding the next edit.
Information for support
Provide the connected business number, owning portfolio, submitted spelling, current review result, notice wording and time, and where the different name appears. Include redacted screenshots. Keep passwords, PINs, App key, Secret and verification codes out of them.
For an application that needs review notifications
Meta calls its direct developer notification phone_number_name_update. The official reference describes review outcomes for newly submitted or edited display names. The current ChatArchitect API quick start does not document forwarding this event to customer callbacks or synchronizing a reviewed name into every CRM. Confirm the supported behavior and contract with support before adding automation. Use the webhook overview for the documented ChatArchitect events.
No comments to display
No comments to display