Agrega la verificación del número de teléfono de Firebase a tu app para Android

1. Descripción general

La Verificación de número de teléfono de Firebase (Firebase PNV o FPNV) es un método más rápido y seguro para verificar números de teléfono. A diferencia de la verificación basada en SMS, que requiere que los usuarios finales reciban e ingresen un código de un mensaje de texto, Firebase PNV funciona obteniendo el número de teléfono asignado a la SIM del dispositivo directamente del operador conectado con un solo toque. Esto reduce la fricción para el usuario final, mejora la confiabilidad al no depender de la entrega de mensajes SMS y elimina los vectores de abuso que se suelen explotar cuando se usan SMS.

Diálogo emergente de PNV de Firebase

En este codelab, aprenderás a compilar un agente de voz de IA "Restaurant Finder" que usa la Verificación de número de teléfono de Firebase para verificar el número de teléfono del usuario final antes de confirmar una reserva de mesa.

Requisitos previos

  • La versión más reciente de Android Studio
  • Un dispositivo o emulador Android con el nivel de API 26 o superior

Qué aprenderás

  • Configurar un proyecto de Firebase con Firebase PNV
  • Usar Firebase PNV en modo de prueba para crear prototipos sin una cuenta de facturación ni una SIM real
  • Integrar el SDK de Firebase PNV en una app para Android
  • Verificar un número de teléfono con la API de una sola llamada
  • (Opcional) Preparar tu app para producción

2. Configura el proyecto de muestra

Crea un proyecto de Firebase

  1. Accede a la Firebase console con tu Cuenta de Google.
  2. Haz clic en el botón para crear un proyecto nuevo y, luego, ingresa un nombre de proyecto (por ejemplo, Tera Bites).
  3. Haz clic en Continuar.
  4. Si se te solicita, revisa y acepta las condiciones de Firebase y, luego, haz clic en Continuar.
  5. (Opcional) Habilita la asistencia de IA en Firebase console (llamada "Gemini en Firebase").
  6. Para este codelab, no necesitas Google Analytics, por lo que debes desactivar la opción de Google Analytics.
  7. Haz clic en Crear proyecto, espera a que se aprovisione el proyecto y, luego, haz clic en Continuar.

Descarga el código

Ejecuta los siguientes comandos para clonar el código de muestra de este codelab:

git clone https://github.com/GoogleCloudPlatform/devrel-demos
cd codelabs/firebase-pnv-android

Abre el directorio firebase-pnv-android en Android Studio.

Conecta tu proyecto de Android a Firebase

  1. En Firebase console, en el centro de la página de descripción general del proyecto, haz clic en el ícono de Android o en Agregar app para iniciar el flujo de trabajo de creación de apps.
  2. En el campo Nombre del paquete de Android, ingresa el nombre del paquete de la app: com.google.firebase.example.fpnv.
  3. Haz clic en Registrar app.
  4. Sigue las instrucciones para descargar el archivo google-services.json y muévelo al directorio app/ del código que acabas de descargar.
  5. Haz clic en Siguiente.

Habilita Firebase AI Logic

En este codelab, se usa Firebase AI Logic para potenciar el agente de voz de IA. Para habilitar Firebase AI Logic en tu proyecto de Firebase, haz lo siguiente:

  1. En Firebase console, ve a Servicios de IA > AI Logic.
  2. Haz clic en Comenzar.
  3. Para usar la API de Gemini Developer , haz clic en Comenzar con esta API.
  4. Continúa con el resto de los pasos del flujo de trabajo de configuración guiada.

3. Configura Firebase PNV en modo de prueba

El modo de prueba te permite verificar un número de teléfono "falso" con un token de prueba para el desarrollo.

Únete al programa beta público de los servicios del sistema de Google

Inscribe tu dispositivo de desarrollo en el canal beta de los servicios del sistema de Google para usar el modo de prueba:

  1. Navega a la página Pruebas de apps para Android: servicios del sistema de Google.
  2. Haz clic en Convertirme en verificador.

Ahora eres un verificador beta de los servicios del sistema de Google.

Agrega la dependencia de Firebase PNV

En la base de código de tu proyecto de Android, las dependencias de las bibliotecas de Firebase PNV y Firebase AI Logic ya están definidas en el archivo /gradle/versions.toml:

[versions]
# ... other dependencies
firebaseBom = "34.13.0"

[libraries]
# ... other libraries
firebase-bom = { module = "com.google.firebase:firebase-bom", version.ref = "firebaseBom" }
firebase-ai-logic = { module = "com.google.firebase:firebase-ai" }
firebase-pnv = { module = "com.google.firebase:firebase-pnv" }

En el archivo Gradle (generalmente /app/build.gradle.kts) de tu módulo (a nivel de app), declara la dependencia de la biblioteca de Firebase PNV:

dependencies {
  // ... other dependencies
  implementation(platform(libs.firebase.bom))
  implementation(libs.firebase.ai.logic)

  // Add this line
  implementation(libs.firebase.pnv)

  // ...
}

Genera un token de prueba

  1. En Firebase console, ve a Seguridad > Verificación de teléfono.
  2. Selecciona la pestaña Pruebas.
  3. Selecciona el código de país de tu número de teléfono de prueba y haz clic en Generar token.
  4. Copia la cadena de token generada.

