Asistencia
Solución de problemas
Mensaje no entregado
Los siguientes escenarios pueden hacer que un mensaje aparezca como enviado pero no entregado. Por muchos de estos motivos, no divulgaremos la causa subyacente del error, debido a razones de privacidad y políticas.
- El cliente no se conectó durante el intervalo de 30 días de retención de los mensajes para los clientes fuera de internet.
- El cliente ha bloqueado el número de teléfono de empresa u otro número de teléfono de empresa que pertenece al negocio.
- El cliente se encuentra en un país restringido o sancionado.
En varios escenarios, la API devuelve un código de error con un mensaje de error que describe la naturaleza del error. Escenarios de ejemplo:
- Parámetros de solicitud no válidos
- Errores de integridad
- El cliente no ha aceptado nuestras nuevas Condiciones del servicio y Política de privacidad. Envía al usuario final este enlace https://wa.me/tos/20210210 para aceptar las Condiciones del servicio más recientes.
- El cliente está utilizando una versión antigua de WhatsApp. Los clientes deben utilizar la versión que se indica a continuación o una posterior:
- Android: 2.21.15.15
- SMBA: 2.21.15.15
- iOS: 2.21.170.4
- SMBI: 2.21.170.4
- KaiOS: 2.2130.10
- Web: 2.2132.6
- El cliente forma parte de un grupo de experimentos.
- El mensaje no se entregó para crear una experiencia de usuario de alta calidad. Consulta Límites de mensajes de plantilla de marketing por usuario.
Posibles soluciones
Con un método de comunicación que no sea de WhatsApp, pide al usuario de WhatsApp lo siguiente:
- Debe confirmar que realmente puede enviar un mensaje a tus números de teléfono de empresa de WhatsApp.
- Debe confirmar que ninguno de tus números de teléfono de empresa de WhatsApp esté en su lista de números bloqueados (Configuración > Privacidad > Bloqueados o Contactos bloqueados).
- Debe confirmar que ha aceptado nuestras Condiciones del servicio más recientes (en Configuración > Ayuda o Configuración > Información de la aplicación, tendrá que aceptar las condiciones o políticas más recientes si todavía no lo ha hecho).
- Debe actualizar a la versión más reciente del cliente de WhatsApp.
Restricciones de países
Las empresas ubicadas en Corea del Norte, Cuba, Irán, Siria y tres regiones sancionadas de Ucrania (Crimea, Donetsk y Luhansk) no cumplen los requisitos para utilizar la Plataforma de WhatsApp Business.
Los usuarios de las aplicaciones WhatsApp Messenger (WhatsApp) y WhatsApp Business que residen en Corea del Norte, Cuba, Irán, Siria y tres regiones sancionadas de Ucrania (Crimea, Donetsk y Luhansk) no cumplen los requisitos para recibir mensajes enviados mediante la Plataforma de WhatsApp Business.
A partir del 15 de mayo de 2024, enviar y recibir mensajes de empresas mediante la API de nube ya no está restringido para Turquía. Las empresas con la API de nube ya pueden iniciar conversaciones y recibir mensajes de usuarios de WhatsApp con números de Turquía.
Webhooks
Estado de entrega de mensajes en conflicto
En casos excepcionales, el mismo mensaje puede activar los webhooks de actualización de estado de mensajes de éxito y de error. Por ejemplo, un mensaje puede activar los webhooks de mensajes con "status":"delivered" y otro webhook con "status":"failed". Esto puede suceder cuando un cliente inicia sesión en WhatsApp en varios dispositivos y el mensaje se entrega correctamente en uno de los dispositivos pero no en los otros. Los mensajes que activan un webhook de estado de mensaje "delivered" se han entregado en uno de los dispositivos del usuario como mínimo.
Código de error 2: servicio de la API
Cuando actualizamos la API, es posible que experimentes hasta cinco minutos de tiempo de inactividad. Durante este periodo de tiempo, el servicio no está disponible. Intentamos causar la menor interrupción comercial posible al llevar a cabo estas actualizaciones, pero es posible que te afecten.
Cómo depurar
Te sugerimos que esperes cinco minutos e intentes volver a realizar la llamada a la API.
Errores de autenticación y autorización
Estos errores se devuelven cuando se produce un problema con el identificador de acceso que utilizas para la llamada a la API.
Cómo depurar
Puedes pegar directamente el identificador de acceso que utilizas en el depurador de identificadores de acceso. A continuación, comprueba si has seleccionado los permisos whatsapp_business_management y whatsapp_business_messaging.
Si el identificador no tiene acceso a los permisos, debes generar uno nuevo. Al generar el identificador, asegúrate de seleccionar lo siguiente:
- La aplicación de Meta que usas para las llamadas a la API.
- Las siguientes permisos:
whatsapp_business_managementywhatsapp_business_messaging.
Preguntas frecuentes
Preguntas frecuentes generales
WhatsApp develops and operates the WhatsApp Business API, which enables businesses to communicate with WhatsApp consumer users on the WhatsApp network. When using the Cloud API, Meta will host the WhatsApp Business API for you and provide an endpoint for the WhatsApp service for your incoming and outgoing WhatsApp communications.
Please view information about the sunset of the On-Premises API.
Access to Cloud API is free, and we expect it to generate additional cost savings for developers, as Meta hosts and maintains the Cloud API.
We want to make it clear what it means to message with a business on WhatsApp. Some businesses may choose to use Meta or another company to help them manage and store their messages. When a business chooses to manage their messages with another company, we will let consumers know by showing a different system message. Learn more.
Preguntas frecuentes sobre la implementación técnica
The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.
Solution Partners and direct clients do not need the WebApp and CoreApp containers that are used in the On-Premises API. Meta will manage all database data and media data on behalf of the Solution Partner or direct client.
As your on-premises performance depends heavily on your hardware, software, and connectivity to WhatsApp servers, if you wish to understand these differences, you can perform your own load tests on Cloud API as you might have done for your own on-premises installation. You can also refer to our performance comparison to understand more details around how the on-premise and Cloud APIs compare.
Migrating between the on-premises and Cloud APIs is seamless, and can be done bidirectionally. See migration details for more information.
Preguntas frecuentes sobre la fiabilidad
Consulta la página de estado de la API de WhatsApp Business para ver las métricas de observabilidad específicas de la API de nube.
Consulta la página de estado de la API para obtener más información.
La disponibilidad se actualiza una vez al día.
Podrían darse casos en los que ciertos errores de usuario se cuenten automáticamente de forma errónea como tiempo de inactividad. En estos casos, en el plazo de una semana actualizaremos el tiempo de inactividad a tiempo de actividad tras un análisis detallado.
Puede haber problemas que no afecten a nuestra disponibilidad global. En estos casos, en la página de estado de la API de WhatsApp Business se mostrará un estado que reflejará que pueden producirse algunas interrupciones que no afectan a la disponibilidad global. Envía una solicitud de Asistencia directa para que podamos investigar el problema más detalladamente.
Hay casos en los que no se realiza un seguimiento de los tiempos de inactividad en la disponibilidad de forma automática:
- Problemas de red que provocan errores en las solicitudes antes de que alcancen la capa de la API Graph (primera capa).
- Problemas de red que hacen que los webhooks de salida no alcancen el extremo de webhooks de la empresa.
Los problemas que surjan antes de la admisión en nuestro sistema desde este momento aparecerán como errores u operaciones correctas desaprovechadas. Además, los problemas detectados a partir del primer intento de emitir el webhook se seguirán intentando hasta que se entregue correctamente al extremo de webhooks.
Los demás casos que se indican en el panel de disponibilidad tras la detección manual son los siguientes (no son errores del sistema):
- Para los problemas de autenticación de Meta, como el identificador de autenticación (bibliotecas de seguridad), se determina si son solicitudes legítimas con errores de autenticación o autorización.
- Validación que rechaza solicitudes legítimas.
En ambos casos, WhatsApp detectará dichos problemas y se encargará de ellos después de que se produzcan, casi en tiempo real, pero no en tiempo real.
Actualmente no ofrecemos acuerdos de nivel de servicio de productos disponibles comercialmente para tiempo de actividad o latencia.
We will have disaster recovery and data replication across multiple regions. The expected downtime would be within our SLA and usually in the order of less than a minute to less than five minutes.