> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Administrar números de teléfono de WhatsApp

> Registrar números de teléfono y administrar perfiles, comercio y ajustes de llamadas.

## Qué es

Un número de teléfono de WhatsApp Business es la identidad del remitente que los clientes ven en una
conversación. Utilice estas API para descubrir números registrados, configurar su
perfil de empresa, solicitar un cambio de nombre visible, controlar la visibilidad comercial,
y administrar la configuración específica del teléfono.

## Antes de empezar

* Conecta la WABA principal a YCloud.
* Añade el número de teléfono a la WABA.
* Guarda el ID de la WABA y el número de teléfono en formato E.164.
* Sube una foto de perfil a Meta antes de configurar `profilePictureUrl`.

## Cómo funciona

1. Enumera los números o recupera un número para inspeccionar su estado.
2. Registra un número antes de usarlo para enviar mensajes.
3. Actualiza el perfil de empresa de cara al cliente.
4. Actualiza el nombre visible, la visibilidad comercial o la configuración de llamadas según sea necesario.
5. Recupera el recurso nuevamente para confirmar la configuración actual.

Los cambios de nombre visible y algunas configuraciones de la plataforma pueden requerir de Meta un
procesamiento asíncrono.

## Solicitud

### Registrar un número de teléfono

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request POST \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/register \
  --header "X-API-Key: $YCLOUD_API_KEY"
```

### Actualizar el perfil de empresa

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request PATCH \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/profile \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "about": "Customer support and order updates",
    "address": "100 Market Street",
    "description": "Example Store",
    "email": "support@example.com",
    "vertical": "RETAIL",
    "websites": ["https://example.com"]
  }'
```

### Actualizar la visibilidad comercial

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request PATCH \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/whatsappCommerceSettings \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "isCartEnabled": true,
    "isCatalogVisible": true
  }'
```

## Respuesta

Las operaciones de perfil y configuración devuelven el recurso actualizado.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "about": "Customer support and order updates",
  "email": "support@example.com",
  "vertical": "RETAIL",
  "websites": ["https://example.com"]
}
```

El registro devuelve el recurso del número de teléfono. Almacene sus ID e inspeccione su
estado de registro y calidad antes de enviar.

## Áreas de configuración

| Área | Uso |
| - | - |
| Perfil | Texto de información, dirección, descripción, correo electrónico, sector, sitios web y foto de perfil. |
| Nombre visible | Nombre del remitente de cara al cliente enviado para el procesamiento de Meta. |
| Comercio | Visibilidad del catálogo y controles del carrito de compras. |
| Configuración | Funciones específicas del teléfono, como las llamadas de WhatsApp. |

## Límites y solución de problemas

* Los campos del perfil tienen límites de formato y longitud; consulte la Referencia de la API para conocer las
  restricciones completas.
* Las URL del sitio web deben incluir `http://` o `https://`.
* Es posible que la actualización del nombre visible no se active de inmediato.
* El registro, la calidad y el estado de la WABA pueden afectar el envío de forma independiente.
* Utilice el ID de la WABA y el número E.164 exacto en cada ruta.

<CardGroup cols={2}>
  <Card title="Listar números de teléfono" icon="list" href="/api-reference/whatsapp-phone-numbers/list-phone-numbers">
    Descubra los números registrados y su WABA principal.
  </Card>

  <Card title="Actualizar perfil" icon="address-card" href="/api-reference/whatsapp-phone-numbers/update-a-phone-number-profile">
    Inspeccione cada campo del perfil y sus restricciones.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.