Whatsapp Template messages: Impedimentos e configurações

Whatsapp Template messages: Impedimentos e configurações

Aqui poderemos ver soluções para possíveis impedimentos, reprovações e erros no processo de criação, envio e alterações nas template messages do Whatsapp. Segue os tópicos a seguir para as demais informações.

Processo de aprovação (Responsabilidade da Meta)

Depois de criar o modelo, você poderá enviá-lo para aprovação. Pode levar até 24 horas para que uma decisão de aprovação seja tomada. Assim que a decisão for tomada, uma notificação aparecerá no Gerenciador do WhatsApp. Além disso, a META enviará um email para os administradores do Gerenciador de Negócios. Caso você tenha assinado as atualizações sobre alterações de status do modelo de mensagem, a META também enviará uma notificação de webhook. Consulte Como monitorar alterações de status.

Caso seja aprovado, o modelo de mensagem ficará com o status Ativo – Qualidade pendente. Com isso, você poderá começar a enviá-lo aos clientes. Se rejeitado, o modelo poderá ser editado e reenvido para aprovação. Outra possibilidade é fazer uma apelação da decisão.

Exemplos

Recomendamos que você inclua um exemplo antes de enviar o modelo para aprovação. Os exemplos permitem que você envie exemplos de ativos de mídia e valores de texto para variáveis de mídia ou texto exigidos pelo modelo. Com isso, fica mais fácil visualizarmos como o modelo aparecerá para os clientes.

Além disso, caso o envio seja rejeitado e você decida fazer uma apelação, será preciso incluir um exemplo na sua apelação. Por isso, é melhor já incluí-lo no envio inicial.

Para incluir um exemplo no envio, primeiro crie o seu modelo, adicionando as variáveis necessárias. Depois, clique no botão Adicionar exemplo. O painel de pré-visualização renderizará os exemplos de ativos de mídia ou valores de texto fornecidos.

Motivos comuns para rejeição

Estes são os erros mais comuns que levam à rejeição do envio e devem ser evitados:

• Os parâmetros variáveis estão ausentes ou apresentam chaves incompatíveis. O formato correto é {{1}}.
• Os parâmetros variáveis têm caracteres especiais, como #, $ ou %.
• Os parâmetros variáveis não são sequenciais. Por exemplo, {{1}}, {{2}}, {{4}} e {{5}} são definidos. No entanto, o parâmetro {{3}} não existe.
• O modelo de mensagem apresenta conteúdo que viola a Política Comercial do WhatsApp: quando você promove a venda de bens e serviços, todas as mídias e mensagens relacionadas aos seus produtos são consideradas transações. Isso inclui descrições, preços, tarifas, impostos e/ou divulgações legais obrigatórias. As transações precisam estar em conformidade com a Política Comercial do WhatsApp.
• O modelo de mensagem tem conteúdo que viola a Política de WhatsApp Business: não solicite identificadores sensíveis dos usuários. Por exemplo, não peça aos clientes que compartilhem números completos de cartões de crédito e débito individuais, números de conta financeira, número de identificação nacional nem outras informações confidenciais. Isso inclui não solicitar aos usuários documentos que possam conter identificadores sensíveis. Solicitar identificadores parciais (por exemplo, os últimos 4 dígitos do CPF) é aceitável.
• O conteúdo é potencialmente abusivo ou ameaçador. Por exemplo, ameaça o cliente com ações legais ou constrangimento público.
• O modelo de mensagem é uma duplicata de um existente. Se um modelo for enviado com o mesmo texto de um existente no corpo e no rodapé, a duplicata será rejeitada. Uma notificação de rejeição incluindo o motivo aparecerá na Qualidade da Conta no Gerenciador do WhatsApp e será enviada por email. Na notificação de Qualidade da Conta, é possível consultar o nome e o idioma do modelo existente que tem o mesmo conteúdo do duplicado rejeitado. Você também pode editar e reenviar o modelo. Vale lembrar que esta verificação não se aplica aos modelos de OTP.

Edição

É possível editar o modelo por meio do Gerenciador do WhatsApp ou do ponto de extremidade Modelo de mensagem. Caso seja editado e reenviado para aprovação, o modelo de mensagem ficará com o status Em análise e não poderá ser enviado a clientes até que esteja Ativo.

Como enviar modelos de mensagem

Quando o modelo for aprovado, você poderá enviá-lo aos clientes. Para enviar um modelo de mensagem, consulte Enviar modelos de mensagem para usuários da API de Nuvem ou Como enviar modelos de mensagem para usuários da API Local.

