> For the complete documentation index, see [llms.txt](https://docs-pt.sinch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-pt.sinch.com/whatsapp/introducao-ao-messaging-whatsapp/carrossel-whatsapp-em-breve.md).

# Carrossel WhatsApp (em breve!)

## O que é o Carrossel de WhatsApp?

O Carrossel é um formato de template de WhatsApp que permite apresentar, em uma única mensagem, uma introdução em texto seguida de vários cards deslizáveis personalizáveis. Cada card reúne uma mídia (imagem ou vídeo), um texto e, opcionalmente, botões.

Com ele, uma campanha pode mostrar vários produtos, ofertas ou opções em uma só mensagem. O Carrossel é criado na categoria de template "Marketing - Carrossel" e segue as regras do WhatsApp (Meta). Apesar de ser criado em nossa plataforma como “Marketing – Carrossel”, esta categoria não existe na Meta e será visualizada nos relatórios como Marketing.

### Disponibilidade

Este tipo de envio é suportado somente diretamente via ConvAPI (API da Sinch) ou pela plataforma Messaging (MM2), que usa a ConvAPI.

### Estrutura da mensagem

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Elemento</strong></td><td valign="top"><strong>Descrição</strong></td></tr><tr><td valign="top">Introdução</td><td valign="top">Texto exibido antes dos cards.</td></tr><tr><td valign="top">Cards</td><td valign="top">Cada card contém mídia, corpo e, opcionalmente, botões.</td></tr><tr><td valign="top">Botões</td><td valign="top">Em cada card (mínimo um botão, máximo 2): resposta rápida, número de telefone ou site (podendo ter URL dinâmica).</td></tr></tbody></table>

## Como criar um template de Carrossel

**1 -** Acesse a criação de template de WhatsApp e preencha com nome, idioma e categoria.

**2 -** Escolha a categoria "Marketing - Carrossel". Lembre-se: Ela aparece como categoria no MM2, mas para a Meta o template é de Marketing.

**3 -** Escreva a Introdução (até 1.024 caracteres, contando as variáveis). Por isso, recomendamos não criar textos muito longos, já pensando em contemplar possíveis variáveis.

**4 -** Monte os cards no campo Carrossel. É preciso ter no mínimo 2 e no máximo 10 cards. Para cada card, defina:

* **Mídia:** escolha imagem ou vídeo e envie o arquivo.
* **Corpo:** texto do card, com até 160 caracteres, contando com as variáveis.
* **Botões:** até 2 botões por card. Escolha o tipo, informe o texto do botão e, quando for site, a URL, que pode ser estática ou dinâmica.

**5 -** Complete todos os campos de um card antes de ir para o próximo. Enquanto houver campo obrigatório pendente, o botão para avançar não é habilitado.

**6 -** Envie o exemplo (sample) do template. Ao prosseguir, o MM2 abre a tela "Preencha os campos e veja como irá ficar". A Meta solicita um exemplo do conteúdo que será enviado após a aprovação, e ele deve cobrir tudo o que tem variável ou mídia:

* Se a introdução tiver variável, informe um exemplo do conteúdo esperado.
* Para cada card, informe o exemplo das variáveis (corpo e URL dinâmica) e envie a mídia de exemplo.
* Use as setas ou os pontos indicadores para navegar entre os cards.
* Clique em "Concluir" para finalizar o exemplo e depois em "Criar" para enviar o template.

**7 -** Aguarde a aprovação da Meta. O template é enviado para análise da Meta e só pode ser usado em envios depois de aprovado.

## Como enviar uma mensagem com o template

1. Escolha o template de Carrossel. O idioma do template aparece preenchido e não pode ser editado.
2. Introdução: o texto do template vem como padrão. Se tiver variável, escolha o campo dinâmico correspondente na lista. O MM2 mostra quantos caracteres o texto possui sem contar as variáveis.
3. Carrossel: edite cada card e envie a imagem ou o vídeo correspondente.
4. Corpo de cada card: preencha as variáveis que estiverem faltando.
5. Botões: se um botão de site tiver URL dinâmica, preencha o campo da variável em cada card.
6. Complete todos os campos de um card antes de ir para o próximo, assim como na criação do template.
7. Siga o fluxo normal de campanha do MM2: selecione a campanha, faça o agendamento e envie sua mensagem!

## Regras de uso

### Limites de conteúdo

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Item</strong></td><td valign="top"><strong>Limite</strong></td><td valign="top"><strong>Observação</strong></td></tr><tr><td valign="top">Introdução</td><td valign="top">Até 1.024 caracteres</td><td valign="top">Considera as variáveis</td></tr><tr><td valign="top">Quantidade de cards</td><td valign="top">Mínimo 2 e máximo 10</td><td valign="top">—</td></tr><tr><td valign="top">Imagem</td><td valign="top">Até 5 MB</td><td valign="top">Formatos .jpeg, .jpg e .png</td></tr><tr><td valign="top">Vídeo</td><td valign="top">Até 16 MB</td><td valign="top">Formato .mp4</td></tr><tr><td valign="top">Corpo de cada card</td><td valign="top">Até 160 caracteres</td><td valign="top">Considera as variáveis</td></tr><tr><td valign="top">Botões por card</td><td valign="top">Até 2</td><td valign="top">Resposta rápida, telefone ou site</td></tr><tr><td valign="top">Texto do botão</td><td valign="top">Até 20 caracteres</td><td valign="top">—</td></tr><tr><td valign="top">URL do botão de site</td><td valign="top">Até 2.000 caracteres</td><td valign="top">Pode ser estática ou dinâmica</td></tr></tbody></table>

### Regras da Meta aplicadas ao Carrossel

Diferente do carrossel de RCS, a Meta exige que todos os cards sigam o mesmo padrão. O MM2 aplica estas regras antes de enviar o template para aprovação:

* Mesmo tipo de mídia: se um card tem imagem, todos os cards têm imagem. Não é possível misturar imagem e vídeo.
* Mesma categoria de botão: se um card tem botão, todos os cards precisam ter botões da mesma categoria. Não precisa ser o mesmo conteúdo, mas o tipo de botão precisa ser o mesmo.
* Mesma ordem de botões: a sequência dos botões deve ser idêntica em todos os cards. Por exemplo, um card com botões site e telefone não pode conviver com outro card com telefone e site.

### Preenchimento

* Mídia e corpo são obrigatórios em todos os cards. Os botões são opcionais.
* Não é possível avançar para o próximo card, nem concluir a etapa, com campos pendentes (por exemplo, um card sem o texto do botão ou sem a URL do botão de site). Isso vale para a criação e para o envio.
* O campo de corpo não aceita mais de 160 caracteres.
