Asistencia
Solución de problemas
No se entregó el mensaje
En las siguientes situaciones, es posible que un mensaje aparezca como enviado pero no entregado. Por muchas de estas razones, no divulgaremos la causa subyacente del error debido a razones de privacidad y políticas.
- El cliente no estuvo en línea durante el intervalo de 30 días en el que conservamos los mensajes de los clientes sin conexión.
- El cliente bloqueó el número de teléfono del negocio u otro número de teléfono comercial que es propiedad de la empresa.
- El cliente se encuentra en un país que tiene restricciones o sanciones.
En algunas situaciones, la API devuelve un código de error con un mensaje en el que se describe la naturaleza de este. Ejemplos de situaciones:
- Parámetros de solicitud no válidos
- Errores de integridad
- El cliente no aceptó nuestras nuevas Condiciones del servicio ni nuestra Política de privacidad. Envía a tu usuario final este enlace para que acepte las Condiciones del servicio más recientes: https://wa.me/tos/20210210.
- El cliente utiliza una versión antigua de WhatsApp. Los clientes deben utilizar la versión siguiente 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 es parte de un grupo de experimentación.
- El mensaje no se entregó para crear una experiencia de usuario de alta calidad. Consulta Límites de mensajes de plantillas de marketing por usuario.
Posibles soluciones
Utiliza un método de comunicación que no sea WhatsApp y pídele al usuario de WhatsApp que realice lo siguiente:
- Confirme que puede enviar un mensaje a tu número de teléfono comercial de WhatsApp
- Confirme que tus números de teléfono comercial de WhatsApp no están en su lista de números bloqueados (Configuración > Privacidad > Bloqueados o Contactos bloqueados)
- Confirme que aceptó nuestras Condiciones del servicio más recientes (si va a Configuración > Ayuda, o Configuración > Información de la aplicación, se le pedirá que acepte las condiciones y políticas más recientes, si no lo hizo aún)
- Actualice a la última versión del cliente de WhatsApp
Restricciones en determinados países
Las empresas de Cuba, Irán, Corea del Norte, Siria y tres regiones sancionadas en Ucrania (Crimea, Donetsk, Lugansk) no aplican para utilizar la Plataforma de WhatsApp Business.
Los usuarios de WhatsApp Messenger (WhatsApp) y WhatsApp Business de Cuba, Irán, Corea del Norte, Siria y tres regiones sancionadas en Ucrania (Crimea, Donetsk y Lugansk) no aplican para recibir mensajes que se envían a través de la Plataforma de WhatsApp Business.
A partir del 15 de mayo de 2024, los mensajes comerciales de la API de la nube dejarán de estar restringidos en Turquía. Los negocios de la API de la nube ahora pueden iniciar conversaciones y recibir mensajes de usuarios de WhatsApp con números turcos.
Webhooks
El estado de entrega del mensaje presenta conflictos
En casos poco habituales, el mismo mensaje puede activar webhooks de actualización de estado del mensaje de entrega correcta e incorrecta. Por ejemplo, un mensaje puede activar un webhook de mensaje con "status":"delivered" y otro webhook con "status":"failed". Esto puede suceder cuando un cliente inició sesión en WhatsApp en varios dispositivos y el mensaje se entrega correctamente en uno de los dispositivos pero no en otro. El mensaje que activa un webhook de estado del mensaje "delivered" se entregó a al menos uno de los dispositivos del usuario.
Código de error 2 - Servicio de la API
Cuando actualizamos la API, es posible que experimentes hasta 5 minutos de tiempo de inactividad. Durante este período, el servicio no está disponible. Nos esforzamos por realizar estas actualizaciones con la menor interrupción posible para las empresas, pero es posible que se vean afectadas.
Cómo realizar la depuración
Te recomendamos que esperes 5 minutos y vuelvas a intentar realizar la llamada a la API.
Errores de autenticación y autorización
Estos errores se devuelven cuando hay un problema relacionado con el token de acceso que estás usando para la llamada a la API.
Cómo realizar la depuración
Puedes pegar directamente el token de acceso que estás utilizando en el depurador de tokens de acceso. Luego, comprueba si seleccionaste los permisos whatsapp_business_management y whatsapp_business_messaging.
Si tu token no tiene acceso a los permisos, debes generar uno nuevo. Mientras generas el token, asegúrate de seleccionar lo siguiente:
- La app de Meta que estás utilizando para las llamadas a la API
- Los 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 fiabilidad
Consulta nuestra página de estado de la API de WhatsApp Business para conocer las métricas de observabilidad específicas de la API de la nube.
Consulta la página de estado de la API para obtener más detalles.
La disponibilidad se actualiza una vez al día.
Podría haber situaciones en las que ciertos errores de usuarios se contabilicen incorrectamente respecto del tiempo de inactividad. En estas situaciones, cambiaremos el tiempo de inactividad a tiempo de actividad después de un análisis detallado en el plazo de una semana.
Es posible que haya problemas que no afectan nuestra disponibilidad global. En estos casos, el estado de la página de estado de la API de WhatsApp Business indicará que puede haber algunas interrupciones que no afectan la disponibilidad global. Envía un ticket de asistencia directa para que sigamos investigando el problema.
Hay casos en los que no se registra el tiempo durante el cual las soluciones no están disponibles:
- Los problemas de red que generan errores en las solicitudes antes de llegar a la capa de la API Graph (primera capa).
- Los problemas de red que impiden que los webhooks salientes lleguen al punto de conexión de webhook del negocio.
Cualquier problema que surja antes de que tenga lugar la admisión en nuestro sistema, pero después de este punto, se mostrará como error o como éxito perdido. Además, se continuará intentando emitir el webhook que generó problemas después del primer intento hasta que se lo logre entregar correctamente en el punto de conexión de webhook.
Los otros casos que se reflejan en el panel de disponibilidad después de producirse la detección manual (sin contar los errores del sistema) son los siguientes:
- Se determinan los problemas de autenticación de Meta, como el token de autenticación (bibliotecas de seguridad), si se trata de solicitudes legítimas que producen un error en la autenticación o la autorización.
- Validación que rechaza solicitudes legítimas.
En ambos casos, WhatsApp detectará y explicará esos problemas después de producido el hecho, casi en tiempo real, pero no en tiempo real.
Por el momento, no ofrecemos comercialmente acuerdos de nivel de servicio en cuanto al tiempo de actividad y/o la latencia de los productos.
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.