> ## 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.

# Modelos de autenticação WhatsApp para códigos de acesso

> Como os modelos de autenticação WhatsApp enviam códigos: texto fixo, botões de copiar código, um toque e zero toques, time-to-live e envio pelo Flowella.

Um modelo de autenticação envia um código de acesso único, para iniciar sessão, recuperar uma conta ou confirmar uma transação. É a única categoria autorizada a conter um código de acesso, e a mais rigorosa: o texto é fixado pela Meta, só acrescenta o código e, opcionalmente, linhas de segurança e de validade, e a mensagem inclui um botão que copia ou preenche o código.

> [!NOTE]
>
> **No Flowella.** Suportado em parte. O Flowella pode enviar modelos de autenticação através da [API do Flowella](https://knowledge.flowella.io/pt/hubspot/workflows/authentication-otp.md), com um código diferente para cada destinatário. O editor do Flowella não consegue adicionar botões de código, por isso crie o modelo no WhatsApp Manager. Um workflow do HubSpot não pode enviar códigos de acesso.

## O que a mensagem contém

| Parte | Conteúdo | Pode alterá-la |
| - | - | - |
| Corpo | O texto predefinido da Meta: o código, seguido de "is your verification code", traduzido para o idioma do modelo | Apenas o código |
| Linha de segurança | "For your security, do not share this code." | Ativar ou desativar |
| Linha de validade | "This code expires in N minutes", de 1 a 90 minutos | Ativar ou desativar, e o número de minutos |
| Botão | Copiar código, preenchimento automático com um toque ou zero toques | O tipo e, para um toque, os detalhes da app |

Os modelos de autenticação não podem conter links, multimédia nem emojis, e cada variável está limitada a 15 caracteres. Use apenas algarismos e letras no código.

## Tipos de botão

| Tipo | Como funciona | Funciona em |
| - | - | - |
| **Copiar código** | A pessoa toca no botão, o WhatsApp copia o código e a pessoa cola-o na sua app ou site | Qualquer telemóvel, sem trabalho da sua parte |
| **Preenchimento com um toque** | A pessoa toca no botão e o WhatsApp entrega o código diretamente à sua app Android | Android, com alterações à sua app |
| **Zero toques** | O WhatsApp passa o código à sua app Android sem qualquer toque | Android, com alterações à sua app e os termos zero-tap da Meta aceites |

No iOS 26 e posteriores, o iOS sugere o código no teclado a partir da notificação, para todos os modelos de autenticação, sem trabalho da sua parte. As versões anteriores do iOS não preenchem automaticamente, por isso copiar código é a escolha segura quando não desenvolve uma app Android nativa.

> [!WARNING]
>
> Se a sua app Android inicia o handshake de um toque ou zero toques com `PendingIntent`, mude para o OTP Android SDK da Meta antes de 31 de janeiro de 2027, quando a Meta descontinua o método `PendingIntent`.

## Dispositivos associados

O WhatsApp entrega mensagens de autenticação apenas no telemóvel principal da pessoa. Nos dispositivos associados, como o WhatsApp Web ou um tablet, a mensagem fica oculta e é pedido à pessoa que consulte o telemóvel. Não é possível desativar isto.

## Time-to-live

| | Valor |
| - | - |
| Predefinição da Meta | 10 minutos. Os modelos criados antes de 23 de outubro de 2024 têm 30 dias por predefinição. |
| Intervalo que pode definir | 30 segundos a 15 minutos |

Defina um time-to-live que não ultrapasse a validade do código, para que ninguém receba um código já expirado. O Flowella não tem nenhuma definição de time-to-live. Se precisar de um valor personalizado, defina-o no modelo no WhatsApp Manager.

## Preço

As mensagens de autenticação são cobradas por mensagem entregue, com [escalões de volume](https://knowledge.flowella.io/pt/whatsapp/pricing/whatsapp-pricing.md#volume-tiers-for-utility-and-authentication). Em alguns mercados, a Meta cobra uma tarifa **authentication-international** mais elevada quando uma empresa elegível envia códigos para números desse mercado. Consulte [Preços do WhatsApp](https://knowledge.flowella.io/pt/whatsapp/pricing/whatsapp-pricing.md).

## Criar um no WhatsApp Manager

**1. Inicie um modelo**

No [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates), clique em **Create template** e escolha **Authentication**. Também pode começar a partir de um modelo de autenticação da biblioteca da Meta.

**2. Escolha as opções**

Escolha o tipo de botão e ative a linha de segurança e a linha de validade, se as quiser. Para um toque ou zero toques, adicione o nome do pacote e o hash de assinatura da sua app Android.

**3. Submeta**

Escolha os idiomas e submeta. A Meta escreve o texto, por isso a revisão é normalmente rápida.

O modelo aparece depois na página **Templates** do Flowella, pronto a enviar através da API.

## Enviar códigos de acesso a partir do Flowella

A sua app cria o código, guarda-o com uma validade e chama `POST /v1/templates/send` com o código como variável do corpo e o valor do botão. O Flowella recusa um código com mais de 15 caracteres antes de chegar à Meta. Para um guia completo com regras de reenvio e bloqueio, consulte [Enviar códigos de acesso únicos](https://knowledge.flowella.io/pt/hubspot/workflows/authentication-otp.md).

## Boas práticas

* **Confirme primeiro o número.** Certifique-se de que o número WhatsApp pertence à pessoa antes de lhe enviar um código.
* **Avise as pessoas de que o código chega pelo WhatsApp**, sobretudo se também oferece SMS ou email.
* **Mostre que o recebeu.** Quando a pessoa colar o código, ou a sua app o receber, confirme no ecrã.
* **Não envie códigos em modelos Marketing ou Utility.** A Meta rejeita os modelos que contêm códigos de acesso na categoria errada, a partir do primeiro dia do mês seguinte. Consulte [Categorias de modelos](https://knowledge.flowella.io/pt/whatsapp/templates/template-categories.md#when-meta-changes-a-category-after-approval).

## Relacionado

> [card] [Enviar códigos de acesso únicos](https://knowledge.flowella.io/pt/hubspot/workflows/authentication-otp.md)
>
> O guia da API do Flowella.

> [card] [Biblioteca de modelos](https://knowledge.flowella.io/pt/whatsapp/templates/template-library.md)
>
> Os modelos prontos a usar da Meta.

> [card] [Fundamentos dos modelos](https://knowledge.flowella.io/pt/whatsapp/templates/template-fundamentals.md)
>
> Nomes, idiomas, estados e limites.

> [card] [Preços do WhatsApp](https://knowledge.flowella.io/pt/whatsapp/pricing/whatsapp-pricing.md)
>
> Tarifas de autenticação e a tarifa internacional.

Verificado com a documentação da Meta a 18 de novembro 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) e [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.