Modelos de carrossel do WhatsApp
Os modelos de carrossel do WhatsApp permitem criar mensagens interativas com vários cartões pelos quais os usuários podem deslizar. Cada carrossel pode conter até 10 cartões com imagens ou vídeos, além de botões personalizáveis para engajamento. Esse recurso é ideal para apresentar seus produtos e serviços, ou conteúdo em várias etapas em um formato visualmente atraente.
Pré-requisitos
Antes de criar modelos de WhatsApp, você deve concluir a configuração do WhatsApp e ter:
- Uma conta ativa do WhatsApp Business (WABA) conectada à Braze
- Grupos de inscrições apropriados configurados na sua WABA
- Ativos de mídia (imagens ou vídeos) prontos para fazer upload
- Permissões da Braze para usuários não administradores
- Para que os usuários criem novos modelos no Template Builder:
- “View WhatsApp Message Templates”
- “Edit WhatsApp Message Templates”
- Para que os usuários redijam campaigns ou Canvas com modelos de carrossel:
- “View WhatsApp Message Templates”
- Para que os usuários criem novos modelos no Template Builder:
- Conhecimento de modelos Liquid (opcional, para conteúdo dinâmico)

Todos os números de telefone e grupos de inscrições dentro da mesma conta do WhatsApp Business (WABA) compartilham modelos. Se você tiver múltiplos grupos de inscrições em uma WABA, todos podem acessar os mesmos modelos de carrossel. No entanto, os modelos não são compartilhados entre WABAs diferentes.
Criar um modelo de carrossel
Você pode criar modelos de carrossel na Braze com o construtor de modelos do WhatsApp. Ao criar modelos, a Braze valida seu conteúdo para atender aos critérios da Meta.
Ao criar um modelo na Braze, você pode usar:
- Liquid que você espera usar ao enviar a mensagem. A Braze salva isso para referência futura.
- Variáveis genéricas como
{{1}}.

As Liquid tags {% %} não são compatíveis com o construtor de modelos porque não atendem aos critérios de conteúdo da Meta.
Após o envio do modelo, ele aparece na lista de modelos da WABA e é revisado em até 24 horas. No entanto, a revisão geralmente ocorre em poucos minutos.
Etapa 1: Acessar o construtor de modelos
- Na Braze, acesse Modelos.
- Selecione Modelos de WhatsApp nas opções disponíveis.

- Selecione Criar modelo de carrossel.

Etapa 2: Configurar as definições do modelo
Preencha os campos obrigatórios.
| Campo | Descrição |
|---|---|
| Conta do WhatsApp Business | Selecione a WABA onde este modelo será armazenado. Lembre-se de que todos os grupos de inscrições e números de telefone dentro desta WABA terão acesso ao modelo. |
| Idioma do modelo | Selecione o idioma do seu modelo. A Meta restringe os modelos a um único idioma, então escolha o idioma que seu público verá. |
| Nome do modelo | Insira um nome descritivo que ajude a identificar este modelo posteriormente. Os nomes de modelo não podem conter espaços — use underscores ou remova os espaços completamente (como carousel_example ou carouselexample). |
| Categoria | Definida automaticamente como Marketing. Todas as mensagens de carrossel são categorizadas como mensagens de marketing. |

Etapa 3: Adicionar conteúdo do corpo
Toda mensagem de carrossel deve começar com o conteúdo do corpo, que é o texto exibido acima dos cartões do carrossel.
Você pode incluir variáveis Liquid para personalização, como {{first_name}}, que cria um espaço de variável vazio que pode ser preenchido com conteúdo dinâmico ou modificado posteriormente ao usar o modelo em Campaigns. As variáveis não podem ser colocadas no início ou no final do conteúdo do corpo.
Etapa 4: Configurar as definições do carrossel
Antes de criar cartões individuais, defina a estrutura geral do carrossel com as configurações do carrossel. Essas configurações se aplicam a todos os cartões e não podem ser alteradas após o envio do modelo.
Tipo de mídia
Escolha o tipo de mídia: Imagem ou Vídeo. Isso é usado para todos os cartões.

Configuração de botões
Escolha o tipo de botão: Resposta rápida, Número de telefone ou Visitar site. Essa configuração é usada para todos os cartões. Em seguida, selecione até dois botões por cartão.
Etapa 5: Criar cartões do carrossel
Agora você pode criar cartões individuais do carrossel. Todos os cartões mantêm o mesmo formato e estrutura. Você pode adicionar até 10 cartões, mas deve adicionar pelo menos dois.

Não é possível alterar o número de cartões após enviar o modelo para revisão da Meta.
- Faça upload de uma imagem ou vídeo, dependendo do tipo de mídia selecionado.
- Adicione o texto ou a descrição do cartão.
- Configure o texto e as ações dos botões.
- Adicione variáveis Liquid onde necessário. Você pode adicioná-las onde houver um botão + (mais).

Use variáveis Liquid estrategicamente para personalizar conteúdo como porcentagens de desconto, nomes de produtos ou ofertas específicas para o usuário. As variáveis podem ser adicionadas ao texto do cartão, texto do botão e URLs.

Etapa 6: Pré-visualizar e enviar
- Use a seção Pré-visualização para ver como seu carrossel aparecerá para os usuários.
- Selecione Enviar para revisão da Meta para que a Braze envie o modelo para aprovação da Meta.
- A aprovação geralmente leva poucos minutos, mas pode levar até 24 horas.
- Verifique o status do modelo na lista de Modelos na página de modelos do WhatsApp ou no seletor de Canvas e Campaign.

