Este error aparece cuando el número de teléfono se usó previamente con otro proveedor de WhatsApp Business API o con la aplicación móvil/negocios de WhatsApp. Si el número se usó en la aplicación 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 aplicación 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 con Soporte con su:

Podemos intentar una conexión manual.

Abra las herramientas de desarrollo de su navegador (presione F12, o haga clic derecho en la página y seleccione Inspeccionar), luego navegue a la pestaña Consola para ver el mensaje de error completo.

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 comercial 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 algunos 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:

Esto ocurre cuando su WhatsApp Business Account (WABA) no se compartió con Intercom durante el registro integrado de Meta, por lo que Intercom no puede acceder a ella. Vuelva a ejecutar el flujo de conexión y asegúrese de otorgar acceso a Intercom al WABA cuando se le solicite. Si el error persiste, contacte con Soporte de Intercom con su ID de WABA.

Asegúrese de que su número de WhatsApp esté conectado en la página de instalación. Si no lo está, complete primero el flujo de configuración de WhatsApp. Una vez conectado, desactive la autenticación de dos factores en WhatsApp (vea la nota a continuación), luego intente crear el certificado nuevamente.

Verifica que el número de teléfono esté completamente aprobado en Meta Business Manager. Si hay pasos de revisión pendientes o requisitos de aprobación para el número, complétalos antes de reintentar en Intercom.

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

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

Este error debe ser resuelto por Meta Support y no puede ser corregido 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 en la migración del teléfono. 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 política de WhatsApp. Si crees que tu negocio califica, contacta con Meta Business Suite Support. La documentación oficial está disponible aquí.

Si encuentras un (#1) Error de Parámetro al conectar tu número, consulta la sección dedicada a continuación.

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 Meta Business Suite Support. La documentación oficial está disponible aquí.

Para solucionar este error:

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. Cierra la ventana emergente de creación de la Cuenta de WhatsApp Business que se muestra a continuación después de que se cree la cuenta, pero antes de agregar tu número de teléfono:

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 completadas/verificadas en el lado de Meta.

Ve a tu cuenta de Meta Business Manager, navega a WhatsApp Accounts y verifica si hay acciones pendientes señaladas en tu Cuenta de WhatsApp Business (WABA) o número de teléfono. Completa los pasos de verificación pendientes y luego intenta enviar tu mensaje nuevamente.

Antes de contactar con soporte, verifica lo siguiente: las plantillas que no aparecen en Intercom suelen fallar en alguna de estas comprobaciones:

WhatsApp requiere que las plantillas usen marcadores numéricos (por ejemplo, {{1}}) en lugar de descriptivos como {{sf_full_name}}. Ejemplo: Hola {{1}}, tu pedido {{2}} ha sido enviado. Intercom los asigna posicionalmente a tus atributos.

Si tus plantillas con variables como {{sf_full_name}} fallan, edita la plantilla en Meta para reemplazar los marcadores descriptivos por numéricos y asígnalos en Intercom. Esto asegura compatibilidad entre WhatsApp e Intercom al mapear variables directamente a atributos de Intercom.

Para asegurar que las plantillas no sean de marketing:

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 la Política de Privacidad de WhatsApp, o si usa una versión desactualizada de WhatsApp (los requisitos mínimos de versión están en la tabla a continuación). Otros factores que pueden bloquear la entrega incluyen que la cuenta del destinatario esté señalada por Meta debido a acciones pendientes o que se hayan superado los límites de frecuencia de mensajes. Intercom lo identifica como código de error 131026, mostrado como "mensaje no entregable" o "receptor incapaz."

Para resolver el problema, pide al destinatario por otro canal de comunicación (como SMS, correo electrónico o teléfono) que confirme que puede enviar un mensaje a tu 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 complete estos pasos, WhatsApp debería poder entregar tus 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. Intercom identifica esto como código de error 131049 (compromiso del ecosistema). Para pasos de solución y tiempos de reinicio, consulta la guía de solución de fallos de mensajes de WhatsApp.

Si sospechas 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 de frecuencia puede variar, así que consulta la documentación de WhatsApp para obtener 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, consulta 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 compatible o no cumple con los requisitos de medios de WhatsApp.

Para resolver esto, revisa el archivo multimedia que intentas enviar y confirma que su formato y tamaño son compatibles con WhatsApp. Una vez que el medio cumpla con los requisitos de WhatsApp, deberías 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 tu número de WhatsApp, y WhatsApp solo permite mensajes libres dentro de esa ventana activa de conversación 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, necesitarás enviar un mensaje de plantilla aprobado por WhatsApp en su lugar. Una vez que el destinatario responda, la ventana de 24 horas se reabrirá y se podrán enviar mensajes libres nuevamente.

Este mensaje no pudo ser entregado porque la cuenta de WhatsApp Business conectada a tu 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, revisa 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 puedes 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 aborde el problema subyacente, la entrega de mensajes debería reanudarse normalmente.