Este error aparece cuando el número de teléfono fue usado previamente con otro proveedor de WhatsApp Business API o con la app móvil/empresarial de WhatsApp. Si el número fue usado en la app estándar de WhatsApp, debe desconectarlo antes de conectarlo a Intercom.

Si se usó con otro proveedor de API:
Siga el flujo de incorporación para migrar un número de teléfono de WhatsApp existente, y salga de la incorporación integrada después del Paso 2.

Si se usó con una app móvil de WhatsApp:
Siga los pasos bajo el enlace Aprende más mostrado en el error para desconectar el número de esa cuenta de WhatsApp, luego debería poder reintentar nuestro proceso de incorporación con éxito.

Si ninguno aplica, contacte a Soporte con su:

Podemos intentar una conexión manual.

Revise la consola de su navegador para más detalles.

Si esto ocurrió durante la migración:
La migración puede que ya haya tenido éxito. Intente usar el flujo “Estoy integrando WhatsApp por primera vez” y seleccione las cuentas recién creadas.

Si no puede guardar la configuración de su perfil empresarial y recibe un error 500 en la consola de su navegador, probablemente sea un error de validación devuelto por WhatsApp sobre la configuración del perfil que intenta actualizar. Hay detalles sobre las restricciones como el número máximo de caracteres aquí.

Error completo: "No se puede migrar el número de teléfono. La cuenta de WhatsApp a la que está registrado este número no está configurada correctamente".

Verifique:

Si ambas verificaciones fallan: Enviar a Soporte una captura de pantalla del número verificado en Business Manager ayuda a acelerar la resolución.

Proporcione a Soporte su:

Contacte al soporte de clientes de Intercom para ayuda con este error.

Asegúrese de que su número de WhatsApp esté conectado en la página de instalación.

Verifica que el número de teléfono esté completamente aprobado en Meta.

Esto suele ocurrir debido a palabras restringidas o no permitidas en los campos de título o descripción.

Esto ocurre a menudo con números proporcionados por proveedores externos. Intenta nuevamente los pasos de incorporación para la migración. Si no tienes éxito, contacta con Soporte de Intercom.

Este error debe ser resuelto por Meta Support y no puede ser solucionado dentro de Intercom.

Error completo: "Solicitud get no soportada. El objeto con ID XXXXXXXXXXXX no existe, no puede cargarse debido a permisos faltantes, o no soporta esta operación"

Cuando intentes conectar un número, asegúrate de que el código que se te muestra sea un ID de cuenta de WhatsApp.

Esto suele ser señalado por Meta debido a cualquier error de migración telefónica. Consulta la documentación de Meta para más detalles.

Además, si encuentras el siguiente error: Tipo: OAuthException Código: 1 Error_subcode: 23881 Mensaje: Parámetro inválido Error_user_title: No se puede crear el certificado Error_user_msg: Tu negocio no cumple con los requisitos de la política de WhatsApp. Si crees que tu negocio califica, contacta con Soporte de Meta Business Suite. La documentación oficial está disponible aquí.

Si encuentras un mensaje de error como "(#1) Error de parámetro" al conectar tu número de WhatsApp: Toma una captura de pantalla del mensaje de error. A menudo, resolver esto requiere soporte de Meta. Confirma que todas las configuraciones en Meta e Intercom estén correctas antes de contactar.

Ejemplos:

Estos errores indican que tu negocio puede no cumplir con los estándares de política de WhatsApp. Si crees que tu negocio califica, contacta con Soporte de Meta Business Suite. La documentación oficial está disponible aquí.

Toma una captura de pantalla y revisa tus configuraciones. La mayoría de los errores de parámetro provienen del lado de Meta y deben resolverse a través de Soporte de Meta.

Este mensaje de error significa que el número de valores de parámetros variables que incluiste en tu solicitud de mensaje de WhatsApp no coincide con el número de parámetros variables definidos en tu plantilla de WhatsApp. Debes editar tu plantilla y agregar valores para todas las variables.

Sigue estos pasos:

Nota: Cerrar la ventana emergente en el momento correcto es esencial para evitar este error. Esta es la ventana que debes cerrar 👇

Si ves el error:

“Tu cuenta comercial tiene una acción pendiente, debes completarla antes de enviar”

Esto significa que Meta (WhatsApp Business Manager) está bloqueando el envío de mensajes porque tu Cuenta de WhatsApp Business (WABA) o la configuración del número de teléfono no están completamente terminadas/verificadas en Meta.

