As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Usando modelos de mensagem no AWS End User Messaging Social **Importante** A partir de 01/04/2025, o Meta bloqueará os modelos de mensagens de marketing enviados para o código de país dos EUA de. `+1` Para obter mais informações, consulte [Limites de mensagens do modelo de marketing por usuário](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates#per-user-marketing-template-message-limits) na *WhatsAppBusiness Platform Cloud API Reference*. Você pode usar modelos de mensagem para criar tipos de mensagem que você usa com frequência, como boletins semanais ou lembretes de compromissos. As mensagens modelo são o único tipo de mensagem que pode ser enviada aos clientes que ainda não enviaram mensagens para você ou que não enviaram uma mensagem nas últimas 24 horas. O Meta atribui a cada modelo uma classificação de qualidade e um status. A classificação de qualidade afeta o status de um modelo e diminui o ritmo ou a taxa de envio de um modelo. Os modelos são associados à sua conta WhatsApp comercial (WABA), podem ser gerenciados por meio do console social do AWS End User Messaging e são revisados por WhatsApp. Você pode enviar os seguintes tipos de modelo: + Baseado em texto + Baseado em mídia + Mensagem interativa + Baseado na localização + Modelos de autenticação com botões de senha de uso único + Modelos de mensagens para vários produtos O Meta fornece modelos de amostra pré-aprovados. Para saber mais, consulte [Exemplos de modelos de mensagem](https://www.facebook.com/business/help/722393685250070). Para obter mais informações sobre os tipos de modelos de mensagem, consulte [Modelo de mensagem](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates) na *WhatsApp Business Platform Cloud API Reference*. ## Usando modelos de mensagens no AWS Console Crie e gerencie seus modelos de WhatsApp mensagens diretamente no console social do AWS End User Messaging. 1. Abra o console social do AWS End User Messaging em [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/). 1. Escolha **Conta comercial e, em** seguida, escolha uma WABA. 1. Na guia **Modelos de mensagem**, você pode: + **Crie novos modelos** escolhendo **Criar modelo** e seguindo o fluxo de trabalho de criação de modelos + **Visualize o status do modelo** para ver quais modelos foram aprovados, pendentes ou rejeitados + **Edite modelos existentes** selecionando um modelo e escolhendo **Editar** + **Exclua modelos** que não são mais necessários Os modelos devem ser aprovados pela Meta antes de poderem ser usados para enviar mensagens aos seus clientes. Você pode monitorar o status de aprovação dos seus modelos no console. # Gerenciamento de modelos de mensagens no console da AWS ## Criando um modelo de mensagem 1. Abra o console social do AWS End User Messaging em [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/). 1. Escolha **Conta comercial e, em** seguida, escolha uma WABA. 1. Na guia **Modelos de mensagem**, escolha **Criar modelo**. 1. Configure seu modelo: + **Nome do modelo**: insira um nome exclusivo para seu modelo (somente letras minúsculas, números e sublinhados) + **Categoria**: selecione a categoria do modelo (Marketing, Utilitário ou Autenticação) + **Idioma**: escolha o idioma para o conteúdo do seu modelo + **Cabeçalho (opcional)**: adicione texto, mídia ou uma variável ao cabeçalho + **Corpo**: insira o texto da mensagem (você pode incluir variáveis usando `{{1}}``{{2}}`, etc.) + **Rodapé (opcional)**: adicione texto de rodapé (até 60 caracteres) + **Botões (opcional)**: botões de adição call-to-action ou resposta rápida 1. Selecione **Criar modelo**. Seu modelo é enviado ao Meta para análise. A aprovação normalmente leva de alguns minutos a 24 horas. ## Visualizando o status do modelo Os modelos podem ter os seguintes status: + **Aprovado**: o modelo está pronto para uso + **Pendente**: o modelo está sendo analisado pela Meta + **Rejeitado**: o modelo não foi aprovado (passe o mouse sobre o status para ver o motivo) + **Desativado**: o modelo foi pausado devido a classificações de baixa qualidade Para visualizar seus modelos, navegue até a guia **Modelos de mensagem** na página de detalhes do WABA. ## Editar um modelo de mensagem 1. Selecione o modelo que você deseja modificar. 1. Escolha **Editar**. 1. Faça suas alterações no conteúdo do modelo. 1. Escolha **Salvar**. **Importante** Quando você edita e envia um modelo aprovado, ele entra em um estado pendente e exige a aprovação do Meta. O modelo fica indisponível para uso até que o Meta aprove suas alterações. Considere o impacto em seus fluxos de trabalho de mensagens antes de editar os modelos que estão sendo usados ativamente. ## Excluir um modelo de mensagem 1. Selecione o modelo que você deseja remover. 1. Escolha **Excluir**. 1. Confirme a exclusão. Os modelos excluídos não podem ser recuperados. Se você estiver usando o modelo em campanhas ativas, essas mensagens falharão após a exclusão. ## Classificações de qualidade do modelo O Meta atribui classificações de qualidade aos seus modelos com base no feedback e no engajamento do cliente. Modelos com classificações de baixa qualidade podem ser pausados ou desativados. Para manter boas classificações de qualidade: + Envie conteúdo relevante e valioso para seus clientes + Evite enviar mensagens com muita frequência + Forneça opções claras de exclusão + Responda prontamente às respostas dos clientes Você pode ver as classificações de qualidade na página de detalhes do modelo. ## Variáveis de modelo Use variáveis para personalizar suas mensagens. As variáveis são definidas usando chaves duplas com números (`{{1}}`,`{{2}}`, etc.). Ao enviar uma mensagem, você fornece os valores reais para essas variáveis. As variáveis devem ser fornecidas em ordem sequencial a partir de`{{1}}`. **Example Modelo com variáveis** Texto do modelo: `Hello {{1}}, your order {{2}} will be delivered on {{3}}.` Ao enviar: `{{1}}` Substitua pelo nome do cliente, `{{2}}` pelo número do pedido e `{{3}}` pela data de entrega. ## Categorias de modelos Marketing Conteúdo promocional, anúncios de produtos ou ofertas. Esses modelos podem ter limitações de envio. Utilitário Atualizações da conta, notificações de pedidos ou mensagens de atendimento ao cliente. Esses modelos geralmente têm limites de envio mais altos. Autenticação Senhas de uso único ou códigos de verificação. Esses modelos têm a maior prioridade e limites de envio. Escolha a categoria que melhor corresponde ao seu caso de uso. A classificação incorreta dos modelos pode resultar em rejeição ou restrições de conta. # Criação de modelos de mensagens com a CreateWhatsAppMessageTemplate API Você pode criar modelos de WhatsApp mensagem personalizados usando a API. Este tópico descreve como usar o [CreateWhatsAppMessageTemplate](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_CreateWhatsAppMessageTemplate.html)para criar uma variedade de modelos de mensagem. ## Componentes do modelo de mensagem os modelos de mensagem podem incluir os seguintes componentes: + **Cabeçalho**: texto do título que aparece na parte superior + **Corpo**: conteúdo da mensagem principal com espaços reservados variáveis + **Rodapé**: informações adicionais na parte inferior + **Botões**: elementos clicáveis vinculados a URLs Nos exemplos a seguir, substitua *ENDPOINT* e *WABA\$1ID* por sua URL e ID reais do endpoint. ## Crie um modelo básico de utilitário em inglês Este exemplo cria um modelo de mensagem de utilitário em inglês que usa somente o `BODY` componente e não inclui`HEADER`,`FOOTER`, ou `BUTTON` componentes. O corpo do texto usa espaços reservados variáveis. ``` $ aws socialmessaging create-whatsapp-message-template --region us-east-1 --endpoint-url ENDPOINT_URL \ --id WABA_ID \ --template-definition '{ "name": "order_update_basic", "language": "en_US", "allow_category_change": true, "category": "UTILITY", "components": [ { "type": "BODY", "text": "Hi {{1}}, your order #{{2}} has been shipped. Track your delivery below." } ] }' ``` ## Crie um modelo básico de utilitário em inglês com botão Este exemplo cria um modelo de mensagem de utilitário em inglês que inclui `BODY` `BUTTON` componentes. ``` $ aws socialmessaging create-whatsapp-message-template --region us-east-1 --endpoint-url ENDPOINT_URL \ --id WABA_ID \ --template-definition '{ "name": "order_update_with_button", "language": "en_US", "allow_category_change": true, "category": "UTILITY", "components": [ { "type": "BODY", "text": "Hi {{1}}, your order #{{2}} has been shipped. Track your delivery below." }, { "type": "BUTTONS", "buttons": [ { "type": "URL", "text": "Track Order", "url": "https://example.com/track" } ] } ] }' ``` ## Crie um modelo complexo de mensagem utilitária em inglês com cabeçalho, corpo e botão Este exemplo cria um modelo de mensagem de utilitário em inglês que inclui`HEADER`,`BODY`, e `BUTTON` componentes. ``` $ aws socialmessaging create-whatsapp-message-template --region us-east-1 --endpoint-url ENDPOINT_URL \ --id WABA_ID \ --template-definition '{ "name": "account_creation_confirmation_3333", "category": "UTILITY", "language": "en_US", "status": "APPROVED", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Finalize account set-up" }, { "type": "BODY", "text": "Hi {{1}},\n\nYour new account has been created successfully. \n\nPlease verify {{2}} to complete your profile.", "example": { "body_text": [ [ "John", "your email address" ] ] } }, { "type": "BUTTONS", "buttons": [ { "type": "URL", "text": "Verify account", "url": "https://www.example.com/" } ] } ] }' ``` ## Crie um modelo básico de mensagem de marketing Este exemplo cria um modelo básico de mensagem de marketing que inclui somente um `BODY` componente. ``` $ aws socialmessaging create-whatsapp-message-template --region us-east-1 --endpoint-url ENDPOINT_URL \ --id WABA_ID \ --template-definition '{ "id": "1290345849293233", "name": "holiday_special_1395238", "category": "MARKETING", "language": "en_US", "status": "PENDING", "components": [ { "type": "BODY", "text": "Season's Greetings {{1}}!\n\nCelebrate {{2}} with amazing deals up to {{3}} off.\n\nPlus, get free gift wrapping on all orders above $50.", "example": { "body_text": [ [ "Pawan", "Christmas", "30%" ] ] } } ], "metaTemplateId": "1290345849293233" }' ``` ## Crie um modelo complexo de mensagem de marketing Este exemplo cria um modelo de mensagem de marketing em inglês que inclui`HEADER`,`BODY`, e `BUTTON` componentes. ``` $ aws socialmessaging create-whatsapp-message-template --region us-east-1 \ --endpoint-url ENDPOINT_URL \ --id WABA_ID \ --template-definition '{ "name": "summer_sale_1", "category": "MARKETING", "language": "en_US", "status": "APPROVED", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Summer Sale!" }, { "type": "BODY", "text": "Hi {{1}}! Get {{2}} off all summer items. Shop now before stock runs out!" }, { "type": "FOOTER", "text": "Valid until August 31st" }, { "type": "BUTTONS", "buttons": [ { "type": "URL", "text": "Shop Now", "url": "https://example.com/sale" } ] } ] }' ``` ## Próximas etapas Depois de criar ou editar um modelo, você deve enviá-lo para análise com WhatsApp. A revisão do Meta pode levar até 24 horas. O Meta envia um e-mail para o administrador do seu Business Manager e atualiza o status do modelo. Você pode verificar o status do seu modelo no console social do AWS End User Messaging. # Entendendo o ritmo dos modelos em WhatsApp O ritmo de modelos é um método usado pela Meta que permite o feedback antecipado do cliente sobre modelos novos ou modificados. Ele identifica e pausa modelos que recebem pouco engajamento ou feedback, dando a você tempo para ajustar o conteúdo do modelo antes de enviá-lo para muitos clientes. Isso reduz o risco de o feedback negativo do cliente afetar os negócios. Por exemplo, se muitos clientes “bloquearem” sua mensagem ou se seu modelo tiver baixas taxas de leitura, a classificação de qualidade do modelo poderá ser reduzida. O ritmo dos modelos afeta modelos recém-criados, modelos que não foram pausados e modelos sem uma classificação de alta qualidade. O ritmo dos modelos geralmente é iniciado por um histórico anterior de modelos pausados ou de baixa qualidade. Quando um modelo é embalado, as mensagens que usam esse modelo são enviadas normalmente até um determinado limite determinado pelo Meta. Depois disso, as mensagens subsequentes são retidas para dar tempo ao feedback do cliente. Se o feedback for positivo, o ritmo do modelo será então ampliado. Se o feedback for negativo, o ritmo do modelo será reduzido, permitindo que você ajuste o conteúdo do modelo. Para obter mais informações, consulte [Ritmo de modelos](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines#template-pacing) na *Referência da API Cloud da WhatsApp Business Platform*. # Obtenha feedback sobre o status reduzido de um modelo com o Manager WhatsApp O Meta fornece informações sobre o motivo pelo qual o status de um modelo foi reduzido. Use o feedback do Meta para editar o modelo e enviá-lo para reaprovação, usar um modelo diferente ou alterar o comportamento do seu aplicativo. Se você editar o modelo de mensagem e ele for reaprovado, sua classificação de qualidade melhorará gradualmente, desde que não receba feedback negativo frequente ou baixas taxas de leitura. 1. Abra o console social do AWS End User Messaging em [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/). 1. Escolha **Conta comercial e, em** seguida, escolha uma WABA. 1. Na guia **Modelos de mensagem**, selecione o modelo com status reduzido. 1. Veja os detalhes do modelo para ver o feedback sobre por que a classificação foi reduzida. Você também pode passar o mouse sobre o indicador de status para obter informações adicionais. # Entendendo o status e a classificação de qualidade de um modelo no WhatsApp Cada modelo de mensagem recebe uma classificação de qualidade com base no uso, no feedback do cliente e no engajamento do cliente. Um modelo só pode ser usado se o status for Ativo, mas a qualidade determina o ritmo do modelo. Se um modelo de mensagem receber feedback negativo de forma consistente ou apresentar baixo engajamento, isso causará uma alteração no status do modelo. O Meta altera automaticamente o status ou a classificação de qualidade de um modelo com base no feedback negativo ou positivo e no engajamento. Se o status do seu modelo mudar, você receberá um e-mail e uma notificação do evento. Você pode verificar o status do seu modelo no console social do AWS End User Messaging. Se seu modelo for rejeitado por WhatsApp, você poderá editá-lo e reenviá-lo para aprovação ou entrar com uma contestação junto WhatsApp. Para saber mais, consulte [Apelações](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines#appeals) na *Referência da API Cloud da WhatsApp Business Platform*. **** | Status do modelo | Classificação de qualidade | Significado | | --- | --- | --- | | Em análise | | O modelo da mensagem está sendo revisado. Isso pode levar até 24 horas para ser concluído. | | Rejeitado | | O modelo de mensagem foi rejeitado e você pode entrar com uma apelação. | | Ativo | Pendente | O modelo de mensagem não recebeu feedback de qualidade nem informações de taxa de leitura dos clientes, mas o modelo ainda pode ser usado para enviar mensagens. | | Ativo | Alto | O modelo de mensagem recebeu pouco ou nenhum feedback negativo do cliente e pode ser usado para enviar mensagens. | | Ativo | Médio | O modelo de mensagem recebeu feedback negativo dos clientes ou baixas taxas de leitura e pode estar pausado ou desativado. | | Ativo | Baixo | O modelo de mensagem recebeu feedback negativo dos clientes ou baixas taxas de leitura. Modelos de mensagem com esse status podem ser usados, mas correm o risco de serem pausados ou desativados. Quando um modelo passa para o status Ativo-Baixo, seu envio é pausado. A primeira pausa é de três horas, a segunda pausa é de seis horas e a próxima pausa desativa o modelo. | | Paused | | O modelo de mensagem foi pausado devido ao feedback negativo recorrente dos clientes ou às baixas taxas de leitura. | | Desabilitado | | O modelo de mensagem foi desativado devido ao feedback negativo recorrente dos clientes. | | Apelação solicitada | | Uma apelação foi solicitada. | # Razões pelas quais um modelo é rejeitado no WhatsApp Se seu modelo de mensagem for revisado e rejeitado pelo Meta, você receberá um e-mail explicando por que o modelo foi rejeitado. Você pode contestar a rejeição ou modificar seu modelo de mensagem. Esses são alguns dos motivos comuns pelos quais o Meta pode rejeitar um modelo de mensagem: + Os parâmetros variáveis contêm caracteres especiais, como \$1, \$1 ou%. + Os parâmetros variáveis estão ausentes, têm colchetes incompatíveis ou não são sequenciais. + O modelo de mensagem contém conteúdo que viola a [Política WhatsApp Comercial ou a Política WhatsApps ](https://www.whatsapp.com/legal/commerce-policy/) [Comercial](https://www.whatsapp.com/legal/business-policy/). Para obter mais informações, consulte [Motivos comuns de rejeição](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines#common-rejection-reasons) na *referência da WhatsApp Business Platform Cloud API*.