Skip to main content

​
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
Utilice filter.accountReviewStatus cuando necesite cuentas en un estado de revisión específico.

​
Recuperar una WABA

GET /whatsapp/businessAccounts/{id}

​
Respuesta

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

Listar WABA

Inspeccione la paginación, los filtros y el esquema completo de la página.

Recuperar una WABA

Inspeccione todos los campos de estado y restricción de la cuenta.