Skip to main content
Compruebe tanto la respuesta inicial de la API como los webhooks whatsapp.message.updated posteriores. La aceptación por parte de YCloud o Meta no confirma la entrega. Las siguientes tablas recuperan los casos de error documentados. No constituyen una lista exhaustiva de los errores que Meta puede introducir. Para conocer los detalles actualizados del proveedor, consulte la referencia de errores de Meta.

YCloud no pudo enviar mensajes

whatsappApiError en el cuerpo de la respuesta

Es posible que reciba un cuerpo de respuesta de error que incluya el campo error.whatsappApiError al enviar mensajes de WhatsApp a través de la API de YCloud, habitualmente con la API Send a WhatsApp message directly (POST /v2/whatsapp/messages/sendDirectly). Aquí tiene un ejemplo de respuesta de error con estado HTTP 429 cuando envía demasiados mensajes al mismo número de teléfono:
En este caso, intentamos realizar la solicitud a la WhatsApp Business API y obtuvimos una respuesta de error. Se incluye error.whatsappApiError para ayudarle a identificar el motivo del error.

whatsappApiError en la carga útil del webhook

Si utiliza la API Enqueue a WhatsApp message (POST /v2/whatsapp/messages), nunca recibirá una respuesta de error con error.whatsappApiError, ya que enviamos sus mensajes a la WhatsApp Business API de forma asíncrona. Puede obtenerlo configurando un webhook que escuche los eventos whatsapp.message.updated. A continuación se muestra un ejemplo de la carga útil del webhook:

códigos de error devueltos por la WhatsApp Business API

whatsappApiError corresponde exactamente al WhatsApp Business Cloud API Error. A continuación se indican algunos de los posibles códigos de error que pueden devolverse a través de la API de YCloud.

códigos de error devueltos por la API de YCloud

Tenga en cuenta que error.whatsappApiError no se incluye cuando YCloud detecta los errores y no solicitamos la WhatsApp Business API. Por ejemplo, si proporciona un número de teléfono no válido, obtendrá la siguiente respuesta de error:
El valor error.code es uno de los códigos de error definidos por el servidor de YCloud. A continuación se indican algunos de los posibles códigos de error devueltos por la API de YCloud:

Códigos de error de YCloud transmitidos por webhooks

Si utilizas el endpoint Enqueue a WhatsApp message (POST /v2/whatsapp/messages), el mensaje puede fallar debido a un error de YCloud. Es decir, el whatsappMessage.errorCode en la carga útil del webhook también puede transmitir uno de los Códigos de error de YCloud, como BALANCE_INSUFFICIENT. Estos son algunos posibles errores:

Meta no pudo enviar los mensajes

No todos los códigos de error listados en la página WhatsApp Business Cloud API Error se devuelven a través de la API de YCloud. Incluso si un mensaje se envía correctamente a la WhatsApp Business API, también puede fallar en su entrega. Meta notifica a YCloud sobre estos errores a través de webhooks. Debes Configurar Webhooks que escuchen eventos whatsapp.message.updated para recibir estas notificaciones de YCloud. Aquí tienes un ejemplo de la carga útil del webhook para mensajes enviados que finalmente fallaron:
El whatsappMessage.errorCode transmite el código de Error de WhatsApp Business API.

Códigos de error de Meta transmitidos por webhooks

A continuación se enumeran algunos posibles códigos de error transmitidos por los webhooks de YCloud originados en los webhooks de Meta: