whatsapp.phone_number.name_updated

Usa whatsapp.phone_number.name_updated para gestionar este evento en tu endpoint de webhook.

Desencadenadores

Se produce cuando se aprueba o rechaza el nombre de un número de teléfono comercial de WhatsApp. Suscríbete a whatsapp.phone_number.name_updated cuando configures tu endpoint de webhook.

Sintaxis

YCloud envía una solicitud HTTP POST a tu URL de webhook configurada. La siguiente estructura muestra una variante de carga útil. Los valores entre corchetes angulares son marcadores de posición; sus tipos se enumeran en Parámetros. Los campos opcionales y otras variantes se describen a continuación.

{
  "id": "<ID>",
  "type": "whatsapp.phone_number.name_updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappPhoneNumber": {
    "id": "<ID>",
    "phoneNumber": "<PHONE_NUMBER>",
    "wabaId": "<WABA_ID>",
    "verifiedName": "<VERIFIED_NAME>",
    "requestedVerifiedName": "<REQUESTED_VERIFIED_NAME>",
    "decision": "<DECISION>",
    "nameStatus": "<NAME_STATUS>",
    "newNameStatus": "<NEW_NAME_STATUS>"
  }
}

Parámetros

Valida el encabezado HTTP YCloud-Signature antes de procesar el cuerpo JSON. Consulta la validación de firmas.

Envoltorio del evento

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	Identificador único del evento. Longitud mínima: `6`. Longitud máxima: `128`.
`type`	string	Sí	Siempre `whatsapp.phone_number.name_updated`.
`apiVersion`	string	Sí	La versión de la API utilizada para procesar este evento.
`createTime`	string (date-time)	Sí	La fecha y hora en que se creó este evento, formateada en RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.

Carga útil del evento

Parámetro	Tipo	Obligatorio	Descripción
`whatsappPhoneNumber`	object	No	Carga útil de `whatsappPhoneNumber` específica del evento.

Los cuatro campos comunes del envoltorio son obligatorios. Los campos de la carga útil dependen de la variante del evento. En cada tabla de objetos, Obligatorio se aplica cuando su objeto superior está presente. Los campos opcionales se pueden omitir; un ejemplo no convierte un campo en obligatorio.

whatsappPhoneNumber

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	ID del número de teléfono.
`phoneNumber`	string	No	Número de teléfono en formato E.164.
`displayPhoneNumber`	string	No	Número de teléfono visible.
`wabaId`	string	No	ID de la cuenta de WhatsApp Business.
`verifiedName`	string	No	Nombre verificado.
`nameStatus`	string	No	El estado de revisión de la solicitud actual de nombre visible. Consulta también Get Display Name Status. `APPROVED`: el nombre ha sido aprobado. Ya puedes descargar tu certificado. `AVAILABLE_WITHOUT_REVIEW`: el certificado para el teléfono está disponible y el nombre visible está listo para usarse sin revisión. `DECLINED`: el nombre no ha sido aprobado. No puedes descargar tu certificado. `EXPIRED`: tu certificado ha caducado y ya no se puede descargar. `PENDING_REVIEW`: tu solicitud de nombre está en revisión. No puedes descargar tu certificado. `NONE`: no hay ningún certificado disponible.
`newNameStatus`	string	No	El estado de revisión de la nueva solicitud de nombre visible. Consulta también Get Display Name Status. Valores: `APPROVED`, `AVAILABLE_WITHOUT_REVIEW`, `DECLINED`, `EXPIRED`, `PENDING_REVIEW`, `NONE`.
`decision`	string	No	Decisión de revisión tomada sobre este número de teléfono. Puede ser `APPROVED` o `REJECTED`.
`requestedVerifiedName`	string	No	Último nombre verificado solicitado.
`rejectionReason`	string	No	Motivo del rechazo.

Ejemplo

El siguiente JSON es el cuerpo entregado a tu receptor. Los identificadores, números de teléfono y otros valores de la cuenta son ilustrativos.

{
  "id": "evt_example_whatsapp_phone_number_name_updated",
  "type": "whatsapp.phone_number.name_updated",
  "apiVersion": "v2",
  "createTime": "2026-05-26T12:00:00.000Z",
  "whatsappPhoneNumber": {
    "id": "1234567890123456",
    "phoneNumber": "+12025550124",
    "wabaId": "whatsapp-business-account-id",
    "verifiedName": "Example business",
    "requestedVerifiedName": "Example business",
    "decision": "APPROVED",
    "nameStatus": "APPROVED",
    "newNameStatus": "APPROVED"
  }
}

Tras verificar la firma y aceptar de forma duradera el evento, devuelve una respuesta 2xx. Procesa las tareas lentas de forma asíncrona.

HTTP/1.1 200 OK

Para ver ejemplos prácticos de escenarios, consulta los ejemplos comentados.

Primeros pasos

Guías

Endpoints

Webhook reference

whatsapp.phone_number.name_updated

Desencadenadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

whatsappPhoneNumber

Ejemplo

​Desencadenadores

​Sintaxis

​Parámetros

​Envoltorio del evento

​Carga útil del evento

​whatsappPhoneNumber

​Ejemplo

Desencadenadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

whatsappPhoneNumber

Ejemplo