Somente modelos com status Ativo (por exemplo, Ativo – Qualidade pendente, Ativo – Alta qualidade) podem ser enviados para os clientes.

O status pode ser alterado automaticamente de Ativo para Pausado ou Desativado com base no feedback dos clientes. Por isso, recomendamos que você monitore as alterações de status e tome as medidas apropriadas quando um modelo de mensagem do qual você depende seja pausado ou desativado ou corra esse risco.

Status

Os modelos podem ter os status a seguir.

• Em análise: indica que o modelo ainda está em análise. A análise pode levar até 24 horas.
• Rejeitado: o modelo foi rejeitado durante o processo de análise. Consulte Apelações.
• Ativo – Qualidade pendente: o modelo de mensagem ainda precisa receber feedback dos clientes em relação à qualidade. Os modelos de mensagem com esse status podem ser enviados aos clientes. Consulte Classificação de qualidade.
• Ativo – Alta qualidade: o modelo recebeu pouco ou nenhum feedback negativo dos clientes. Os modelos de mensagem com esse status podem ser enviados aos clientes. Consulte Classificação de qualidade.
• Ativo – Qualidade média: o modelo recebeu feedback negativo de diversos clientes e pode ser pausado ou desativado em breve. Os modelos de mensagem com esse status podem ser enviados aos clientes. Consulte Classificação de qualidade.
• Ativo – Qualidade baixa: o modelo recebeu feedback negativo de diversos clientes. Os modelos com esse status podem ser enviados aos clientes, mas talvez sejam suspensos ou desativados em breve. Por isso, recomendamos que você resolva os problemas relatados pelos clientes. Consulte Classificação de qualidade.
• Pausado: o modelo foi pausado devido a feedback negativo recorrente dos clientes. Os modelos de mensagem com esse status não podem ser enviados aos clientes. Consulte Pausa no modelo.
• Desativado: o modelo foi desativado devido a feedback negativo recorrente dos clientes ou à violação de uma ou mais das nossas políticas. Os modelos de mensagem com esse status não podem ser enviados aos clientes. Talvez seja possível editar um modelo de mensagem desativado e fazer uma apelação. Consulte Apelações.
• Apelação solicitada: indica que foi feita uma apelação. Consulte Apelações.

Você pode consultar o status de um modelo em Gerenciador do WhatsApp > Visão geral. Depois, passe o mouse sobre o ícone da mala (Ferramentas de conta) e clique em Modelos de mensagem. Caso você tenha mais de uma conta do WhatsApp Business, selecione a conta cujo status do modelo você quer consultar na lista de contas no menu suspenso do canto superior direito.

Como monitorar alterações de status

O status de um modelo pode mudar automaticamente com base em decisões da análise, resultados de apelações ou mudanças na classificação de qualidade. Se o status de um modelo for alterado, você receberá uma notificação por email, no Gerenciador de Negócios e no webhook.

Como você pode enviar somente modelos de mensagem com status Ativo, recomendamos que você assine o campo message_template_status_update webhook para receber notificações sobre as alterações de status nos modelos. Consulte Configuração de Webhooks para saber como assinar esse campo e Atualizações no modelo de mensagem para exemplos de cargas de webhook.

Se você configurou os webhooks e viu que a qualidade de um modelo está caindo, acesse Gerenciador do WhatsApp > Modelos de mensagem e passe o mouse sobre o modelo de mensagem em questão. Uma dica será exibida e mostrará informações sobre o problema. Com base nessas informações, é possível optar por editar o modelo e enviá-lo para reaprovação, utilizar um modelo diferente ou alterar a lógica de negócios do seu app. Caso você edite o modelo de mensagem e ele seja aprovado, a classificação de qualidade melhorará gradualmente se ele não receber feedback negativo com frequência.

Classificação de qualidade

Os modelos de mensagem têm uma classificação de qualidade baseada no uso e no feedback dos clientes. Quando o status for Ativo, classificação do modelo de mensagem aparecerá no Gerenciador do WhatsApp ao lado do status:

• Ativo – Qualidade pendente (realce em verde)
• Ativo – Alta qualidade (realce em verde)
• Ativo – Qualidade média (realce em amarelo)
• Ativo – Qualidade baixa (realce em vermelho)

Inicialmente, os modelos de mensagem aprovados têm a classificação Qualidade pendente. Se um modelo de mensagem receber feedback negativo continuamente, isso causará mudança no status do modelo. Enquanto o modelo de mensagem tiver o status Ativo, independentemente da classificação de qualidade, ele poderá ser enviado aos clientes. Quando o status for alterado, ele não pode ser enviado aos clientes até que fique ativo novamente.