Habilita la sesión de prueba en tu código

  1. Vuelve a tu proyecto de Android, abre el archivo ChatViewModel.kt y busca la función verifyPhoneNumber().
  2. Inicializa el cliente FirebasePhoneNumberVerification y habilita la sesión de prueba. Para ello, pega el token que copiaste de Firebase console:
    suspend fun verifyPhoneNumber(): String {
    // Initialize Firebase Phone Number Verification
    val fpnv = FirebasePhoneNumberVerification.getInstance()

    // Enable Test session
    fpnv.enableTestSession("PASTE_THE_TOKEN_YOU_COPIED_IN_PREV_STEP")

    // Trigger the Firebase PNV pop up
    val response = fpnv.getVerifiedPhoneNumber(context!!).await()
    val phoneNumber = response.getPhoneNumber()

    return phoneNumber
}

4. Ejecuta la app

Ahora que implementaste Firebase PNV, es hora de ejecutar la app.

  1. En Android Studio, haz clic en Ejecutar para iniciar la app en el emulador de Android o en un dispositivo físico.
  2. Una vez que se inicie la app, deberías ver una pantalla como esta:
    App de PNV de Firebase en ejecución
  3. Haz clic en Iniciar llamada y preséntate.
    App de PNV de Firebase en ejecución
  4. El agente de voz de IA debería solicitarte los detalles de la reserva. Una vez que proporciones los detalles, debería solicitarte que mires la pantalla para verificar tu número de teléfono:
    App de PNV de Firebase en ejecución
  5. Una vez que lo hagas, verás una pantalla de verificación completa:
    App de PNV de Firebase en ejecución
  6. Haz clic en Finalizar sesión para terminar la llamada.

5. (Opcional) Actualiza al modo de producción

Actualiza tu plan de precios de Firebase

Para usar Firebase PNV en modo de producción, tu proyecto de Firebase debe tener el plan de precios de pago por uso (Blaze), lo que significa que está vinculado a una cuenta de Facturación de Cloud.

  • Una cuenta de Facturación de Cloud requiere una forma de pago, como una tarjeta de crédito.
  • Durante las promociones especiales o si realizas este codelab como parte de un evento, es posible que haya créditos de Google Cloud disponibles.
  • Si es la primera vez que usas Firebase y Google Cloud, verifica si cumples con los requisitos para obtener un crédito de$300 y una cuenta de Facturación de Cloud de prueba gratuita.

Para actualizar tu proyecto al plan Blaze, sigue estos pasos:

  1. En Firebase console, selecciona la opción para actualizar tu plan.
  2. Selecciona el plan Blaze. Sigue las instrucciones en pantalla para vincular una cuenta de Facturación de Cloud a tu proyecto.
    • Si usas créditos de Google Cloud para este codelab, es probable que la cuenta de facturación se llame Google Cloud Platform Trial Billing Account o My Billing Account.
    • Si necesitas crear una cuenta de Facturación de Cloud como parte de esta actualización, es posible que debas volver a la actualización. en Firebase console para completar la actualización.

Habilita el modo de producción de Firebase PNV

  1. Agrega la huella digital SHA-256 de tu app:
    1. En Firebase console, ve a la página Configuración > General.
    2. Desplázate hacia abajo hasta la tarjeta Tus apps y busca tu app para Android.
    3. En el campo Huellas digitales del certificado SHA, agrega tu huella digital SHA-256. Consulta Autenticación de tu cliente para obtener detalles sobre cómo obtener la huella digital SHA-256 de tu app.
  2. Vuelve a Seguridad > Verificación de teléfono.
  3. Haz clic en Configurar producción. Verás una lista de las apps de tu proyecto que se habilitarán para producción y tendrás la oportunidad de agregar apps adicionales.
  4. Envía tu app para la verificación de marca de OAuth y la revisión de cumplimiento de la política de privacidad. Google Cloud verificará que identifiques de forma clara y precisa tu app y su política de privacidad.
    Para comenzar la revisión, haz clic en Continuar en Google Cloud. Este proceso a veces puede tardar 24 horas o más.
  5. Mientras esperas la verificación de marca, revisa las condiciones específicas del servicio de Firebase PNV, que están vinculadas en la consola.
  6. Una vez que tu app haya pasado la verificación de marca, marca la casilla para aceptar las condiciones específicas del servicio y, luego, haz clic en Habilitar.

Firebase PNV ahora está activo en modo de producción.

Quita el código de prueba

En tu proyecto de Android, borra la línea fpnv.enableTestSession(...).

Migra Firebase AI Logic para usar Vertex AI

Si usas créditos en tu cuenta de facturación, no podrás usarlos con la API de Gemini Developer. Sin embargo, puedes usarlos con la API de Gemini de Vertex AI.

  1. En Firebase console, ve a Servicios de IA > AI Logic.
  2. Haz clic en Configuración.
  3. En API de Gemini de Vertex AI, haz clic en Habilitar.
  4. En tu proyecto de Android, cambia la inicialización de Firebase AI Logic para usar el backend de Vertex AI en lugar de la IA de Google:
    val model = Firebase.ai(
    backend = GenerativeBackend.vertexAI(location = "us-central1")
).liveModel(
    modelName = "gemini-live-2.5-flash-native-audio",
    // ... other configuration
)

6. ¡Felicitaciones!

Integra correctamente la Verificación de número de teléfono de Firebase en una app para Android.

Temas abordados

  • Cómo configurar un proyecto para Firebase PNV
  • Cómo usar el modo de prueba para la creación de prototipos
  • Cómo implementar la API de una sola llamada de Firebase PNV
  • Cómo actualizar al modo de producción

Próximos pasos