> ## 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.

# Gestionar cuentas de WhatsApp Business

> Obtenga las cuentas de WhatsApp Business conectadas e interprete su estado operativo.

## Qué es

Una cuenta de WhatsApp Business (WABA) contiene los números de teléfono, las plantillas y
la configuración de mensajería que utiliza una empresa. Utilice estas API para detectar las
WABA conectadas a su cuenta de YCloud y comprobar si cada cuenta está
lista para la mensajería en producción.

## Antes de comenzar

* Conecte o registre una WABA con YCloud.
* Guarde su clave de API de YCloud de forma segura.
* Determine si necesita todas las cuentas conectadas o un WABA ID específico.

## Cómo funciona

1. Liste las WABA para descubrir sus ID.
2. Recupere una WABA cuando necesite consultar su estado actual comercial, de verificación, de pago,
   de restricción o de límite de mensajería.
3. Guarde el WABA ID junto con los números de teléfono y las plantillas que le pertenecen.

La API es de solo lectura. La incorporación de la cuenta y su resolución pueden requerir acciones en
YCloud o en Meta Business Manager.

## Solicitud

### Listar WABA

`GET /whatsapp/businessAccounts`

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.ycloud.com/v2/whatsapp/businessAccounts?page=1&limit=20&includeTotal=true" \
  --header "X-API-Key: $YCLOUD_API_KEY"
```

Utilice `filter.accountReviewStatus` cuando necesite cuentas en un estado de
revisión específico.

### Recuperar una WABA

`GET /whatsapp/businessAccounts/{id}`

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

## Respuesta

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "WABA_ID",
  "name": "Example Business",
  "currency": "USD",
  "accountReviewStatus": "APPROVED",
  "businessVerificationStatus": "verified",
  "paymentMethodAttached": true,
  "primaryBusinessLocation": "US",
  "whatsappBusinessManagerMessagingLimit": "TIER_2K"
}
```

| Campo | Descripción |
| - | - |
| `id` | WABA ID utilizado por las API de números de teléfono, plantillas y Flow. |
| `accountReviewStatus` | Estado actual de revisión de la cuenta de WhatsApp. |
| `businessVerificationStatus` | Estado de verificación del negocio en Meta. |
| `paymentMethodAttached` | Indica si la cuenta tiene un método de pago asociado. |
| `restrictions` | Restricciones activas y sus fechas de vencimiento, cuando existan. |
| `whatsappBusinessManagerMessagingLimit` | Límite de mensajería actual a nivel de empresa. |

## Límites de registro de números de teléfono

Los endpoints de listar y recuperar no devuelven valores históricos para
`maxPhoneNumbersPerBusiness` o `maxPhoneNumbersPerWaba`. Suscríbase a
`whatsapp.business_account.updated` y gestione
`updateEvent=BUSINESS_CAPABILITY_UPDATE` para recibir los valores que Meta incluye
en cada actualización.

Meta informa actualmente sobre estos dos campos en actualizaciones independientes. No los trate
como mutuamente excluyentes: procese cada campo de manera independiente y acepte ambos si una
actualización futura los incluye juntos. Un valor de `0` es válido. Guarde estos
valores en su sistema si necesita un historial o el estado conocido más reciente.

## Preparación de la cuenta

No asuma que una recuperación exitosa sea prueba de que todos los números de teléfono puedan enviar mensajes.
Compruebe el estado de la WABA junto con el registro del número de teléfono seleccionado,
el estado de la plantilla, el acceso al producto y los límites de mensajería.

## Límites y resolución de problemas

* Si no se encuentra una WABA, generalmente significa que no está conectada a la cuenta de YCloud
  actual o que el ID es incorrecto.
* Los estados de revisión, verificación, restricción y pago son controlados por Meta
  y pueden cambiar de manera asíncrona.
* Almacene en caché los identificadores estables, pero vuelva a consultar el estado antes de diagnosticar un
  problema de incorporación o de envío.

<CardGroup cols={2}>
  <Card title="Listar WABA" icon="list" href="/api-reference/whatsapp-business-accounts/list-wabas">
    Inspeccione la paginación, los filtros y el esquema completo de la página.
  </Card>

  <Card title="Recuperar una WABA" icon="code" href="/api-reference/whatsapp-business-accounts/retrieve-a-waba">
    Inspeccione todos los campos de estado y restricción de la cuenta.
  </Card>
</CardGroup>


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