O envio de teste não está disponível até que a Meta aprove o modelo. O status do modelo aparece como Rascunho durante a criação e muda para Aprovado após a Meta concluir a revisão.
Usar modelos de carrossel
Após a aprovação do seu modelo de carrossel pela Meta, você pode usá-lo em Campaigns e Canvas. O processo é semelhante para ambos os tipos de mensagem.
Etapa 1: Criar uma mensagem do WhatsApp
- Na Braze, acesse Campaigns ou Canvas e crie uma mensagem do WhatsApp.
- Selecione o grupo de inscrições que corresponde à conta do WhatsApp Business (WABA) do seu modelo.

Se você tiver várias contas do WhatsApp Business, selecione um grupo de inscrições da mesma WABA onde o modelo foi criado. Os modelos não são compartilhados entre WABAs, mas são compartilhados entre todos os grupos de inscrições e números de telefone dentro da mesma WABA.
Etapa 2: Selecionar seu modelo de carrossel
- Pesquise seu modelo pelo nome (como “carousel_example”).
- Verifique se o status do modelo é Aprovado.
- Selecione o modelo para carregá-lo no criador de mensagens.
Etapa 3: Personalizar conteúdo dinâmico
Quando seu modelo é carregado, ele contém conteúdo bloqueado e editável.
- O texto estático (qualquer conteúdo enviado sem variáveis) é bloqueado e não pode ser editado.
- O número de cartões do carrossel é fixo.
- O tipo de mídia e a configuração de botões não podem ser alterados.
- Qualquer campo com uma variável pode ser modificado com Liquid diferente.
- Se você enviou o modelo com Liquid (por exemplo,
{{first_name}}), a Braze preserva e exibe automaticamente esse Liquid. - Você pode alterar o Liquid para variáveis diferentes (por exemplo, trocar de
{{first_name}}para{{last_name}}). - Imagens com variáveis podem ser tornadas dinâmicas usando URLs com Liquid.
- Você pode fazer upload de novas imagens da Biblioteca de mídia da Braze em vez de usar a mídia enviada.
Exemplo
Por exemplo, digamos que seu modelo inclua uma variável de porcentagem de desconto: {{discount_percentage}}. Na Campaign, você pode manter isso ou alterar para {{custom_attributes.vip_discount}}. A Meta exige apenas que o espaço da variável seja preenchido — o Liquid específico usado é flexível.
Etapa 4: Lançar sua Campaign ou Canvas
Após a composição, prossiga com o fluxo de lançamento da sua Campaign ou Canvas, incluindo testes. O modelo de carrossel funciona como qualquer outro modelo de mensagem do WhatsApp.
Práticas recomendadas
Diretrizes de conteúdo
- Posicionamento do conteúdo do corpo: as variáveis não podem ser colocadas no final do conteúdo do corpo. Adicione pelo menos uma palavra ou sinal de pontuação após cada variável.
- Estrutura consistente dos cartões: todos os cartões devem ter o mesmo formato, tipo de mídia e configuração de botões. Planeje seu conteúdo de acordo.
- Quantidade ideal de cartões: embora você possa criar até 10 cartões, considere a experiência do usuário. Muitos cartões podem ser cansativos; de 3 a 5 cartões funcionam bem para a maioria dos casos de uso.
- Valores padrão: ao usar variáveis Liquid, sempre forneça valores padrão para uma pré-visualização precisa. Isso ajuda a confirmar que a mensagem é exibida corretamente caso determinados dados do perfil do usuário estejam ausentes.
Contas do WhatsApp Business e grupos de inscrições
- Entenda o compartilhamento de modelos: os modelos são compartilhados entre todos os grupos de inscrições dentro da mesma conta do WhatsApp Business (WABA), mas não entre WABAs diferentes. Planeje-se caso gerencie várias WABAs.
- Organize por WABA: se você tiver várias WABAs, considere organizar seus modelos por conta comercial para evitar confusão ao selecionar modelos em Campaigns.
Testes e aprovação
- Pré-visualize antes do envio: sempre pré-visualize seus modelos para identificar erros antes de enviar para aprovação da Meta.
- Planeje o tempo de aprovação: embora a aprovação geralmente leve apenas alguns minutos, considere possíveis atrasos ao planejar lançamentos de Campaigns.
- Teste com cuidado: após a aprovação, teste seu carrossel com dados reais de usuários para confirmar que todas as variáveis são preenchidas corretamente e que a experiência do usuário é fluida.
Solução de problemas
| Problema | Solução |
|---|---|
| O modelo não aparece na Campaign | Verifique se o grupo de inscrições selecionado pertence à mesma WABA do modelo. Além disso, confirme se o status do modelo é Aprovado e não está em status de Rascunho ou Pendente. |
| Não é possível colocar variável no final do corpo | Mova a variável para antes no texto e adicione pelo menos um caractere ou sinal de pontuação após ela. Esse é um requisito da Meta para modelos do WhatsApp. |
| As variáveis não são preenchidas no teste | Verifique se a sintaxe Liquid está correta e se os atributos existem nos perfis dos seus usuários. Confira se há erros de digitação nos nomes das variáveis e verifique se os valores padrão estão definidos quando apropriado. |
| O nome do modelo contém espaços | Os nomes de modelo não podem conter espaços. Use underscores (template_name) ou remova os espaços completamente (templatename). |
| Não é possível alterar o número de cartões | O número de cartões é fixado quando você cria o modelo e não pode ser alterado após o envio. Se precisar de um número diferente de cartões, será necessário criar um novo modelo. |