Skip to main content
La autenticación con un solo toque permite que un cliente compatible con Android toque una acción de autocompletado para transferir el código de verificación a tu aplicación. Reduce el copiado manual, pero aún requiere una integración en la aplicación y verificación en el servidor.
Ejemplo de autenticación de Meta con el botón de autocompletado indicado.

Autofill passes the code to an eligible Android app. Your backend still verifies it.

Fuente: Ejemplo oficial de Meta. Elegir la opción de plantilla en YCloud no instala la integración en tu aplicación de Android.

Preparar la integración de Android

El equipo de tu aplicación necesita: Usa la identidad de la compilación que los clientes realmente instalan. Una compilación de depuración y una de producción pueden usar claves de firma distintas, por lo que una prueba que funcione localmente no garantiza que la aplicación distribuida en la tienda funcione. El contrato actual de YCloud utiliza supported_apps. Los campos de nivel superior más antiguos package_name y signature_hash están obsoletos; no los uses para una integración nueva.

Crear la plantilla

  1. Selecciona la WABA y la categoría Authentication .
  2. Elige la opción de un toque/autocompletado.
  3. Introduce la identidad de la aplicación de Android compatible y los ajustes de botón requeridos.
  4. Configura los avisos opcionales de seguridad y caducidad.
  5. Envía la solicitud y espera la aprobación.
  6. Conecta la plantilla de mensaje aprobada a la solicitud de verificación de tu aplicación.
Para la creación mediante API, usa el tipo de botón OTP con otp_type: "ONE_TAP" y la configuración de aplicaciones compatibles. Consulta Administrar plantillas para ver el contrato completo.

Ejecutar el flujo del cliente

Cuando el cliente solicite la verificación por WhatsApp, inicia el protocolo de enlace requerido en la aplicación, envía la plantilla de mensaje de autenticación aprobada, recibe el código mediante la interacción compatible y valídalo frente a la solicitud activa. Proporciona el mismo código en el cuerpo de la plantilla y en el parámetro del botón URL de OTP. El patrón del parámetro en el momento del envío se muestra en Autenticación con copia de código. Vincula el código a la sesión y acción previstas. Un valor autocompletado es solo una entrada, no una decisión de autorización.

Mantener funcional la alternativa secundaria

El cliente puede recibir una experiencia de copia de código cuando no se cumplen los requisitos de autocompletado. Los clientes que no usan Android no reciben esta integración con la aplicación de Android. Prueba:
  • Una aplicación de producción firmada correctamente.
  • Una compilación de depuración o con una firma diferente.
  • La aplicación de destino no instalada.
  • Un protocolo de enlace ausente o fallido.
  • Un código caducado o ya utilizado.
  • Un dispositivo que no sea Android.
En iOS 26 y versiones posteriores, las notificaciones push de autenticación de WhatsApp pueden ofrecer sugerencias nativas en el teclado. Esa función de la plataforma no prueba que la integración de Android esté funcionando.

Planificar la migración del SDK actual

El aviso actual de Meta amplía la obsolescencia del método de enlace PendingIntent hasta el 15 de octubre de 2026 y recomienda la ruta de migración al SDK de Android para OTP. Revisa las integraciones existentes antes de esa fecha límite; una plantilla aprobada previamente no migra el código de la aplicación. Para la implementación, usa la Guía de autenticación de Meta y sus instrucciones de integración de Android vinculadas. Realiza un seguimiento por separado de la entrega de mensajes, la captura de códigos y la verificación correcta. Si los mensajes llegan pero solo aparece la acción de copiar, inspecciona la identidad de la aplicación y la elegibilidad del protocolo de enlace antes de modificar el cuerpo del mensaje.