whatsapp-docs-mcp 1.0.0

package/docs/modelos/gerenciamento_de_modelos/template_categorization.md

@@ -0,0 +1,499 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization -->
+<!-- Scraped: 2025-12-20T17:32:47.027Z -->
+
+# Categorização de modelos
+
+Updated: 14 de nov de 2025
+
+Para criar um modelo ou gerenciar os existentes, é importante entender como o WhatsApp os categoriza para fins de precificação.
+
+-   Considere as diretrizes de categorização antes de criar um modelo.-   Acompanhe o status de aprovação do modelo após a criação.-   Saiba mais sobre atualizações automáticas de categoria para modelos em produção.
+
+_**Essas informações também estão disponíveis no nosso [PDF sobre diretrizes para categorização de modelos de mensagem](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-gru1-2.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F522646671_1032957015586071_352200442705405080_n.pdf%3F_nc_cat%3D108%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DK_IwxQfRQhAQ7kNvwFbk6Mm%26_nc_oc%3DAdmDAjAPWW3w6vxeM7OMbAzUYmExvAbb24KdLek1AgZoI74RQ-qEPF5d_CEI-O_2acc%26_nc_zt%3D14%26_nc_ht%3Dscontent-gru1-2.xx%26_nc_gid%3DVQ0cinvfV1uIQgld6bE-xA%26oh%3D00_AfmnN2dgNkIDM7v0RqZdUO1nXkMZht2OF0NpKdcXSzqmwQ%26oe%3D694C9A62&h=AT0ibnXbFEXUFc5tvO6HDbos8de0mdTPe9SPVFlpc3ooB-sgyWRisHQWev2ShS2Tn_hYLNKNbg_c_bH_vMzWGsCTVr90VxVzwd8BzwzFR2G6xNOej7HCAVp5_CW_Thh6r_YP05o91ZSmKP2hlPO658UwgS0).**_
+
+## Diretrizes de categorias de modelos
+
+As diretrizes de categoria de modelos definem as categorias dos modelos de mensagem. Os modelos de mensagem podem ser categorizados como:
+
+-   **Modelos de marketing**: permitem que as empresas atinjam diferentes objetivos, desde gerar reconhecimento até impulsionar vendas e redirecionar clientes.-   **Modelos de utilidade**: permitem que as empresas acompanhem atividades ou pedidos do usuário, já que essas mensagens são normalmente disparadas por ações do usuário.-   **Modelos de autenticação**: permitem que as empresas verifiquem a identidade de um usuário em diferentes etapas da jornada do cliente.
+
+### Diretrizes para modelos de marketing
+
+Os modelos de marketing são os mais flexíveis. Eles permitem que as empresas atinjam uma ampla gama de objetivos, desde gerar reconhecimento até impulsionar vendas e muito mais.
+
+_Observação: os exemplos são apenas ilustrativos. Modelos que tenham assuntos similares ou o mesmo texto dos exemplos acima podem ser categorizados de modo diferente dependendo do conteúdo._
+
+#### Objetivo da mensagem: **reconhecimento**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Gere conhecimento sobre seus negócios, produtos ou serviços entre os clientes que se inscreveram para receber mensagens da sua empresa no WhatsApp.
+
+-   Você sabia? Instalamos uma {{new\_tower}} na sua região para você aproveitar uma experiência de rede otimizada. Para saber mais, acesse nosso site.-   A festa {{Diwali}} está chegando! Junte-se a nós em {{location}} no dia {{date}} para comemorar com amigos e familiares. Para saber mais sobre o evento clique no link abaixo.-   Procurando um refúgio para a nova estação? Acabamos de inaugurar nosso mais novo resort em {{location}}, que é o lugar perfeito para você relaxar.
+
+#### Objetivo da mensagem: vendas
+
+Meta de negócios
+
+Exemplos de modelo
+
+Envie ofertas promocionais aos clientes relacionadas a eventos, cupons ou outro tipo de conteúdo destinado a impulsionar vendas ou renovações.
+
+-   Como agradecimento pela sua última compra, aproveite {{15}}% de desconto no próximo pedido. Use o código {{loyal15}} ao finalizar a compra. Acesso nosso site abaixo.-   Estamos buscando {{donations}} para atingir nossa meta de arrecadação de fundos de {{amount}}. Apoie essa causa e contribua agora! – Faça um upgrade para nossa {{premium\_cabin}} e aproveite novos benefícios, como {{more\_legroom}} e {{priority\_boarding}}. Clique abaixo ou entre no nosso app para fazer o upgrade.-   Temos um {{credit\_card}} {{pre\_approved}} especialmente para você! Aproveite uma taxa inicial de {{apr\_rate}} ao se cadastrar usando seu link personalizado abaixo.
+
+#### Objetivo da mensagem: **redirecionamento**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Promova ou recomende ofertas, produtos ou serviços. Além disso, tente renovar assinaturas ou exiba outras chamadas para ação a usuários que tenham visitado seu site, usado seu app ou interagido com você. Essas são ações de marketing, mesmo que pedidas pelos usuários.
+
+-   Sua assinatura terminará em {{date}}. Renove hoje para economizar {{discount}}.-   Você deixou {{items}} no carrinho! Não se preocupe, nós salvamos os produtos. Finalize a compra abaixo.-   Seu pedido de empréstimo está {{pending\_approval}}. Faça login para continuar de onde parou.-   Encontramos um {{car}} que corresponde à sua pesquisa salva. Entre no nosso app para conferir.-   Pedimos desculpas pelo atraso na entrega do seu {{package}}. Depositamos um {{credit}} na sua conta, que já está disponível.
+
+#### Objetivo da mensagem: **promoção do app**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Peça que os clientes instalem seu app ou executem uma ação específica com ele.
+
+-   Você sabia? Agora você pode {{checkout}} no nosso app. Baixe o app abaixo para aproveitar uma experiência simplificada.-   Agradecemos por usar nosso app. Percebemos que você não usou nosso {{latest\_feature}}. Clique abaixo para saber mais sobre os benefícios da nova funcionalidade.-   Somente no app: {{20}}% de desconto esta semana! Use o código {{summer\_promo}} para economizar em looks selecionados.-   Olá, {{name}}! Seu amigo {{name}} entrou recentemente para nossa comunidade. Envie uma mensagem de boas-vindas no nosso app hoje mesmo: {{URL}}.
+
+#### Objetivo da mensagem: **relacionamento com o cliente**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Fortaleça o relacionamento com os clientes por meio de mensagens personalizadas ou novas conversas.
+
+-   {{Name}}, achou que a gente ia esquecer? De jeito nenhum: {{Happy\_birthday}}! Desejamos a você muitas felicidades neste novo ano.-   À medida que nos aproximamos do final do ano, refletimos sobre o que nos motiva: {{Name}}. Agradecemos por você ser um {{valued\_customer}}. Esperamos continuar atendendo às suas necessidades.-   Olá, sou o novo {{virtual\_assistant}}. Posso fornecer suporte ou ajudar você a encontrar produtos. Se eu puder ajudar, basta entrar em contato!
+
+Confira outros modelos também considerados de marketing:
+
+-   Modelos com conteúdo misto (por exemplo, utilidade e marketing, como atualização de pedido com uma promoção ou uma pesquisa de feedback com conteúdo promocional).-   Modelos com conteúdo pouco claro (por exemplo, apenas "{{1}}" ou "Parabéns!").
+
+### Diretrizes para modelos de utilidade
+
+Os modelos de utilidade são disparados por uma ação ou pedido do usuário. Para que um modelo seja categorizado como utilidade, ele precisa atender aos dois critérios abaixo:
+
+-   _Precisa_ ser **não promocional**, ou seja, não pode conter nenhuma intenção promocional ou persuasiva.-   TAMBÉM _precisa_ ser **específico para o usuário ou pedido por ele** (claramente relacionado ao pedido, à conta, aos serviços ou às transações dele) OU ser **essencial ou crítico** para o usuário (por exemplo, para garantir a segurança dele).
+
+#### Objetivo da mensagem: **gerenciamento de aceitação no WhatsApp**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Confirme que o cliente concordou em receber mensagens no WhatsApp como um complemento do consentimento coletado por outros canais (por exemplo, site, email) ou que ele não aceitou o contato.
+
+-   Agradecemos por confirmar seu consentimento. Agora, você receberá notificações via WhatsApp.-   Agradecemos por confirmar sua preferência de cancelamento. Você não receberá mais mensagens nossas no WhatsApp.
+
+#### Objetivo da mensagem: **gerenciamento de pedidos**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Confirme, atualize ou cancele um pedido ou uma transação com um cliente usando detalhes específicos do pedido ou da transação no corpo da mensagem.
+
+_Essas mensagens não devem promover, recomendar, fazer o upsell/a venda cruzada de produtos nem incluir ofertas ou tentar garantir renovações._
+
+-   Agradecemos a colaboração! O pedido {{order\_number}} foi confirmado. Avisaremos assim que seu pacote estiver a caminho.-   Viva! Seu pedido {{order\_number}} está a caminho. O número de rastreamento é {{tracking\_ID}}, e a data prevista de entrega é {{date}}.-   Um item do seu pedido {{number}} está aguardando estoque. Entraremos em contato novamente com uma data estimada de envio. Se você quiser cancelar o pedido e receber um reembolso, clique abaixo.-   Recebemos o item do seu pedido {{order\_number}}. O reembolso de ${{amount}} foi processado. Agradecemos por usar nossos serviços.
+
+#### Objetivo da mensagem: **alertas ou atualizações sobre a conta**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Envie atualizações, alertas importantes e urgentes ou outras informações específicas sobre produtos/serviços adquiridos ou assinados.
+
+_Essas mensagens não devem promover, recomendar, fazer o upsell/a venda cruzada de produtos nem incluir ofertas ou tentar garantir renovações._
+
+-   Atualização diária para a conta com final {{four\_digit\_number}}: seu saldo disponível é {{amount}}.-   Lembrete: seu pagamento mensal do {{service}} será cobrado em {{date}} no {{card}} salvo no nosso cadastro.-   Você tem apenas {{number}} minutos restantes no seu plano. Não se esqueça de recarregar sua conta até {{date}} para evitar interrupções.-   Para finalizar a configuração do seu {{new\_profile}}, você precisa enviar uma {{photo}}. Clique abaixo para carregar.-   Atualizamos o número do nosso {{Customer\_service}} para {{number}}. Salve esse contato e ligue se precisar de ajuda.
+
+#### Objetivo da mensagem: **pesquisas de feedback**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Colete feedback sobre pedidos, transações ou interações anteriores com os clientes.
+
+_É necessário especificar o pedido ou a interação. Uma pesquisa ou pedido de feedback geral/genérico não será aprovado como utilidade._
+
+-   Entregamos seu pedido {{order\_number}}! Se houver algum problema, entre em contato conosco abaixo.-   Com seu feedback, podemos {{improve}} nossos serviços. Clique abaixo para fazer uma avaliação sobre sua {{recent visit}} à nossa loja {{store}}. Desde já, agradecemos sua participação.-   Recentemente, você conversou conosco {{online}} sobre o pedido {{order\_number}}. Como foi sua experiência? Clique abaixo para responder a uma breve pesquisa.
+
+#### Objetivo da mensagem: **continuar a conversa no WhatsApp**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Envie uma mensagem para iniciar uma interação no WhatsApp que começou em outro canal.
+
+_Essas mensagens não devem ser iniciadas sem que o usuário tenha pedido a transferência da conversa para o WhatsApp._
+
+-   Olá! Vejo que você pediu suporte por meio do nosso {{online\_chat}}. Sou o assistente virtual do WhatsApp. Como posso ajudar?-   Olá, {{name}}. Estamos dando continuidade ao seu contato com o atendimento ao cliente sobre {{issue}}. Encaminhamos seu caso para a próxima etapa. Entre na sua conta para continuar.
+
+Para que um modelo de utilidade seja considerado essencial ou crítico para o usuário, ele deve refletir um dos casos de uso abaixo e também ser não promocional (não conter qualquer intenção promocional ou persuasiva).
+
+**Caso de uso de utilidade pública:**
+
+Caso de uso
+
+Exemplo que atende à definição de "essencial ou crítico para o usuário"
+
+Clima severo
+
+Há um alerta de {{tornado}} na sua área. Recomendamos que você permaneça em casa até as {{time}} horas de hoje.
+
+Recursos para situações de emergência
+
+Ativamos serviços de suporte para a {{crisis}} na área de {{zip code}}. Confira atualizações ao vivo no nosso site abaixo.
+
+**Caso de uso de serviços públicos:**
+
+Caso de uso
+
+Exemplo que atende à definição de "essencial ou crítico para o usuário"
+
+Conscientização sobre saúde
+
+Cuide da sua saúde. Compareça ao {{location}} até {{time}} para receber sua {{vaccine}} gratuita contra a COVID-19. Traga seu {{vaccination\_card}} e um documento de identidade.
+
+Emergência de saúde
+
+A cidade de {{city}} acaba de declarar estado de emergência em saúde devido a {{issue}}. Assim que possível, entraremos em contato com mais detalhes.
+
+Registro de eleitor
+
+Para votar em {{date}}, confirme que seu {{registration card}} de eleitor está ativo. Se for o caso, clique no URL abaixo para entender as etapas necessárias de renovação. Desconsidere esta mensagem caso seu {{registration card}} de eleitor esteja ativo.
+
+Pagamentos
+
+O saldo do seu repasse de {{welfare}} é {{amount}}. Lembre-se de que ele expirará em {{date}}.
+
+**Caso de uso de interrupção de serviços públicos:**
+
+Caso de uso
+
+Exemplo que atende à definição de "essencial ou crítico para o usuário"
+
+Queda do sistema
+
+Detectamos uma interrupção no sistema que afeta a região do código postal {{code}}. O serviço deve ser restabelecido até {{time\_and\_date}}. Lamentamos o transtorno.
+
+Descontinuidade operacional
+
+Informamos que os {{trains}} na estação {{location}} estão paralisados devido a {{issue}}. Evite a área enquanto trabalhamos para solucionar o problema.
+
+**Caso de uso de proteção de conta ou produto:**
+
+Caso de uso
+
+Exemplo que atende à definição de "essencial ou crítico para o usuário"
+
+Alerta sobre fraudes
+
+Detectamos um aumento em fraudes do tipo {{ATM fraud}}. Para proteger o cartão com final {{1234}}, atualize seu PIN. Clique abaixo para ver o passo a passo.
+
+Recalls de produtos
+
+O {{product}} que você pediu em {{date}} foi recolhido. Clique abaixo para nos informar como você gostaria de prosseguir.
+
+Alertas de garantia
+
+Agradecemos pela compra de {{product}}. Sua garantia está ativa a partir de {{date}}. Consulte nossos {{product manuals}} abaixo para referência
+
+**Caso de uso de conformidade legal/regulatória:**
+
+Caso de uso
+
+Exemplo que atende à definição de "essencial ou crítico para o usuário"
+
+Conformidade de identidade
+
+Informamos que você precisa atualizar seu {{updated\_identification\_card}} até {{date}}. Para evitar inconvenientes durante a viagem, agende um horário no seu {{office}} local.
+
+Declarações de privacidade
+
+Atualizamos nossa política de privacidade em {{date}}. Clique no botão abaixo para saber mais.
+
+Alertas de garantia
+
+Agradecemos pela compra de {{product}}. Sua garantia está ativa a partir de {{date}}. Consulte nossos {{product manuals}} abaixo para referência
+
+### Diretrizes para modelos de autenticação
+
+**Apenas modelos de autenticação podem ser usados para enviar uma senha descartável para verificação de identidade. Os modelos de marketing e utilidade não podem ser usados para essa finalidade.**
+
+As empresas na API de Nuvem podem usar modelos de autenticação da [biblioteca de modelos](/documentation/business-messaging/whatsapp/templates/template-library).
+
+Os modelos de autenticação permitem que as empresas verifiquem a identidade do usuário (com códigos alfanuméricos) em diferentes etapas da jornada do cliente:
+
+-   Criação de conta-   Integridade, acesso ou recuperação de conta-   Transações/pedidos (novos ou existentes)
+
+Os modelos de autenticação são os mais restritivos. Para que um modelo seja classificado como autenticação, **a empresa deve**:
+
+-   Usar modelos de mensagem de autenticação da API de Nuvem na [biblioteca de modelos](/documentation/business-messaging/whatsapp/templates/template-library), que incluem suplementos opcionais, como avisos legais de segurança e avisos de validade.-   Configurar um botão de senha descartável (como [copy-code](/documentation/business-messaging/whatsapp/templates/authentication-templates/copy-code-button-authentication-templates) ou [one-tap](/documentation/business-messaging/whatsapp/templates/authentication-templates/autofill-button-authentication-templates)-   Respeitar as restrições de conteúdo, pois não permitimos o uso de URLs, mídias e emojis em parâmetros ou no conteúdo dos modelos de autenticação. No caso dos parâmetros, também há o limite de 15 caracteres.
+
+#### Objetivo da mensagem: **autenticação**
+
+Meta de negócios
+
+Exemplos de modelo
+
+Autentique usuários com senhas descartáveis
+
+-   "{{1}} é seu código de verificação."-   "{{1}} é seu código de verificação. Para sua segurança, não compartilhe esse código."-   "{{1}} é seu código de verificação. Esse código expira em 15 minutos."
+
+## Como atribuímos uma categoria durante a criação do modelo
+
+Quando você cria um modelo, é necessário indicar a categoria, com base nas diretrizes acima. Validamos a categoria que você indicou de acordo com o conteúdo do modelo e nossas [diretrizes](#template-category-guidelines). Depois, criamos o modelo e definimos o respectivo status como uma das opções abaixo, com base no resultado do processo de validação.
+
+a. Quando um modelo é criado por você e aprovado por nós, é possível pedir uma nova análise até 60 dias após a data de criação.
+
+b. Para modelos de utilidade atualizados para marketing, é possível pedir uma nova análise até 60 dias após a data de atualização da categoria.
+
+### Status "aprovado"
+
+O status `APPROVED` significa que concordamos com a categoria escolhida no seu pedido de criação de modelo e que o modelo foi aprovado na [análise de modelo](/documentation/business-messaging/whatsapp/templates/overview#template-review). Agora, ele pode ser usado para enviar mensagens.
+
+**Atualizações de status:** um alerta por email e do Gerenciador do WhatsApp informará a você que o modelo foi aprovado; além disso, um webhook [message\_template\_status\_update](/documentation/business-messaging/whatsapp/webhooks/reference/message_template_status_update) será disparado com a propriedade do evento definida como `APPROVED`.
+
+A partir de 9 de abril de 2025, se você tiver selecionado `UTILITY` como a categoria do modelo, mas definirmos que a opção certa seria `MARKETING`, **aprovaremos o modelo como `MARKETING`**. No Gerenciador do WhatsApp, você verá a tela a seguir. Na API, o comportamento será o descrito acima. Você poderá pedir uma nova análise até 60 após a data de atualização da categoria.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/489819773_1204274457885205_9034566102399816972_n.png?_nc_cat=103&ccb=1-7&_nc_sid=e280be&_nc_ohc=IUENiG3b3TMQ7kNvwFojCzw&_nc_oc=AdmO2klOULHMDT-TwINTnZZEmE8XTEsYcbZUZNJ5ThR2ibTRSGDxEkX89K1SzgWQSZs&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=VQ0cinvfV1uIQgld6bE-xA&oh=00_AflLYQYjdsMhZf81UDRNzLuhSbessxbE3Vy8ACEcTt7SAw&oe=69613AE8)
+
+A partir de 9 de abril de 2025, a propriedade `allow_category_change` não será mais aceita durante a criação de modelos. Anteriormente, se definida como `true` no pedido de criação do modelo, poderíamos atualizar a categoria para `marketing` se determinássemos que `marketing` era a categoria correta de acordo com o conteúdo e nossas diretrizes. Agora, esse é o comportamento padrão.
+
+### Status "pendente"
+
+O status `PENDING` significa que concordamos com a categoria escolhida no pedido de criação do modelo, mas que o modelo está em [análise do modelo](/documentation/business-messaging/whatsapp/templates/overview#template-review).
+
+**Alertas sobre status:** o resultado da análise do modelo será comunicado por email e alertas do Gerenciador do WhatsApp. Após a conclusão, um webhook [message\_template\_status\_update](/documentation/business-messaging/whatsapp/webhooks/overview) será disparado com a propriedade de evento definida como `APPROVED` ou `REJECTED`.
+
+### Status rejeitado
+
+O status `REJECTED` indica que discordamos da categoria designada no pedido de criação do modelo.
+
+**Alertas sobre status:** as rejeições são comunicadas por email e alertas do Gerenciador do WhatsApp. Após a conclusão da análise, um webhook [message\_template\_status\_update](/documentation/business-messaging/whatsapp/webhooks/reference/message_template_status_update) será disparado e a propriedade `event` será definida como `REJECTED`, com a propriedade `reason` definida como `INCORRECT_CATEGORY`.
+
+Caso seu modelo de mensagem seja rejeitado, você terá estas opções:
+
+-   [Criar outro modelo de mensagem](/documentation/business-messaging/whatsapp/templates/overview) por meio do Gerenciador do WhatsApp ou da API.-   [Editar a categoria do modelo](/documentation/business-messaging/whatsapp/templates/template-management#edit-templates) e reenviá-la para aprovação.-   [Pedir uma análise](#how-to-request-a-category-review).
+
+### Modelos duplicados na migração de números de telefone
+
+Todos os modelos qualificados são automaticamente duplicados na WABA de destino. Serão realizadas verificações de categoria para garantir que os modelos duplicados estejam categorizados de forma correta.
+
+## Como atualizamos a categoria de um modelo após a aprovação inicial
+
+1º de julho de 2024 – Para garantir que os modelos sejam categorizados de acordo com nossas diretrizes, lançamos um processo recorrente para identificar e atualizar modelos aprovados que deveriam ter sido categorizados de outra forma.
+
+Em vigor a partir de 16 de abril de 2025 – As empresas que estiverem fazendo uso indevido do nosso sistema de categorização de modelos e que já tiverem [recebido nosso aviso](#notices-when-action-is-taken), não receberão mais o aviso prévio de 24 horas mencionado abaixo se detectarmos um modelo de utilidade que deveria ser de marketing. Atualizaremos a categoria sem aviso prévio e enviaremos emails/webhooks para confirmar a alteração.
+
+As atualizações automáticas de categoria só podem ser aplicadas a modelos que não foram inicialmente aprovados de acordo com nossas diretrizes de categorização. Enviaremos um aviso prévio por diferentes canais, como webhook e email, antes de tomarmos medidas com relação aos modelos.
+
+Continue lendo para saber mais sobre como lidamos com esse processo.
+
+### **Como funciona**
+
+### Modelos aprovados como **utilidade** que deveriam ser de **marketing**
+
+-   **Período de aviso**: enviamos um aviso com um dia de antecedência antes de **atualizar a categoria do modelo para `marketing`**.
+    -   **A partir de 16 de abril de 2025 – Se você receber um aviso por categorização indevida de modelos:**
+        -   **Não será fornecido** aviso prévio de 24 horas antes de alterarmos a categoria do modelo de `UTILITY` para `MARKETING`.-   As mudanças de categoria serão **imediatas**.-   **Categoria do modelo**: a categoria do modelo é alterada para `MARKETING`.-   **Status do modelo**: não há alteração no status do modelo, ele continua como `APPROVED` e pode ser usado para enviar mensagens.
+
+### Modelos aprovados como **marketing ou utilidade** que deveriam ser de **autenticação**
+
+_Esse processo foi lançado em 1º de outubro de 2024._
+
+-   **Período de aviso**: enviamos um aviso prévio.-   **Categoria do modelo**: não há alteração na categoria do modelo.-   **Status do modelo**: no primeiro dia do mês subsequente, o modelo terá o status alterado para `REJECTED` e não poderá mais ser usado para enviar mensagens.  
+    
+
+### **Como avisaremos você**
+
+### Modelos aprovados como **utilidade** que deveriam ser de **marketing**
+
+Notificação prévia sobre atualizações de categoria
+
+Descrição
+
+_Por email_
+
+-   Enviaremos um email a todas as pessoas no perfil empresarial que receberam controle total da Conta do WhatsApp Business (WABA, pelas iniciais em inglês).-   O email conterá um link para Gerenciador do WhatsApp > Modelos de mensagem > Gerenciar modelos.-   Os modelos que tiverem categorias a serem atualizadas exibirão um ícone de "informações" ao lado do nome. Ao passar o ponteiro do mouse sobre o ícone, você verá a nova categoria e a data de atualização.-   Nos modelos que serão rejeitados, o ícone exibirá
+
+_Via webhook_
+
+Um webhook [template\_category\_update](/documentation/business-messaging/whatsapp/webhooks/reference/template_category_update) será disparado para cada modelo cuja categoria será atualizada, com uma propriedade `correct_category` na carga definida como a categoria correta do modelo. A propriedade `new_category` também aparece na carga indicando a categoria atual do modelo.
+
+_Via Gerenciador do WhatsApp_
+
+-   O painel Gerenciador do WhatsApp > Modelos de mensagem > Gerenciar modelos exibirá um banner com um link para você baixar um CSV identificando esses modelos.-   O [Suporte para Empresas](https://business.facebook.com/business-support-home/) listará o nome e a categoria atual desses modelos, bem como as categorias para as quais eles serão atualizados.
+
+Notificação quando ocorrer uma ação
+
+Descrição
+
+_Por email_
+
+-   Enviaremos um email para todas as pessoas no portfólio empresarial com controle total da WABA que é proprietária dos modelos cujas categorias foram atualizadas.-   O email destacará o número de modelos que tiveram as categorias atualizadas e incluirá um link para Gerenciador do WhatsApp > Modelos de mensagem > Gerenciar modelos. Nesse painel, serão listados o nome e a nova categoria dos modelos, bem como as categorias aplicadas antes da atualização automática. A mensagem também incluirá um link para o [Suporte para Empresas](https://business.facebook.com/business-support-home/).
+
+_Via webhook_
+
+Um webhook [template\_category\_update](/documentation/business-messaging/whatsapp/webhooks/reference/template_category_update) será disparado para cada modelo cuja categoria foi atualizada. A propriedade `new_category` indicará a nova categoria do modelo e `previous_category` informará a opção definida antes da atualização automática.
+
+### Modelos aprovados como **marketing ou utilidade** que deveriam ser de **autenticação**
+
+Notificação prévia sobre atualizações de categoria
+
+Descrição
+
+_Por email_
+
+-   Enviaremos um email para todas as pessoas no portfólio empresarial com controle total da WABA que é proprietária dos modelos cujas categorias foram atualizadas.-   O email conterá um link para Gerenciador do WhatsApp > Modelos de mensagem > Gerenciar modelos.-   Os modelos que tiverem os status atualizados para `REJECTED` exibirão um ícone de "informações" ao lado do nome. Passe o ponteiro do mouse sobre o ícone para ver a data em que o modelo será rejeitado.
+
+_Via webhook_
+
+-   Um webhook [template\_category\_update](/documentation/business-messaging/whatsapp/webhooks/reference/template_category_update) será disparado para cada modelo que for rejeitado.
+
+_Via Gerenciador do WhatsApp_
+
+-   O painel Gerenciador do WhatsApp > Modelos de mensagem > Gerenciar modelos exibirá um banner com um link para você baixar um CSV identificando esses modelos. O [Suporte para Empresas](https://business.facebook.com/business-support-home/) também listará esses modelos.
+
+Notificação quando ocorrer uma ação
+
+Descrição
+
+_Por email_
+
+-   Enviaremos um email a todas as pessoas no portfólio empresarial que receberam controle total da WABA proprietária dos modelos que tiveram as categorias atualizadas.-   O email destacará o número de modelos que foram rejeitados e incluirá um link para o painel Gerenciador do WhatsApp > Modelos de mensagem > Gerenciar modelos, onde você verá o status de rejeição.-   A mensagem também incluirá um link para o [Suporte para Empresas](https://business.facebook.com/business-support-home/).
+
+_Via webhook_
+
+Um webhook `status` será disparado para cada modelo que for rejeitado. O webhook terá a propriedade `event` definida como `REJECTED`, e a propriedade de motivo aparecerá como `INCORRECT_CATEGORY`.
+
+### Suas opções nesse processo
+
+Quando receber um aviso de que a categoria de um modelo será atualizada ou que um modelo será rejeitado, você poderá:
+
+-   Criar outro modelo-   Para **modelos de utilidade** que serão atualizados para **marketing**:
+    -   Você pode [pedir uma análise](#how-to-request-a-category-review):
+        -   Se a análise for aprovada: a categoria do modelo não será mais atualizada conforme a notificação anterior.-   Se a análise não for aprovada: o modelo será atualizado para marketing conforme a notificação anterior.-   Para **modelos de marketing ou utilidade** que serão **rejeitados**:
+    -   Não será possível pedir uma análise.-   As empresas na API de Nuvem podem acessar a [biblioteca de modelos](/documentation/business-messaging/whatsapp/templates/template-library) e encontrar opções disponíveis para seu caso de uso de verificação de identidade. Recomendamos que as empresas acessem, escolham e criem um modelo na [biblioteca de modelos](/documentation/business-messaging/whatsapp/templates/template-library) antes que o modelo de utilidade/marketing seja rejeitado para evitar interrupções no fluxo de trabalho.
+
+**Você terá 60 dias para analisar a decisão e fazer uma apelação sobre as alterações na [página inicial do Suporte para Empresas](https://business.facebook.com/business-support-home/).**
+
+### Saiba quais modelos foram ou serão atualizados
+
+### Via API
+
+Use o ponto de extremidade [`GET /<WHATSAPP_BUSINESS_ID>/message_templates`](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/template-api) para ver a lista dos modelos que já foram ou serão atualizados.
+
+Peça os campos `category` e `correct_category`, o que retornará as identificações de todos os modelos da WABA e os valores de `category` e `correct_category` de cada modelo. Depois, será possível comparar esses valores:
+
+```
+GET /<WHATSAPP_BUSINESS_ID>/message_templates?fields=category,correct_category
+```
+
+-   Se os valores corresponderem (por exemplo, ambos forem `MARKETING`), isso significa que a categoria já foi atualizada com o valor `correct_category`.-   Se não corresponderem e a `correct_category` não for uma string vazia ou nula (por exemplo, a categoria for `UTILITY`, mas `correct_category` for `MARKETING`), a categoria do modelo será atualizada no primeiro dia do mês seguinte com o valor `correct_category`.-   Se o valor `correct_category` for uma string vazia ou nula, isso quer dizer que o modelo não foi afetado.
+
+### Via Gerenciador do WhatsApp
+
+O painel "Gerenciar modelos" no Gerenciador do WhatsApp identifica todos os modelos que terão as categorias atualizadas.
+
+## Como atualizar a categoria do modelo ou pedir uma análise
+
+Esse processo está em vigor desde junho de 2023, quando lançamos nossas categorias de modelos de marketing, utilidade e autenticação.
+
+### Editar a categoria do modelo
+
+#### Via API
+
+Você pode [editar o conteúdo do modelo ou apenas a categoria](/documentation/business-messaging/whatsapp/templates/template-management#edit-templates).
+
+-   O modelo passará novamente pelos processos de validação de categoria e análise.-   Se o modelo for aprovado na validação e análise, sua categoria será atualizada e um webhook [template\_category\_update](/documentation/business-messaging/whatsapp/webhooks/reference/template_category_update) será disparado.-   A propriedade `new_category` na carga do webhook indicará a nova categoria.
+
+#### Via Gerenciador do WhatsApp
+
+Na aba **Gerenciar modelos**:
+
+-   Selecione seu modelo.-   Edite o conteúdo para que ele se alinhe às diretrizes dessa categoria.-   Envie o modelo novamente para aprovação.
+
+Se o modelo for aprovado na validação e análise, sua categoria será atualizada e um webhook [template\_category\_update](/documentation/business-messaging/whatsapp/webhooks/reference/template_category_update) será disparado. A propriedade `new_category` na carga do webhook indicará a nova categoria.
+
+### Qualificações e resultados para análise de categoria
+
+Você poderá pedir à Meta que analise a categoria do seu modelo se:
+
+-   ele for categorizado como `UTILITY` ou `MARKETING`, e o status for `REJECTED`;-   ele for categorizado como `MARKETING`, e o status for `APPROVED`.
+
+Possíveis resultados depois que você enviar um pedido sobre a categoria do seu modelo:
+
+-   Análise aprovada – A categoria será atualizada. Um webhook [template\_category\_update](/documentation/business-messaging/whatsapp/webhooks/reference/template_category_update) será disparado. A propriedade `new_category` na carga do webhook indicará a nova categoria.-   Análise rejeitada – A categoria não será alterada.
+
+### Como pedir uma análise de categoria
+
+Só é possível pedir uma análise pelo Gerenciador do WhatsApp.
+
+Na barra lateral do Gerenciador do WhatsApp, selecione o menu suspenso **Modelos de mensagem** e depois **Modelos de mensagem**. Você verá um banner de rejeição com o modelo em questão. Clique em **Ir para o Suporte para Empresas**.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/574240916_4338246056459713_8834304948412299742_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=gWPK4dkdozEQ7kNvwGfmJeU&_nc_oc=Adm2SMTWZM_9EzkwohZDabXe2_IBWewC52-ulMW5uGAFzNFyCVPoyBzjeTkP25ZYZVY&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=VQ0cinvfV1uIQgld6bE-xA&oh=00_Aflgnc6JybFYE3bcwnIs7ROljNf1Yb0h9_JgLi6XPUAHIw&oe=69613592)
+
+Clique em **Atualizações das categorias de modelo**, selecione os modelos que você quer analisar e clique no botão **Solicitar análise** para iniciar o processo.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/572294091_1191946272795209_286101462017812896_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=9nU3Zxhvmw8Q7kNvwHI5Uim&_nc_oc=AdmPqt9HmuCQO5MP1eMFoq3YCKL2S-RMBFXd_wXwm_pzztXjv1avJh62Z46DGeO5m2w&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=VQ0cinvfV1uIQgld6bE-xA&oh=00_AflUcg-xkOYvB213ca0hhus3SndJcrke2Lick4Qgmj6oeA&oe=6961260E)
+
+### Como ver os modelos que foram enviados para análise:
+
+Na barra lateral do Suporte para Empresas, clique em **Atualizações das categorias de modelo** e depois na aba **Em análise**.
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/572387663_1526245828599114_7926518049472866948_n.png?_nc_cat=101&ccb=1-7&_nc_sid=e280be&_nc_ohc=Iafn5pHZ-jYQ7kNvwHbeA0b&_nc_oc=AdlLGRgvP8sq-qDDDSdG-D6IDDgnxHfl0KEXjXuQvRAiEed2_S__L3P3MbWscZoBK8I&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=VQ0cinvfV1uIQgld6bE-xA&oh=00_AfnAcuFUKbjiz2T3ax9dbSD6S7QNnbMeDNoggaMazHZ-rQ&oe=6961150D)
+
+### Como ver decisões de categoria de modelo
+
+**Se a alteração da categoria do modelo não for aprovada**: o modelo poderá ser visualizado no Suporte para Empresas na aba **Atualizações das categorias de modelo** > **Inalterada**. A categoria do modelo será alterada para a opção correta durante uma atualização automática.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/573009027_1027592439465357_7694481853741097993_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=toh9kRfzUykQ7kNvwGyh55k&_nc_oc=AdlVDuipOWbYrYBLixDpPnHP4gZFb9TuSS8ZLZYOF2Z0LT9bHlinzgIC57cNrIyfDVc&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=VQ0cinvfV1uIQgld6bE-xA&oh=00_Afm_aqwEHlxMGj4EOEpGAkDamo00-QRAm_EEawfYFXOXXA&oe=69612737)
+
+**Se a alteração da categoria do modelo for aprovada**: o modelo poderá ser visualizado no Suporte para Empresas na aba **Atualizações das categorias de modelo** > **Revertida**. Se a categoria do modelo já tiver sido alterada durante a atualização automática, ela será revertida para a opção anterior.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/571328611_1163046995205850_3257703726786671993_n.png?_nc_cat=103&ccb=1-7&_nc_sid=e280be&_nc_ohc=TbwCRc_rtowQ7kNvwFaoTeq&_nc_oc=AdkRmgOAxr88xGVyXZo_TQCLk3c9_hWzYQeUO10GINix3FiFAEJXf-olDkw0Wbf11ck&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=VQ0cinvfV1uIQgld6bE-xA&oh=00_AflTsddsUD27xNwnjsugcyAR0kHyGt2llokXq1k136J6oQ&oe=69613014)
+
+## Restrições para empresas que fizerem uso indevido do sistema de categorização de modelos
+
+### Como funciona
+
+Fornecemos um aviso por escrito antes de restringirmos as empresas de usar a Plataforma do WhatsApp Business para mensagens de utilidade conforme descrito abaixo:
+
+-   **Aviso**: se detectarmos que uma empresa está fazendo uso indevido do sistema de categorização de modelos para aplicar a categoria de utilidade em modelos que deveriam ser categorizados como marketing, enviaremos um aviso por escrito antes de restringirmos o uso de mensagens de utilidade na Plataforma do WhatsApp Business.
+    -   **A partir de 16 de abril de 2025 – Após receber um aviso:**
+        -   **Não será fornecido** aviso prévio de 24 horas antes de alterarmos a categoria do modelo de `UTILITY` para `MARKETING`.-   As mudanças de categoria serão **imediatas**.-   **Restrição**: se identificarmos o uso indevido após esse aviso, implementaremos as restrições abaixo, que impedirão a Conta do WhatsApp Business de usar a Plataforma do WhatsApp Business para troca de mensagens de utilidade por 7 dias:
+    -   **A partir de 16 de abril de 2025 – Não rejeitaremos mais todos os modelos de `UTILITY` aprovados anteriormente. Em vez disso, eles serão recategorizados como `MARKETING`**.-   Por sete dias: as [análises de categoria](#how-to-request-a-category-review) serão desabilitadas para esses modelos-   Por 7 dias: a criação de novos modelos de utilidade será desabilitada
+
+**Para empresas que já sofreram a aplicação dessas restrições anteriormente**: se detectarmos uso indevido contínuo do nosso sistema de categorização de modelos, implementaremos tais limitações por 30 dias.
+
+### Avisos quando uma ação ocorrer
+
+Veja abaixo os avisos que disparamos:
+
+-   **Avisos** – um email é enviado a todos os administradores (pessoas com **controle total**) da Conta do WhatsApp Business. Um webhook `account_update` será enviado para informar sobre o `WARN` de restrição de utilidade para a conta do WhatsApp Business.
+    -   **Restrições** – quando aplicamos ou removemos restrições, um email é enviado a todos os administradores (pessoas com **controle total**) da conta do WhatsApp Business. Também disparamos uma alteração no objeto `restriction_info` do webhook `account_update`.
+    
+
+### Suas opções nesse processo
+
+As empresas que acreditarem que essas restrições foram aplicadas por engano poderão pedir uma análise via [Suporte para Empresas](https://business.facebook.com/business-support-home/).
+
+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/gerenciamento_de_modelos/template_comparison.md

@@ -0,0 +1,136 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-comparison -->
+<!-- Scraped: 2025-12-20T17:32:55.063Z -->
+
+# Comparação de modelos
+
+Updated: 14 de nov de 2025
+
+É possível comparar dois modelos verificando a frequência de envio de cada um, qual deles apresenta a menor taxa de bloqueios em relação aos envios, bem como o motivo principal do bloqueio de cada modelo.
+
+## Requisitos
+
+-   Um token de acesso de [usuário](/documentation/business-messaging/whatsapp/access-tokens#user-access-tokens) ou de [usuário do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens).-   A permissão [whatsapp\_business\_management](/docs/permissions/reference/whatsapp_business_management).
+
+## Limitações
+
+-   Apenas dois modelos podem ser comparados por vez.-   É preciso que os dois modelos estejam na mesma conta do WhatsApp Business.-   Os modelos devem ter sido enviados pelo menos mil vezes no intervalo de tempo especificado nas consultas.-   As janelas de retrospectiva são limitadas a 7, 30, 60 e 90 dias a partir do momento da solicitação.
+
+## Comparação de modelos
+
+Use o ponto de extremidade [WhatsApp Message Template > Compare](/docs/graph-api/reference/whats-app-business-hsm/compare) para especificar um modelo e compará-lo com outro.
+
+### Sintaxe da solicitação
+
+```
+GET /<WHATSAPP_MESSAGE_TEMPLATE_ID>/compare
+  ?template_ids=[<TEMPLATE_IDS]
+  &start=<START>
+  &end=<END>
+```
+
+### Parâmetros da consulta
+
+Espaço reservado
+
+Descrição
+
+`<WHATSAPP_MESSAGE_TEMPLATE_ID>`
+
+Identificação do modelo de mensagem do WhatsApp para direcionamento.
+
+`<TEMPLATE_IDS>`
+
+Identificação do modelo de mensagem do WhatsApp para comparar com o público.
+
+`<START>`
+
+Registro de data e hora UNIX que indica o início do período. Consulte [Períodos](#timeframes).
+
+`<END>`
+
+Registro de data e hora UNIX que indica o fim do período. Consulte [Períodos](#timeframes).
+
+### Períodos
+
+Os períodos (janelas de retrospectiva) são limitados a 7, 30, 60 e 90 dias a partir do momento da solicitação. Para definir um período, configure a data de término como o horário atual em formato de registro de data e hora UNIX e subtraia o número de dias do período desejado, em segundos, desse valor:
+
+-   Subtraia `604800` para uma janela de 7 dias.-   Subtraia `2592000` para uma janela de 30 dias.-   Subtraia `5184000` para uma janela de 60 dias.-   Subtraia `7776000` para uma janela de 90 dias.
+
+### Resposta
+
+Em caso de sucesso, a API retornará uma lista de nós [WhatsApp Business Template Comparison](/docs/graph-api/reference/whats-app-business-hsm-comparison) que descrevem a taxa de bloqueio de cada modelo, o número de envios e o principal motivo do bloqueio.
+
+```
+{
+  "data": [
+    {
+      "metric": "BLOCK_RATE",
+      "type": "RELATIVE",
+      "order_by_relative_metric": [<ORDER_BY_RELATIVE_METRIC>]
+    },
+    {
+      "metric": "MESSAGE_SENDS",
+      "type": "NUMBER_VALUES",
+      "number_values": [<NUMBER_VALUES>]
+    },
+    {
+      "metric": "TOP_BLOCK_REASON",
+      "type": "STRING_VALUES",
+      "string_values": [<STRING_VALUES>]
+    }
+  ]
+}
+```
+
+### Conteúdo da resposta
+
+Espaço reservado
+
+Descrição
+
+`<ORDER_BY_RELATIVE_METRIC>`
+
+Matriz de strings com identificações de modelos, em ordem crescente de taxa de bloqueio (relação entre bloqueios e envios).
+
+`<NUMBER_VALUES>`
+
+Matriz de objetos de valor de número de envio de mensagens. Os objetos têm as seguintes propriedades:
+
+  
+
+-   `key` — _String._ Identificação do modelo de mensagem do WhatsApp.-   `value` – _Número inteiro._ O número de vezes que o modelo de mensagem foi enviado.
+
+`<STRING_VALUES>`
+
+Matriz de objetos de valor de string do principal motivo do bloqueio. Os objetos têm as seguintes propriedades:
+
+  
+
+-   `key` — _String._ Identificação do modelo de mensagem do WhatsApp.-   `value` – _String._ Principal motivo do bloqueio.
+
+Os motivos do bloqueio podem ser os seguintes:
+
+  
+
+-   `NO_LONGER_NEEDED`-   `NO_REASON`-   `NO_REASON_GIVEN`-   `NO_SIGN_UP`-   `OFFENSIVE_MESSAGES`-   `OTHER`-   `OTP_DID_NOT_REQUEST`-   `SPAM`-   `UNKNOWN_BLOCK_REASON`
+
+Para ver as descrições desses motivos, consulte o tópico da Central de Ajuda [Visualizar métricas do seu modelo de mensagem do WhatsApp Business](https://www.facebook.com/business/help/511126334359303/).
+
+### Exemplo de solicitação
+
+```
+curl -X GET 'https://graph.facebook.com/v24.0/5289179717853347/compare?template_ids=[1533406637136032]&start=1674844791182&end=1674845395982' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "data": [    {      "metric": "BLOCK_RATE",      "type": "RELATIVE",      "order_by_relative_metric": [        "1533406637136032",        "5289179717853347"      ]    },    {      "metric": "MESSAGE_SENDS",      "type": "NUMBER_VALUES",      "number_values": [        {          "key": "5289179717853347",          "value": 1273        },        {          "key": "1533406637136032",          "value": 1042        }      ]    },    {      "metric": "TOP_BLOCK_REASON",      "type": "STRING_VALUES",      "string_values": [        {          "key": "5289179717853347",          "value": "UNKNOWN_BLOCK_REASON"        },        {          "key": "1533406637136032",          "value": "UNKNOWN_BLOCK_REASON"        }      ]    }  ]}
+```
+
+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)