> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticación con un solo toque

> Usa la experiencia de autenticación con un solo toque con la plantilla y el flujo de verificación requeridos.

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.

<Frame caption="Autofill passes the code to an eligible Android app. Your backend still verifies it.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/meta-authentication-autofill-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=7a0bfcec572f7fdfe2cce0cf18f175d7" alt="Ejemplo de autenticación de Meta con el botón de autocompletado indicado." width={360} data-path="product-assets/english-help-2026-09-22/meta-authentication-autofill-annotated.svg" />
</Frame>

Fuente: [Ejemplo oficial de Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates/).

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:

| Elemento | Propósito |
| - | - |
| Nombre del paquete de Android | Identifica la aplicación de destino. |
| Hash de la clave de firma de la app | Identifica la compilación firmada que tiene permiso para recibir el código. |
| Configuración de aplicaciones compatibles | Registra los pares de paquete y hash de firma permitidos en la plantilla. |
| Protocolo de enlace requerido | Establece la elegibilidad de la app antes de la entrega del código. |
| Receptor de código y verificación en el backend | Captura el resultado y valida la acción solicitada. |

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](/es/api-reference/guides/whatsapp-platform/manage-whatsapp-templates) 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](/es/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/copy-code-authentication#send-the-same-code-in-both-positions).

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.

<a id="limitations" />

## 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](https://developers.facebook.com/docs/whatsapp/business-management-api/authentication-templates/) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.