En tales casos, dirígete a la configuración en Meta para verificar los siguientes pasos requeridos.

Verifica:

Intercom requiere que las plantillas usen marcadores numéricos (por ejemplo, {{1}}) en lugar de descriptivos como {{sf_full_name}}. Ejemplo: Hola {{1}}, su pedido {{2}} ha sido enviado.

Si sus plantillas que usan variables como {{sf_full_name}} fallan, edite su plantilla en Meta para reemplazar los marcadores descriptivos por numéricos y así mapearlos en Intercom. Esto asegura compatibilidad entre WhatsApp e Intercom al mapear variables directamente a atributos de Intercom.

Para asegurar que las plantillas permanezcan no comerciales:

WhatsApp no pudo entregar este mensaje porque la cuenta de WhatsApp del destinatario no puede recibir mensajes actualmente. Esto puede ocurrir si el número de teléfono no está registrado en WhatsApp, si el destinatario no ha aceptado los últimos Términos de Servicio o Política de Privacidad de WhatsApp, o si está usando una versión desactualizada de la app de WhatsApp (las versiones mínimas requeridas incluyen Android/SMBA 2.21.15.15, iOS/SMBI 2.21.170.4, KaiOS 2.2130.10 y Web 2.2132.6). Factores adicionales que podrían bloquear la entrega incluyen que la cuenta del destinatario haya sido marcada por Meta debido a acciones pendientes o a exceder los límites de frecuencia de mensajes.

Para resolver el problema, pida al destinatario por otro canal de comunicación (como SMS, correo electrónico o teléfono) que confirme que puede enviar un mensaje a su número de WhatsApp Business, acepte cualquier aviso pendiente de Términos de Servicio yendo a Configuración > Ayuda o Configuración > Información de la aplicación, y actualice su cliente de WhatsApp a la última versión.

Una vez que completen estos pasos, WhatsApp debería poder entregar sus mensajes con éxito.

Este mensaje no fue entregado porque WhatsApp lo bloqueó para mantener un ecosistema saludable, lo que generalmente significa que el destinatario alcanzó un límite en la cantidad de mensajes de plantilla de marketing que puede recibir en un período determinado.

Si sospecha que esta es la causa, la mejor acción es esperar al menos 24 horas antes de intentar reenviar el mensaje de plantilla. Enviarlo antes probablemente resultará en el mismo error, ya que el límite puede permanecer activo por diferentes períodos. La duración para levantar el límite puede variar, así que consulte la documentación de WhatsApp para orientación sobre los tiempos específicos de reinicio.

Este mensaje no fue enviado como parte de un experimento. Para más detalles sobre experimentos, consulte la documentación del experimento de mensajes de marketing de WhatsApp.

Este mensaje no pudo ser entregado porque WhatsApp no pudo subir el medio incluido, lo que suele ocurrir cuando el archivo usa un formato no soportado o no cumple con los requisitos de medios de WhatsApp.

Para resolver esto, revise el archivo multimedia que intenta enviar y confirme que su formato y tamaño son compatibles con WhatsApp. Una vez que el medio cumpla con los requisitos de WhatsApp, debería poder reenviar el mensaje con éxito.

Este mensaje no pudo ser entregado porque han pasado más de 24 horas desde que el destinatario respondió por última vez a su número de WhatsApp, y WhatsApp solo permite mensajes libres dentro de esa ventana activa de 24 horas. Este error también puede ocurrir si el número de teléfono del destinatario cambió durante la conversación, lo que efectivamente reinicia la sesión.

Para continuar enviando mensajes, deberá enviar un mensaje de plantilla aprobado por WhatsApp. Una vez que el destinatario responda, la ventana de 24 horas se reabrirá y podrá enviar mensajes libres nuevamente.

Este mensaje no pudo ser entregado porque la cuenta de WhatsApp Business conectada a su aplicación ha sido restringida o deshabilitada. Esto suele ocurrir cuando WhatsApp detecta una violación de sus políticas de plataforma, o cuando los detalles en la solicitud no pueden verificarse con la configuración de la cuenta, por ejemplo, un PIN incorrecto de verificación en dos pasos.

Para resolver esto, revise las directrices de aplicación de políticas de WhatsApp para entender el tipo de violación y los pasos necesarios para restaurar la cuenta. También puede consultar la API de estado de salud de WhatsApp para obtener información más específica sobre por qué la cuenta fue bloqueada o restringida. Una vez que se resuelva el problema subyacente, la entrega de mensajes debería reanudarse normalmente.