Não oferecemos webhooks para feedback de modelo de mensagem ou alterações na classificação de qualidade. Entretanto, podemos enviar uma notificação de webhook quando houver alterações no status dos modelos. Por isso, recomendamos que você configure os webhooks, fique atento às alterações no status do modelo e tome as medidas apropriadas antes que o modelo seja pausado ou desativado. Consulte Como monitorar alterações de status.

Pausa no modelo

Disponibilizada para empresas configuradas no Brasil, no México e na Colômbia em 7 de setembro de 2022 e em todos os outros países em 6 de outubro de 2022.

Se um modelo de mensagem atingir a classificação de qualidade mais baixa (status Ativo – Qualidade baixa), ele será automaticamente pausado por um período para proteger a classificação de qualidade dos números de telefone que o usaram. As durações das pausas são as seguintes:

• Primeira instância: Pausado por 3 horas.
• Segunda instância: Pausado por 6 horas.
• Terceira instância: Desativado.

Quando um modelo de mensagem é pausado (status Pausado), ele não pode ser enviado aos clientes. Por isso, você precisa interromper as campanhas de mensagens automáticas que dependam desse modelo. Apesar de a tentativa de envio de um modelo pausado não ser cobrada e não contar contra o limite de mensagens, a API as rejeitará. Retome essas campanhas somente quando o status do modelo voltar a ser Ativo.

Você pode editar um modelo pausado caso acredite que isso fará com que ele receba menos feedback negativo. Porém, se você fazer isso, o modelo ficará com o status Em análise e não poderá ser enviado aos clientes até que seja aprovado novamente e tenha o status Ativo.

Também é possível alterar a lógica dos negócios (definição do público-alvo, parâmetros de entrega, entre outros) caso você acredite que isso está influenciando o feedback negativo.

Inicialmente, a pausa não afetará o número de telefone comercial nem reduzirá o limite de mensagens. Outros modelos de mensagem com alta qualidade podem continuar sendo enviados do número de telefone. Entretanto, se a empresa continuar usando modelos com Qualidade baixa depois de eles serem pausados, o número de telefone poderá ser afetado em algum momento.

Notificações de pausa

Quando um modelo de mensagem for pausado, enviaremos uma notificação no Gerenciador do WhatsApp, por email e webhook (caso você tenha assinado webhooks de alterações nos modelos de mensagem). Consulte Como monitorar alterações de status para ver informações sobre a configuração do webhook e Exemplos – Modelo pausado para ver um exemplo de carga de webhook.

Retomar

O modelo será retomado automaticamente depois da conclusão da pausa descrita acima. Depois de retomado, o modelo terá status Ativo e poderá ser enviado aos clientes novamente. Caso você não tenha interrompido as campanhas de mensagens automáticas que dependiam do modelo, elas voltarão a funcionar. No entanto, recomendamos que você interrompa as campanhas que dependam de modelos suspensos até que eles sejam retirados da pausa, porque as nossas APIs rejeitarão as solicitações.

A classificação de qualidade do modelo também será definida para um valor baseado no feedback mais recente.

Assim como as notificações de pausa, enviaremos notificações pelo Gerenciador do WhatsApp, por email e webhook quando o status do modelo for definido como Ativo.

Apelações

Caso o envio seja rejeitado, você poderá fazer uma apelação. Vale lembrar que as apelações devem incluir um exemplo. Se um modelo aprovado for desativado, você também poderá editá-lo e reenviá-lo para aprovação.

No Gerenciador do WhatsApp:

1. Passe o mouse sobre o ícone de mala (Ferramentas da conta) e clique em Modelos de mensagem.
2. Se você tiver várias contas do WhatsApp Business, use o menu suspenso no canto superior direito para selecionar a conta cujos modelos você quer gerenciar.
3. Encontre o modelo de mensagem que você quer de editar e clique nele.
4. Edite o conteúdo do modelo.
5. Clique no botão Adicionar exemplo. Adicione as variáveis de valores e imagens.
6. Clique em Enviar.

A META analisa e toma uma decisão dentro de 24 horas.

Saiba mais

• Política do WhatsApp Business: saiba mais sobre as políticas para empresas.
• Política Comercial do WhatsApp: saiba mais sobre as políticas comerciais.
• Aplicação das Políticas: saiba mais sobre como aplicamos as políticas