whatsapp-docs-mcp 1.0.0

package/docs/modelos/gerenciamento_de_modelos/time_to_live.md

@@ -0,0 +1,88 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live -->
+<!-- Scraped: 2025-12-20T17:34:39.157Z -->
+
+# Tempo de vida
+
+Updated: 31 de out de 2025
+
+Se não conseguirmos entregar uma mensagem a um usuário do WhatsApp, faremos novas tentativas de entrega por um período conhecido como tempo de vida ("TTL", pelas iniciais em inglês) ou período de validade da mensagem.
+
+É possível personalizar o TTL padrão para modelos de autenticação e utilidade enviados por meio da API de Nuvem, bem como para modelos de marketing enviados via API de Mensagens de Marketing Lite ("MM Lite API").
+
+Recomendamos definir um TTL para todos os modelos de autenticação, de preferência igual ou inferior ao tempo de expiração do código, para que os clientes só recebam uma mensagem enquanto ainda for possível usar o código.
+
+## Tabela de padrões, valores mín./máx. e compatibilidade
+
+ 
+
+Autenticação
+
+Utilidade
+
+Marketing
+
+**TTL padrão**
+
+10 minutos
+
+30 dias para modelos de autenticação criados antes de 23 de outubro de 2024
+
+30 dias
+
+30 dias
+
+**Compatibilidade**
+
+API de Nuvem + API Local
+
+Somente API de Nuvem
+
+API de Mensagens de Marketing (MM) Lite
+
+**Intervalo personalizável**
+
+De 30 segundos a 15 minutos
+
+De 30 segundos a 12 horas
+
+De 12 horas a 30 dias
+
+## Personalizar o TTL
+
+Para definir um TTL personalizado em um modelo de autenticação, utilidade ou marketing, inclua e defina o valor da propriedade `message_send_ttl_seconds` na chamada a `POST /<PHONE_NUMBER_ID>/message_templates`.
+
+É possível alterar o TTL em um modelo configurado anteriormente por meio desse método.
+
+O TTL pode ser personalizado em incrementos de 1 segundo.
+
+### Valores válidos para a propriedade `message_send_ttl_seconds`
+
+-   Modelos de autenticação: `30` a `900` segundos (30 s a 15 min)-   Modelos de utilidade: `30` a `43200` segundos (30 s a 12 horas)-   Modelos de marketing: `43200` a `2592000` (12 horas a 30 dias)
+
+Para modelos de autenticação e utilidade, você pode definir o valor da propriedade `message_send_ttl_seconds` como `-1`. Isso definirá um TTL personalizado de 30 dias.
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v21.0/102290129340398/message_templates' \      -H 'Authorization: Bearer EAAJB...' \      -H 'Content-Type: application/json' \      -d '      {        "name": "test_template",        "language": "en_US",        "category": "MARKETING",        // Configure your TTL in seconds below        "message_send_ttl_seconds": "120",        "components": [          {            "type": "BODY",            "text": "Shop now through {{1}} and use code {{2}} to get {{3}} off of all merchandise.",            "example": {              "body_text": [                [                  "the end of August","25OFF","25%"                ]              ]            }          },          {            "type": "FOOTER",            "text": "Use the buttons below to manage your marketing subscriptions"          },        ]      }'
+```
+
+### Exemplo de resposta
+
+```
+{  "id": "572279198452421",  "status": "PENDING",  "category": "MARKETING"}
+```
+
+### Quando o TTL é excedido: mensagens descartadas
+
+As mensagens que não puderem ser entregues dentro do TTL padrão ou personalizado serão descartadas.
+
+Se você não receber um [webhook de mensagem entregue](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) antes da expiração do tempo de vida, presuma que a mensagem foi descartada.
+
+Se você enviar uma mensagem e [houver uma falha na entrega](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status), poderá ocorrer um atraso no recebimento do webhook. Por isso, é recomendável incorporar um buffer antes de presumir o descarte.
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/modelos/modelos_de_autenticacao/AGENTS.md

@@ -0,0 +1,13 @@
+# Modelos de Autenticação
+
+Modelos de autenticação
+
+## Documentos Disponíveis
+
+- [Authentication Best Practices](./authentication_best_practices.md)
+- [Authentication Templates](./authentication_templates.md)
+- [Autofill Button Authentication Templates](./autofill_button_authentication_templates.md)
+- [Copy Code Button Authentication Templates](./copy_code_button_authentication_templates.md)
+- [Error Signals](./error_signals.md)
+- [Zero Tap Authentication Templates](./zero_tap_authentication_templates.md)
+

package/docs/modelos/modelos_de_autenticacao/authentication_best_practices.md

@@ -0,0 +1,73 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-best-practices -->
+<!-- Scraped: 2025-12-20T17:30:30.961Z -->
+
+# Boas práticas para autenticação de usuários via WhatsApp
+
+Updated: 14 de nov de 2025
+
+## Segurança
+
+Para se registrar no WhatsApp, os usuários devem usar o próprio número de telefone. Durante [esse processo de cadastro](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Fcoronavirus%2Fget-started&h=AT05D5qd8qyBSzOzQIbvdRiF2OWbjmOx7hIXs0kRpOCIfkREdd1a8JqzhM0bhoqnDLSlPB39jAsf9JUvpEdBmAPsPGOOhHaNSyaJaH02wjdDWcmNi1tfGDLwQ90nQksCc9svsdJ-7PmJcVAuzTWO6hQJwLQ), o WhatsApp verifica se o usuário é o proprietário do número de telefone enviando um código de registro de seis dígitos por SMS ou ligação telefônica.
+
+Muitos usuários do WhatsApp manterão o mesmo número de telefone que já usam no app. No entanto, o WhatsApp não impõe a propriedade do número de telefone após o registro inicial. Por isso, não há garantia de que o número de telefone e a conta do WhatsApp associada a ele pertencem à mesma pessoa. Em particular, como os números de telefone são reciclados pelas operadoras móveis, é possível que, se o seu usuário for o atual proprietário do número de telefone e não usar o WhatsApp, [o proprietário anterior desse número de telefone ainda tenha acesso à conta do WhatsApp associada a ele](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F3347469605523961&h=AT05D5qd8qyBSzOzQIbvdRiF2OWbjmOx7hIXs0kRpOCIfkREdd1a8JqzhM0bhoqnDLSlPB39jAsf9JUvpEdBmAPsPGOOhHaNSyaJaH02wjdDWcmNi1tfGDLwQ90nQksCc9svsdJ-7PmJcVAuzTWO6hQJwLQ).
+
+Por isso, em casos de uso de autenticação sensível, como a recuperação de conta (em que um código enviado pelo WhatsApp pode ser o único fator de autenticação), não é possível substituir um número de telefone por uma conta do WhatsApp associada a ele. Nesses casos, algumas das seguintes boas práticas podem ser aplicadas:
+
+-   Verifique explicitamente se o usuário é dono da conta do WhatsApp, assim como você faria com qualquer outro canal de autenticação novo. Por exemplo, envie uma senha descartável inicial e peça que o usuário a insira no seu app durante o registro ou quando estiver conectado.-   Exiba um desafio adicional para verificar o usuário, além do código enviado via WhatsApp.
+
+Com o primeiro método, você pode aproveitar nossos sistemas de verificação de alteração de identidade na [API de Nuvem](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers) e na [API Local](/docs/whatsapp/on-premises/reference/contacts/users-whatsapp-id/identity) para "vincular" a conta do WhatsApp à conta do seu usuário, garantindo que as mensagens futuras só cheguem ao usuário do WhatsApp que recebeu a senha descartável inicial. Por exemplo, na API de Nuvem, você deve armazenar o hash de identidade recebido após enviar a senha descartável inicial e (presumindo que a verificação tenha sido bem-sucedida) incluí-lo em todas as solicitações de envio de mensagens subsequentes. Essa configuração aumentaria a segurança em relação ao SMS, já que a entrega da mensagem falharia se o número de telefone fosse reciclado e o novo proprietário se registrasse no WhatsApp. Além disso, os códigos de uso único não seriam enviados por acidente a um destinatário não pretendido.
+
+Para combater o phishing, o WhatsApp desabilita o [encaminhamento](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F887468535575482%2F&h=AT05D5qd8qyBSzOzQIbvdRiF2OWbjmOx7hIXs0kRpOCIfkREdd1a8JqzhM0bhoqnDLSlPB39jAsf9JUvpEdBmAPsPGOOhHaNSyaJaH02wjdDWcmNi1tfGDLwQ90nQksCc9svsdJ-7PmJcVAuzTWO6hQJwLQ) de mensagens de autenticação. As mensagens são protegidas com a criptografia de ponta a ponta entre a [API de Nuvem e o usuário](/documentation/business-messaging/whatsapp/data-privacy-and-security), ou com a criptografia de ponta a ponta entre o gerenciador do ponto de extremidade da API do WhatsApp Business e o usuário da [API Local](/docs/whatsapp/on-premises/faq#faq_188619461766385).
+
+O WhatsApp não é compatível e não consegue validar as práticas de segurança de [apps não oficiais](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F1217634902127718&h=AT05D5qd8qyBSzOzQIbvdRiF2OWbjmOx7hIXs0kRpOCIfkREdd1a8JqzhM0bhoqnDLSlPB39jAsf9JUvpEdBmAPsPGOOhHaNSyaJaH02wjdDWcmNi1tfGDLwQ90nQksCc9svsdJ-7PmJcVAuzTWO6hQJwLQ). Não há garantias de que a autenticação via WhatsApp seja segura para usuários que usam esses apps.
+
+## Experiência do usuário
+
+### Conseguir aceitação
+
+De acordo com a [Política de Mensagens do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fbusiness-policy%2F&h=AT05D5qd8qyBSzOzQIbvdRiF2OWbjmOx7hIXs0kRpOCIfkREdd1a8JqzhM0bhoqnDLSlPB39jAsf9JUvpEdBmAPsPGOOhHaNSyaJaH02wjdDWcmNi1tfGDLwQ90nQksCc9svsdJ-7PmJcVAuzTWO6hQJwLQ), é necessário receber a aceitação do usuário do WhatsApp antes de enviar uma mensagem para ele. Uma implementação comum é oferecer aos usuários a escolha entre canais de autenticação (WhatsApp, email, SMS etc.), conforme mostrado em [nosso exemplo de app](/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates#sample-app).
+
+### Solucionar problemas de entrega de mensagens
+
+Se você estiver enfrentando problemas em que os usuários escolhem o WhatsApp, mas as mensagens acabam não sendo entregues, é possível que os usuários estejam selecionando o WhatsApp por engano, quando, na verdade, não estão registrados na plataforma. Para solucionar esse problema, você pode verificar se o WhatsApp está instalado no Android e exibir apenas essa opção.
+
+```
+fun isWhatsAppAvailable(context: Context){
+   return isAppAvailable(context, "com.whatsapp") ||
+          isAppAvailable(context, "com.whatsapp.w4b")
+}
+
+fun isAppAvailable(
+   context: Context,
+   packageName: String
+): Boolean {
+ val intent = Intent()
+ intent.setPackage(packageName)
+ intent.action = "com.whatsapp.otp.OTP_REQUESTED"
+ val packageManager = context.packageManager
+ val listActivities = packageManager.queryBroadcastReceivers(intent, 0)
+ return listActivities.isNotEmpty()
+}
+```
+
+Se você ainda está com problemas em que os usuários selecionam o WhatsApp, mas as mensagens acabam não sendo entregues, também é possível que o número de telefone do WhatsApp não esteja correto. Isso pode acontecer devido a um erro de digitação do usuário ou porque o app está presumindo incorretamente que o número de telefone do registro inicial é o mesmo que o número de telefone do WhatsApp. Os usuários podem ter um número de telefone para SMS e outro para o WhatsApp, no caso de terem vários chips SIM para viagens. Se o WhatsApp for escolhido como canal de autenticação, o usuário terá a chance de confirmar o próprio número de telefone do WhatsApp.
+
+Se as mensagens estiverem sendo entregues, mas você notar taxas de conversão mais baixas do que o esperado nos seus fluxos de autenticação, considere a adoção da [nossa funcionalidade de "preenchimento automático de um toque"](/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates#example-request--one-tap-autofill-), disponível para Android.
+
+### Compatibilidade com todos os apps
+
+Seus usuários podem estar prontos para receber mensagens pelo WhatsApp ou pelo app WhatsApp Business (ou ambos). Se você tiver seguido [nosso guia de implementação de cliente Android](/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates#client-implementation), as mensagens de "preenchimento automático de um toque" funcionarão com qualquer combinação de instalações. Porém, recomendamos testar um toque no app do consumidor e no app de empresa.
+
+### Preparar-se para receber o código do WhatsApp
+
+Ao integrar com a funcionalidade de preencher automaticamente com um toque, será possível gerenciar o código assim que o [handshake](/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates#handshake) for enviado. O WhatsApp enviará o código quando for recebido, independentemente da tela que estiver sendo mostrada no seu app. Por exemplo, em situações de baixa conectividade de rede, talvez você receba o código antes de conseguir carregar a tela de entrada do código no seu app. Para lidar com esses casos, uma opção é armazenar o código recebido de forma que o app possa recuperá-lo quando a próxima tela for totalmente carregada. Dessa forma, o código poderá ser preenchido automaticamente pelo seu app assim que for recebido.
+
+## Contas comerciais e números de telefone
+
+Cada empresa deve ter a própria conta do WhatsApp Business e enviar modelos de autenticação por meio do próprio número de telefone, em vez de compartilhar WABAs e telefones com entidades comerciais separadas. O compartilhamento de uma WABA entre várias empresas não segue a política, pois está em conflito com os [Termos de Serviço do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fbusiness-terms&h=AT05D5qd8qyBSzOzQIbvdRiF2OWbjmOx7hIXs0kRpOCIfkREdd1a8JqzhM0bhoqnDLSlPB39jAsf9JUvpEdBmAPsPGOOhHaNSyaJaH02wjdDWcmNi1tfGDLwQ90nQksCc9svsdJ-7PmJcVAuzTWO6hQJwLQ) e a [Política de Mensagens do WhatsApp Business](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.whatsapp.com%2Flegal%2Fbusiness-policy%2F&h=AT05D5qd8qyBSzOzQIbvdRiF2OWbjmOx7hIXs0kRpOCIfkREdd1a8JqzhM0bhoqnDLSlPB39jAsf9JUvpEdBmAPsPGOOhHaNSyaJaH02wjdDWcmNi1tfGDLwQ90nQksCc9svsdJ-7PmJcVAuzTWO6hQJwLQ), além de criar experiências ruins para usuários e empresas no WhatsApp.
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/modelos/modelos_de_autenticacao/authentication_templates.md

@@ -0,0 +1,252 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates -->
+<!-- Scraped: 2025-12-20T17:30:23.811Z -->
+
+# Modelos de autenticação
+
+Updated: 14 de nov de 2025
+
+Caso seu app para celular ofereça aos usuários a opção de receber senhas descartáveis ou códigos de verificação via WhatsApp, você precisará usar um modelo de autenticação.
+
+Os modelos de autenticação são compostos pelo seguinte:
+
+-   **Texto predefinido** fixo e não personalizável: _<VERIFICATION\_CODE> é seu código de verificação._-   Um **aviso legal de segurança** opcional: _para sua segurança, não compartilhe este código._-   Um **aviso sobre validade** opcional: _Este código expirará em <NUM\_MINUTES> minutos._-   Um botão de **preencher automaticamente com um toque**, um botão de **copiar código** ou nenhum botão, caso o método usado seja [sem toque](#zero-tap-authentication-templates).
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/391704029_868992307740251_3073203578067340408_n.png?_nc_cat=101&ccb=1-7&_nc_sid=e280be&_nc_ohc=i3Izm86EXycQ7kNvwHirErm&_nc_oc=AdlFyLEOEZfXx930yqt0AqAdmL2OUgOkQ59vM8QOPCtMiGUfr7ZPJOEMecHORCF6LCE&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=9XoEQ39YscOhgDZImBprrQ&oh=00_Afmcm1FfJx_bdJZWPnPgQs7s4ORgDMOaT_agEmypcrhtqQ&oe=6961339E)
+
+Recomendamos o uso desses botões porque eles oferecem a melhor experiência ao usuário. No entanto, atualmente, esse tipo de botão só é compatível com Android e exige alterações no código do app.
+
+## Segurança para dispositivos conectados
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/458481136_1204876024064039_8216873060873003926_n.png?_nc_cat=100&ccb=1-7&_nc_sid=e280be&_nc_ohc=AF37nUUYvBMQ7kNvwESUZQ2&_nc_oc=AdmJPgIWN72DytCMUzjZA3OlmsDGUEHCxFgOKlQZzbxPdD-CriXoxCM0a4aS9IQquUw&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=9XoEQ39YscOhgDZImBprrQ&oh=00_AfkRAhkxrmY8ifqYaDOPnlLxkGx8NXOO4_jid510XjRNDA&oe=696136A6)
+
+Agora, os modelos de autenticação contam com segurança para dispositivos conectados. Isso significa que as mensagens de autenticação são entregues apenas ao dispositivo principal do usuário do WhatsApp.
+
+As mensagens de autenticação enviadas aos dispositivos vinculados de um usuário são mascaradas com um comando que instrui o usuário a visualizar a mensagem no dispositivo principal.
+
+Esse recurso é habilitado por padrão e não requer alterações de código. Ele não pode ser configurado nem personalizado e está disponível somente na API de Nuvem.
+
+## Modelos de autenticação de preenchimento automático com um toque
+
+Os modelos de autenticação incluem um botão de preenchimento automático com um toque.
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/393789031_872892117564016_6400271480127333734_n.png?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=hk13Qnm07Y4Q7kNvwHDrWkR&_nc_oc=Adnl7qUTkyy-BxNDlCFt4llAjkKBMz3DXsvpWfxDTbCBFim1BZPiRvUlQLeWjyAOdj8&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=9XoEQ39YscOhgDZImBprrQ&oh=00_AfkzfOybD9gEmtzYktdb9vCv1nPzpaZDS-nXre_rPdMJ_A&oe=69611168)
+
+Quando um usuário do WhatsApp toca no botão de preenchimento automático, o cliente do WhatsApp dispara uma atividade que abre seu app e fornece a senha ou o código.
+
+Consulte [Modelos de autenticação de preenchimento automático com um toque](/documentation/business-messaging/whatsapp/templates/authentication-templates/autofill-button-authentication-templates) para saber como usar esses modelos.
+
+## Modelos de autenticação de copiar código
+
+Os modelos de autenticação de cópia de código permitem que você envie aos usuários uma senha descartável ou um código de uso único junto com um botão de copiar código.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/391709210_6733218460105388_4204949555628827374_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=F6w8_nbcj-AQ7kNvwFO57jn&_nc_oc=AdkpuNZOJ_L46Ovvi9vwyoHc5yRzugusd4qdDs6hcLzLXJ0pIIEV3oHI66_TOgIkOYc&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=9XoEQ39YscOhgDZImBprrQ&oh=00_AfnDg9yOqS4W51jLGGy3cQbyazs3ijtOSNsb1BaI76bGfQ&oe=69611FBD)
+
+Quando um usuário do WhatsApp toca no botão de copiar código, o cliente do WhatsApp copia a senha ou o código para a área de transferência do dispositivo. Depois disso, o usuário pode abrir o app e colar a senha ou o código na interface do software.
+
+Consulte [Modelos de autenticação de cópia de código](/documentation/business-messaging/whatsapp/templates/authentication-templates/copy-code-button-authentication-templates) para saber como usar esses modelos.
+
+## Modelos de autenticação sem toque
+
+Os modelos de autenticação de toque zero permitem que seus usuários recebam senhas ou códigos descartáveis via WhatsApp sem que precisem sair do app.
+
+Quando um usuário solicita uma senha ou um código e você entrega essa chave usando um modelo de autenticação sem toque, o cliente do WhatsApp transmite a senha ou o código incluído, que pode ser capturado pelo seu app usando um receptor de transmissão.
+
+Consulte [Modelos de autenticação sem toque](/documentation/business-messaging/whatsapp/templates/authentication-templates/zero-tap-authentication-templates) para saber como usar esses modelos.
+
+## Boas práticas
+
+-   Antes de enviar a senha descartável ou o código de uso único, confirme o número de telefone do WhatsApp do usuário.-   Deixe claro para os usuários que a senha ou o código será enviado ao número de telefone do WhatsApp, especialmente se você oferecer diferentes métodos de recebimento. Para ver mais dicas, consulte [Obter aceitação](/documentation/business-messaging/whatsapp/getting-opt-in).-   Quando a senha ou o código for colado pelo usuário ou recebido como parte do fluxo de preenchimento automático no app, informe ao usuário que a captura foi bem-sucedida.
+
+Veja também [Boas práticas para autenticação de usuários no WhatsApp](/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-best-practices).
+
+## Personalizar tempo de validade
+
+Veja [Tempo de vida](/documentation/business-messaging/whatsapp/templates/time-to-live).
+
+## Prévias do modelo
+
+Você pode gerar prévias do texto do modelo de autenticação em vários idiomas que incluem ou excluem as strings de recomendação de segurança e de expiração de código usando o ponto de extremidade [**GET /<WABA\_ID>/message\_template\_previews**](/docs/graph-api/reference/whats-app-business-account/message_template_previews#Reading).
+
+### Sintaxe da solicitação
+
+```
+GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_template_previews
+  ?category=AUTHENTICATION,
+  &language=<LANGUAGE>, // Optional
+  &add_security_recommendation=<ADD_SECURITY_RECOMMENDATION>, // Optional
+  &code_expiration_minutes=<CODE_EXPIRATION_MINUTES>, // Optional
+  &button_types=<BUTTON_TYPES> // Optional
+```
+
+### Parâmetros de solicitação
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<LANGUAGE>`
+
+_Lista separada por vírgulas_
+
+**Opcional.**
+
+  
+Lista separada por vírgulas dos [códigos de idioma](/documentation/business-messaging/whatsapp/templates/supported-languages) das versões que você quer retornar.
+
+  
+Em caso de omissão, as versões em todos os idiomas aceitos serão retornadas.
+
+`en_US,es_ES`
+
+`<ADD_SECURITY_RECOMMENDATION>`
+
+_Booliano_
+
+**Opcional.**
+
+  
+Defina como `true` se quiser que a string do corpo da recomendação de segurança seja incluída na resposta.
+
+  
+Em caso de omissão, a string não será incluída.
+
+`true`
+
+`<CODE_EXPIRATION_MINUTES>`
+
+_Int64_
+
+**Opcional.**
+
+  
+Defina como um número inteiro se quiser que a string de rodapé da expiração do código seja incluída na resposta.
+
+  
+Em caso de omissão, a string não será incluída.
+
+  
+O valor indica o número de minutos até a expiração do código.
+
+Mínimo `1`, máximo `90`.
+
+`10`
+
+`<BUTTON_TYPES>`
+
+_Lista de strings separadas por vírgulas_
+
+**Obrigatório.**
+
+  
+Lista separada por vírgulas de strings que indicam o tipo de botão.
+
+  
+Em caso de inclusão, a resposta exibirá o texto de cada botão.
+
+  
+Nos modelos de autenticação, esse valor deve ser `OTP`.
+
+`OTP`
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v17.0/102290129340398/message_template_previews?category=AUTHENTICATION&languages=en_US,es_ES&add_security_recommendation=true&code_expiration_minutes=10&button_types=OTP' \-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "data": [    {      "body": "*{{1}}* is your verification code. For your security, do not share this code.",      "buttons": [        {          "autofill_text": "Autofill",          "text": "Copy code"        }      ],      "footer": "This code expires in 10 minutes.",      "language": "en_US"    },    {      "body": "Tu código de verificación es *{{1}}*. Por tu seguridad, no lo compartas.",      "buttons": [        {          "autofill_text": "Autocompletar",          "text": "Copiar código"        }      ],      "footer": "Este código caduca en 10 minutos.",      "language": "es_ES"    }  ]}
+```
+
+## Gerenciamento em massa
+
+Use o ponto de extremidade [**POST /<WABA\_ID>/upsert\_message\_templates**](/docs/graph-api/reference/whats-app-business-account/upsert_message_templates#Creating) para atualizar ou criar modelos de autenticação em massa em vários idiomas que incluam ou excluam os avisos opcionais de segurança e de expiração.
+
+Se já houver um modelo com o nome e o idioma correspondentes, ele será atualizado com o conteúdo da solicitação. Caso contrário, um novo modelo será criado.
+
+### Sintaxe da solicitação
+
+```
+POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/upsert_message_templates
+```
+
+### Corpo do post
+
+```
+{
+  "name": "<NAME>",
+  "languages": [<LANGUAGES>],
+  "category": "AUTHENTICATION",
+  "components": [
+    {
+      "type": "BODY",
+      "add_security_recommendation": <ADD_SECURITY_RECOMMENDATION> // Optional
+    },
+    {
+      "type": "FOOTER",
+      "code_expiration_minutes": <CODE_EXPIRATION_MINUTES> // Optional
+    },
+    {
+      "type": "BUTTONS",
+      "buttons": [
+        {
+          "type": "OTP",
+          "otp_type": "<OTP_TYPE>",
+          "supported_apps": [
+            {
+              "package_name": "<PACKAGE_NAME>", // One-tap and zero-tap buttons only
+              "signature_hash": "<SIGNATURE_HASH>" // One-tap and zero-tap buttons only
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+### Propriedades
+
+Todas as propriedades de criação de modelos são compatíveis, com estas exceções:
+
+-   A propriedade `language` não é compatível. Como alternativa, use `languages` e defina o valor como uma matriz de strings de [código de localidade e idioma](/documentation/business-messaging/whatsapp/templates/supported-languages). Por exemplo: `["en_US","es_ES","fr"]`.-   A propriedade `text` é incompatível.-   A propriedade `autofill_text` é incompatível.
+
+### Exemplo de solicitação de cópia de código
+
+Este exemplo cria três modelos de autenticação (em inglês, espanhol e francês) com botões de copiar código. Cada modelo recebe o nome de "authentication\_code\_copy\_code\_button" e inclui a recomendação de segurança e o tempo de expiração.
+
+```
+curl 'https://graph.facebook.com/v17.0/102290129340398/upsert_message_templates' \-H 'Content-Type: application/json' \-H 'Authorization: Bearer EAAJB...' \-d '{  "name": "authentication_code_copy_code_button",  "languages": ["en_US","es_ES","fr"],  "category": "AUTHENTICATION",  "components": [    {      "type": "BODY",      "add_security_recommendation": true    },    {      "type": "FOOTER",      "code_expiration_minutes": 10    },    {      "type": "BUTTONS",      "buttons": [        {          "type": "OTP",          "otp_type": "COPY_CODE"        }      ]    }  ]}'
+```
+
+### Exemplo de solicitação para preenchimento automático com um toque
+
+Este exemplo (1) atualiza um modelo existente com o nome "authentication\_code\_autofill\_button" e o idioma "en\_US" e (2) cria dois novos modelos de autenticação (em espanhol e francês) com botões de preenchimento automático com um toque. Os dois modelos recém-criados recebem o nome de "authentication\_code\_autofill\_button" e incluem a recomendação de segurança e o tempo de expiração.
+
+```
+curl 'https://graph.facebook.com/v17.0/102290129340398/upsert_message_templates' \-H 'Content-Type: application/json' \-H 'Authorization: Bearer EAAJB...' \-d '{  "name": "authentication_code_autofill_button",  "languages": ["en_US","es_ES","fr"],  "category": "AUTHENTICATION",  "components": [    {      "type": "BODY",      "add_security_recommendation": true    },    {      "type": "FOOTER",      "code_expiration_minutes": 15    },    {      "type": "BUTTONS",      "buttons": [        {          "type": "OTP",          "otp_type": "ONE_TAP",          "supported_apps": [            {              "package_name": "com.example.luckyshrub",              "signature_hash": "K8a/AINcGX7"            }          ]        }      ]    }  ]}'
+```
+
+### Exemplo de resposta
+
+```
+{  "data": [    {      "id": "954638012257287",      "status": "APPROVED",      "language": "en_US"    },    {      "id": "969725527415202",      "status": "APPROVED",      "language": "es_ES"    },    {      "id": "969725530748535",      "status": "APPROVED",      "language": "fr"    }  ]}
+```
+
+## App de exemplo
+
+Veja o [exemplo de app de senha descartável do WhatsApp](https://l.facebook.com/l.php?u=https%3A%2F%2Fgithub.com%2FWhatsApp%2FWhatsApp-OTP-Sample-App&h=AT2HHOwyYuRRXTOkOnelSRP-RIWZKlxrPUU3FburpgfTVEBEObE_A6GDGeux8dkPBP0nCsLb-XRTdHiDb2Tq6v4UJRsKOYL5Y_GUAJLb6pGulSfe9fDsWm32EMOImdtHwWwBmnp2O-j1naKQ9v8tHYxbg8M) para Android no GitHub. O app de exemplo demonstra como enviar e receber códigos e senhas descartáveis por meio da API, como integrar botões de preencher automaticamente com um toque e de copiar código, como criar modelos e como preparar um exemplo de servidor.
+
+## Saiba mais
+
+-   [Conta comercial oficial:](/documentation/business-messaging/whatsapp/official-business-accounts) você pode querer solicitar o status de conta comercial oficial para gerar confiança nos usuários, o que reduzirá a probabilidade de eles dispensarem ou ignorarem suas mensagens.-   [Webhooks de mensagens de status:](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) recomendamos que você assine o campo de mensagens do webhook para receber notificações quando o modelo de autenticação com um botão de senha descartável for entregue e lido.
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)