La traducción en Español (España) no está disponible todavía.
Actualización del documento en Español (España):
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 https://wa.me/tos/20210210 para que acepte las Condiciones del servicio más recientes.
- El cliente está utilizando 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 enviados a través de la Plataforma de WhatsApp Business.
Las empresas de Turquía pueden utilizar la plataforma, pero los mensajes enviados a través de la API a usuarios de WhatsApp que tengan un código de llamada de país turco no los recibirán. A su vez, los mensajes enviados por parte de estos usuarios a un número de teléfono de la empresa registrado para su uso con la API de la nube o con la API de instalaciones locales no se entregarán.
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 o 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
We expect Cloud API to provide the same key features as the On-Premises API soon, including user change notifications and sticker pack management. Our goal is for the Cloud API to become the preferred platform for new features.
We will release updates monthly with new features and improvements. There is no work required to access these features - the Cloud API updates automatically.
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.
No, we will continue to provide the On-Premises API for now. See On-Premises API for information.
No, there is no difference in messaging prices between the Cloud API and the On-Premises API. Access to Cloud API is free, and we expect it to generate additional cost savings for developers. The two types of cost savings for the Cloud API are 1) set up cost (including server or external cloud provider cost), 2) ongoing cost of maintenance (including engineering time for API upgrades).
A Solution Partner can select which setup a given client should use. We recommend that the majority of clients use the Cloud API for ease of implementation and maintenance. Solution Partners can also continue to maintain integration with the On-Premises 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 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.