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

# Plantillas de autenticación de WhatsApp para códigos

> Cómo envían códigos las plantillas de autenticación: texto fijo, botones de copiar código, un toque y cero toques, tiempo de vida y envío desde Flowella.

Una plantilla de autenticación envía un código de un solo uso para iniciar sesión, recuperar una cuenta o confirmar una transacción. Es la única categoría que puede llevar un código, y la más estricta: Meta fija el texto, tú solo añades el código y, si quieres, las líneas de seguridad y de caducidad, y el mensaje incluye un botón que copia o rellena el código.

> [!NOTE]
>
> **En Flowella.** Compatible en parte. Flowella puede enviar plantillas de autenticación mediante la [API de Flowella](https://knowledge.flowella.io/es/hubspot/workflows/authentication-otp.md), con un código distinto para cada destinatario. El editor de Flowella no puede añadir botones de código, así que crea la plantilla en WhatsApp Manager. Un workflow de HubSpot no puede enviar códigos.

## Qué contiene el mensaje

| Parte | Contenido | ¿Puedes cambiarlo? |
| - | - | - |
| Cuerpo | El texto predefinido de Meta: el código, seguido de "es tu código de verificación", traducido al idioma de la plantilla | Solo el código |
| Línea de seguridad | "Por tu seguridad, no compartas este código." | Activarla o desactivarla |
| Línea de caducidad | "Este código caduca en N minutos", de 1 a 90 minutos | Activarla o desactivarla, y el número de minutos |
| Botón | Copiar código, autocompletar con un toque o cero toques | El tipo y, para un toque, los datos de la app |

Las plantillas de autenticación no pueden contener enlaces, multimedia ni emojis, y cada variable está limitada a 15 caracteres. Usa solo dígitos y letras en el código.

## Tipos de botón

| Tipo | Cómo funciona | Dónde funciona |
| - | - | - |
| **Copiar código** | La persona toca el botón, WhatsApp copia el código y ella lo pega en tu app o tu web | En cualquier teléfono, sin trabajo por tu parte |
| **Autocompletar con un toque** | La persona toca el botón y WhatsApp pasa el código directamente a tu app de Android | Android, con cambios en tu app |
| **Cero toques** | WhatsApp pasa el código a tu app de Android sin ningún toque | Android, con cambios en tu app y aceptando las condiciones de cero toques de Meta |

En iOS 26 y posteriores, iOS ofrece el código como sugerencia del teclado a partir de la notificación, para todas las plantillas de autenticación, sin trabajo por tu parte. Las versiones anteriores de iOS no autocompletan, así que copiar código es la opción segura si no desarrollas una app nativa de Android.

> [!WARNING]
>
> Si tu app de Android inicia el intercambio de un toque o de cero toques con `PendingIntent`, pásate al OTP Android SDK de Meta antes del 31 de enero de 2027, cuando Meta retire el método `PendingIntent`.

## Dispositivos vinculados

WhatsApp entrega los mensajes de autenticación solo al teléfono principal de la persona. En los dispositivos vinculados, como WhatsApp Web o una tableta, el mensaje se oculta y se pide a la persona que mire su teléfono. No puedes desactivarlo.

## Tiempo de vida

| | Valor |
| - | - |
| Valor predeterminado de Meta | 10 minutos. Las plantillas creadas antes del 23 de octubre de 2024 tienen 30 días por defecto. |
| Rango que puedes definir | De 30 segundos a 15 minutos |

No pongas un tiempo de vida mayor que la validez de tu código, para que nadie reciba un código ya caducado. Flowella no tiene ajuste de tiempo de vida. Si necesitas un valor personalizado, defínelo en la plantilla en WhatsApp Manager.

## Precio

Los mensajes de autenticación se cobran por mensaje entregado, con [tramos por volumen](https://knowledge.flowella.io/es/whatsapp/pricing/whatsapp-pricing.md#volume-tiers-for-utility-and-authentication). En algunos mercados, Meta cobra una tarifa **authentication-international** más alta cuando una empresa elegible envía códigos a números de ese mercado. Consulta [Precios de WhatsApp](https://knowledge.flowella.io/es/whatsapp/pricing/whatsapp-pricing.md).

## Crear una en WhatsApp Manager

**1. Empieza una plantilla**

En [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates), haz clic en **Create template** y elige **Authentication**. También puedes partir de una plantilla de autenticación de la biblioteca de Meta.

**2. Elige las opciones**

Elige el tipo de botón y activa la línea de seguridad y la de caducidad si las quieres. Para un toque o cero toques, añade el nombre del paquete y el hash de firma de tu app de Android.

**3. Envíala a revisión**

Elige los idiomas y envíala. Meta redacta el texto, así que la revisión suele ser rápida.

Después, la plantilla aparece en la página **Templates** de Flowella, lista para enviarse mediante la API.

## Enviar códigos desde Flowella

Tu app genera el código, lo guarda con una caducidad y llama a `POST /v1/templates/send` con el código como variable del cuerpo y el valor del botón. Flowella rechaza un código de más de 15 caracteres antes de que llegue a Meta. Para una guía completa con reglas de reenvío y bloqueo, consulta [Enviar códigos de un solo uso](https://knowledge.flowella.io/es/hubspot/workflows/authentication-otp.md).

## Buenas prácticas

* **Confirma primero el número.** Asegúrate de que el número de WhatsApp pertenece a la persona antes de enviarle un código.
* **Avisa de que el código llegará por WhatsApp**, sobre todo si también ofreces SMS o correo electrónico.
* **Muestra que lo has recibido.** Cuando la persona pegue el código, o tu app lo reciba, confírmalo en pantalla.
* **No envíes códigos en plantillas de marketing o de utilidad.** Meta rechaza las plantillas que llevan códigos en la categoría equivocada a partir del primer día del mes siguiente. Consulta [Categorías de plantillas](https://knowledge.flowella.io/es/whatsapp/templates/template-categories.md#when-meta-changes-a-category-after-approval).

## Relacionado

> [card] [Enviar códigos de un solo uso](https://knowledge.flowella.io/es/hubspot/workflows/authentication-otp.md)
>
> La guía de la API de Flowella.

> [card] [Biblioteca de plantillas](https://knowledge.flowella.io/es/whatsapp/templates/template-library.md)
>
> Las plantillas listas para usar de Meta.

> [card] [Fundamentos de las plantillas](https://knowledge.flowella.io/es/whatsapp/templates/template-fundamentals.md)
>
> Nombres, idiomas, estados y límites.

> [card] [Precios de WhatsApp](https://knowledge.flowella.io/es/whatsapp/pricing/whatsapp-pricing.md)
>
> Tarifas de autenticación y la tarifa internacional.

Comprobado con la documentación de Meta el 18 de noviembre de 2026: [Authentication templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates), [Template categorization](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization) y [Time-to-live](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live).


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