User changed phone number

Last update: 4 days ago by Irais Aguirre

Integration summary
Delivery: WhatsApp → Concepto Móvil → POST to your webhook URL (the one you share with our Operations team), with a JSON body.
Format: Meta's value object without metadata or messaging_product (see Webhook).
Identify the user: from/recipient_id or, if missing, the BSUID.
Types on this page: system (user_changed_number, user_changed_user_id)

User changed phone number

Sent when a user's phone number or BSUID changes. It's a message whose type is "system". There are two cases:

The user changed their phone number: system.type is "user_changed_number". Because the BSUID is regenerated too, the notification includes both the new and the previous BSUID.
Only the BSUID changed and the phone number can't be shared: system.type is "user_changed_user_id". It usually doesn't include wa_id.

Structure

Fields for User changed phone number:

System object

Name	Description	Type	Requirements
body	Text describing the change. For "user_changed_number" it has the old and new phone numbers; for "user_changed_user_id", the old and new BSUIDs.	String	Required
wa_id	The user's new phone number. Missing if the number can't be shared.	String	Conditional
user_id	The user's new BSUID.	String	Required
previous_user_id	The user's previous BSUID. Missing if it isn't available.	String	Optional
parent_user_id	New parent BSUID. Only included if the business has linked portfolios.	String	Optional
previous_parent_user_id	Previous parent BSUID. Only included if the business has linked portfolios.	String	Optional
type	Type of change. Possible values: user_changed_number user_changed_user_id	String	Required

Example

Complete User changed phone number example:

{
    "messages": [
        {
            "from": "16315551181",
            "id": "ABGGFlA5Fpa",
            "timestamp": "1504902988",
            "type": "system",
            "system": {
                "body": "User A changed from 16315551181 to 16315551199",
                "wa_id": "16315551199",
                "user_id": "US.98712345678901234567",
                "previous_user_id": "US.13491208655302741918",
                "parent_user_id": "US.ENT.506847293015824",
                "previous_parent_user_id": "US.ENT.11815799212886844830",
                "type": "user_changed_number"
            }
        }
    ]
}