Iniciar sesiónEmpezar prueba gratis
Meta Tech Provider

Enviar códigos de verificación (OTP) por WhatsApp

Para enviar un código de verificación (OTP) por WhatsApp, una empresa crea una plantilla de autenticación con el formato fijo de Meta, "<código> es tu código de verificación.", y un botón de copiar código o de un toque. Su backend la envía a través de la Cloud API con el código incluido dos veces, en el cuerpo y en el botón. Los códigos admiten hasta 15 caracteres, y el aviso opcional de caducidad va de 1 a 90 minutos.

easyCoexistence conecta tu número de WhatsApp Business con la Cloud API de Meta mediante Coexistencia y da a tu backend lo que necesita para enviar plantillas de autenticación: el endpoint de envío, el token de acceso y, a través de tu IA, create_template y get_template_status.

15 characters

Parámetro más largo que admite una plantilla de autenticación; no se permiten URL, archivos multimedia ni emojis en su contenido ni en sus parámetros.

1 to 90 minutes

Rango de code_expiration_minutes, que añade al mensaje la línea "Este código caduca en N minutos."

10 minutes

Tiempo de vida (TTL) predeterminado de una plantilla de autenticación; se puede configurar entre 30 segundos y 15 minutos.

131062

Error que se devuelve cuando una plantilla de autenticación se envía a un ID de usuario con alcance de empresa en lugar de a un número de teléfono.

Primary device

Los mensajes de autenticación solo se entregan en el dispositivo principal de WhatsApp del usuario; los dispositivos vinculados muestran un aviso en su lugar.

20 msg/s

Throughput fijo de un número en Coexistencia, el límite para una ráfaga de códigos de inicio de sesión.

¿Qué es una plantilla de autenticación de WhatsApp?

Es el único formato que Meta permite para contraseñas de un solo uso y códigos de verificación: si una app ofrece códigos por WhatsApp, debe usarlo, y las plantillas de utilidad o de marketing no pueden llevar un código. El texto es fijo, "<código> es tu código de verificación.", con dos líneas opcionales: "Por tu seguridad, no compartas este código." y "Este código caduca en <N> minutos." Lo que tú eliges es el botón. WhatsApp desactiva el reenvío de estos mensajes, y en iOS 26 y versiones posteriores el código también aparece como sugerencia del teclado sin que tengas que hacer nada.

Copy codeTapping copies the code to the clipboard; the user pastes it in your app or site
One-tap autofillAndroid: the button opens your app and hands it the code; needs app changes and a handshake
Zero-tapAndroid only, no button: your app receives the code through a broadcast receiver

¿Cómo se crea la plantilla de autenticación?

Elígela en la Biblioteca de plantillas de WhatsApp Manager o envíala por la API; tu IA puede hacerlo con create_template y la categoría AUTHENTICATION. No envías texto para el cuerpo: Meta lo redacta a partir de tu configuración, en el idioma que elijas, y al crearla convierte el botón OTP en un botón de URL. Se necesita una plantilla por idioma. El create_template del conector no pasa message_send_ttl_seconds, así que se aplica el tiempo de vida predeterminado de 10 minutos, salvo que lo cambies mediante la API de Meta.

create_template arguments for a copy-code template
{
  "connection_id": "<from list_numbers>",
  "name": "login_code",
  "language": "en_US",
  "category": "AUTHENTICATION",
  "components": [
    { "type": "BODY", "add_security_recommendation": true },
    { "type": "FOOTER", "code_expiration_minutes": 5 },
    { "type": "BUTTONS", "buttons": [
      { "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" }
    ]}
  ]
}

¿Cómo envía el código tu backend?

Con una petición al endpoint /messages del número por cada código, usando el token de acceso de get_api_credentials o de la tarjeta «Conecta tu propio sistema» del panel. El mismo código va dos veces, en el parámetro del cuerpo y en el parámetro del botón de URL con índice 0, y el destinatario tiene que ser un número de teléfono. Antes de enviarlo, el backend genera el código y guarda un hash del mismo con una hora de caducidad y un contador de intentos; después compara lo que escribe el usuario con ese hash.

Sending a login code from your backend
POST https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>

{
  "messaging_product": "whatsapp",
  "to": "5511987654321",
  "type": "template",
  "template": {
    "name": "login_code",
    "language": { "code": "en_US" },
    "components": [
      { "type": "body",
        "parameters": [{ "type": "text", "text": "482913" }] },
      { "type": "button", "sub_type": "url", "index": "0",
        "parameters": [{ "type": "text", "text": "482913" }] }
    ]
  }
}

¿Por qué el código sale de tu backend y no de una automatización?

