Ricky logorickyDocs

Pedir un cambio de nombre visible

POST
/whatsapp-numbers/{channel_id}/display-name

Pide a Meta que revise un nombre visible nuevo para el número. El nombre cambia solo si Meta lo aprueba; entonces cambian verified_name y name_status.

Permiso: conversations:write.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de ruta

channel_id*string

ID del canal.

Formatouuid

Parámetros de cabecera

Idempotency-Key?string

Opcional. Un valor que eliges, único por escritura lógica, de 8 a 200 caracteres: un UUID o un ID de tu sistema, como order-10482-ready. Reintentar con la misma clave y el mismo cuerpo repite la primera respuesta en lugar de repetir la escritura.

Longitud8 <= length <= 200

Cuerpo de la solicitud

application/json
  1. body

Un nombre visible nuevo para que Meta lo revise.

display_name*string

El nombre de la empresa que mostrará el número. Meta lo revisa según sus reglas.

Longitud1 <= length <= 256

Cuerpo de la respuesta

Aceptada.

application/json
  1. response
data*

Un cambio de nombre visible que Meta está revisando.

curl -X POST 'https://getricky.ai/api/v1/whatsapp-numbers/497f6eca-6276-4993-bfeb-53cbbbba6f08/display-name' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "display_name": "Casa Nativa Óptica"}'
{  "data": {    "requested_display_name": "Casa Nativa Óptica",    "status": "pending_review"  }}