> ## 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.
# Autenticação por cópia de código
> Use a experiência de autenticação por cópia de código com o modelo e fluxo de verificação necessários.
A autenticação por cópia de código permite que o cliente copie um código de verificação do WhatsApp e o insira no seu aplicativo.
Fonte: [Exemplo oficial da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates/).
O WhatsApp entrega o código. Seu backend o cria, valida, expira e decide se a ação solicitada está autorizada.
## Criar o modelo de autenticação
1. Abra **Modelos**, selecione a WABA e crie um modelo de **Autenticação** .
2. Escolha a opção de cópia de código.
3. Decida se deseja incluir a recomendação de segurança e o aviso de expiração.
4. Defina um aviso de expiração que corresponda à política de verificação pretendida.
5. Envie o modelo e confirme a aprovação para o idioma desejado.
A autenticação utiliza conteúdo de mensagem prescrito. Não adicione promoções, cabeçalhos de mídia ou botões arbitrários de sites para transformá-la em uma mensagem de uso geral.
Para criação via API, use o botão OTP com `otp_type: "COPY_CODE"`. Isso é diferente do botão promocional `COPY_CODE` usado em um [modelo de cupom](/pt/documentation/whatsapp-business-platform/messaging/message-templates/coupon-code-templates).
## Projetar o fluxo da solicitação à verificação
1. O cliente solicita um código para uma ação específica em seu aplicativo.
2. Seu backend gera um código de uso único e de curta duração, vinculando-o a essa solicitação.
3. Seu sistema envia o modelo aprovado para o destino confirmado.
4. O cliente copia ou digita o código.
5. Seu backend valida a solicitação, o código, a expiração e o limite de tentativas.
6. Apenas uma verificação bem-sucedida no backend conclui a autenticação.
Faça com que a tela de inserção de código explique para onde o código foi enviado. Forneça uma opção controlada de reenvio e uma maneira de corrigir o número. Não exponha se a conta de outra pessoa existe por meio de mensagens de erro excessivamente específicas.
## Enviar o mesmo código em ambas as posições
O envio de autenticação usa o código no corpo da mensagem e no parâmetro de URL do botão OTP. Esses valores devem coincidir.
Exemplo apenas dos **componentes do modelo**, com um código fictício:
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
[
{
"type": "body",
"parameters": [{ "type": "text", "text": "123456" }]
},
{
"type": "button",
"sub_type": "url",
"index": 0,
"parameters": [{ "type": "text", "text": "123456" }]
}
]
```
Não substitua este parâmetro de URL de OTP pelo parâmetro de marketing `coupon_code`. Use [Enviar mensagens do WhatsApp](/pt/api-reference/guides/whatsapp-platform/send-whatsapp-message) para a solicitação completa e mantenha os códigos reais fora dos logs.
## Alinhar os três controles de expiração
A expiração do código no backend, o aviso de expiração visível do modelo e o tempo de vida (TTL) de entrega da mensagem são controles separados. Definir o aviso não configura seu backend.
Para um fluxo de verificação de cinco minutos, aplique cinco minutos no servidor, exiba o aviso correspondente e escolha uma validade de entrega que não permita que um código já inutilizado chegue muito mais tarde. Consulte [Modelos de autenticação](/pt/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/index) para ver o intervalo de TTL atual e os padrões.
## Testar os caminhos de falha
Teste um código válido, código incorreto, código expirado, reutilização após o sucesso, reenvios repetidos, alteração de número de telefone e entrega com atraso. Decida se uma nova solicitação invalida os códigos anteriores e deixe esse comportamento claro para o cliente.
No iOS 26 e versões posteriores, a Meta documenta sugestões nativas do teclado a partir da notificação push do WhatsApp, em vigor a partir de 15 de junho de 2026. Isso é independente da integração one-tap do Android e não substitui a verificação no backend.
Uma mensagem entregue ou lida não é prova de autenticação.
Fontes: [Modelos de autenticação da Meta](https://developers.facebook.com/docs/whatsapp/business-management-api/authentication-templates/) e [Gerenciamento de modelos da YCloud](/pt/api-reference/guides/whatsapp-platform/manage-whatsapp-templates).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.