Porque el sistema que inicia la sesión del usuario es el que debe crear el código, recordarlo y comprobarlo, y solo ese sistema sabe cuándo hace falta un código. Las automatizaciones responden a los mensajes que envían los clientes, y una pantalla de inicio de sesión nunca escribe a tu número. La propia plantilla también las descarta: el botón OTP lleva el código como variable de botón, y el paso Enviar una plantilla solo rellena variables del cuerpo, así que no puede enviar una plantilla de autenticación. Tu IA sí puede enviar una mediante send_template, que pasa componentes de botón a Meta, pero eso sirve para una prueba, no para un flujo de inicio de sesión.

¿Qué hace seguro un flujo OTP por WhatsApp?

Las buenas prácticas de Meta y los límites del formato llevan a la misma lista de comprobación. Nada de esto requiere más que tu backend y la Cloud API:

  • Confirma el número de WhatsApp con el usuario antes del primer código, y avísale de que el código llegará por WhatsApp.
  • Fija el tiempo de vida igual o por debajo de la caducidad del código, para que una entrega tardía nunca muestre un código ya caducado.
  • Limita los intentos y los reenvíos por número, e invalida los códigos tras su primer uso.
  • No hagas del código de WhatsApp el único factor para recuperar una cuenta: un número de teléfono reciclado todavía puede llegar a una cuenta antigua de WhatsApp.
  • Vigila el webhook de estado y ofrece SMS o correo electrónico cuando un código no se entregue.

¿Qué cambia cuando el número también se usa en la app de WhatsApp Business?

El envío funciona igual que en cualquier número de la Cloud API, hasta 20 mensajes por segundo. Meta refleja en los chats de la app los mensajes enviados por la API, así que en un número en Coexistencia los códigos que envías también aparecen en esos chats del teléfono de la empresa; deja ese teléfono en manos de personas de confianza o envía los códigos desde otro número. Las buenas prácticas de Meta también piden que cada empresa envíe las plantillas de autenticación desde su propio número, nunca desde uno compartido entre empresas. La autenticación es una categoría de plantilla de pago, facturada por mensaje entregado según el país del destinatario, con tarifas de autenticación internacional aparte en algunos mercados; easyCoexistence no añade ningún margen.

Cómo configurarlo

  1. Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
  2. Create the authentication templateAsk your AI to submit login_code with create_template, category AUTHENTICATION, a copy-code button and an expiry, then check get_template_status for APPROVED.
  3. Store the credentials on your serverCall get_api_credentials or open "Plug in your own system" in the dashboard, and put the Send endpoint and access token in your backend's secrets.
  4. Build generate, send and verifyGenerate the code, store its hash with an expiry, send the template with the code in the body and button, then check the user's entry against the hash.
  5. Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.

Errores comunes

  • Escribir el código en una plantilla de utilidad como "Tu código es {{1}}". Meta solo permite códigos en plantillas de autenticación y rechaza las de utilidad o de marketing que detecte con ellos.
  • Enviar el código solo en el cuerpo. El botón de copiar código necesita el mismo valor como parámetro; Meta espera el código dos veces en la petición.
  • Mantener un tiempo de vida de 30 días en una plantilla de autenticación antigua. Un teléfono que pasa una hora sin conexión recibe entonces un código caducado; fíjalo igual o por debajo de la caducidad del código.
  • Enviar el código a un ID de usuario con alcance de empresa. Las plantillas de autenticación solo se envían a números de teléfono, y Meta devuelve el error 131062.
Hacerlo con EasyCoexistence

El número se supervisa 24/7, así que, si una desconexión fuera a detener los códigos de inicio de sesión, te llega un aviso por correo. De US$ 9 a US$ 0.75 por número al mes, un precio que baja a medida que añades números, con los primeros 3 días gratis.

Preguntas frecuentes

¿Es más barato un código OTP por WhatsApp que uno por SMS?

Depende del país. Meta cobra cada mensaje de autenticación entregado según su tarifa para el país del destinatario, con tarifas especiales en algunos mercados, y los precios de los SMS varían según la operadora y la ruta. Antes de cambiar, compara la tabla de tarifas de Meta con la de tu proveedor de SMS en tus principales países.

¿Es lo mismo que el PIN de verificación en dos pasos de WhatsApp?

No. La verificación en dos pasos es el PIN de seis dígitos que protege el propio número de WhatsApp de la empresa. Una plantilla de autenticación envía un código a tus clientes para que tu app o tu web pueda confirmar quiénes son.

¿Los usuarios tienen que dar su consentimiento para recibir códigos?

Sí. La política de Meta exige permiso antes de que una empresa escriba a alguien, y su guía de OTP recomienda dejar elegir el canal, como WhatsApp, SMS o correo electrónico. Elegir WhatsApp en tu pantalla de inicio de sesión, junto al número, es ese permiso.

¿Una agencia puede enviar códigos de varios clientes desde un mismo número?

No. Las buenas prácticas de Meta exigen que cada empresa tenga su propia cuenta de WhatsApp Business y su propio número para las plantillas de autenticación; compartir uno entre empresas va contra las condiciones y la política de Meta. En su lugar, conecta un número por cliente.

Sigue leyendo

¿Listo para empezar?

Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.

Empezar prueba gratis

Verificado el