> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Carrossel

> Envia um conjunto de cartões deslizáveis com imagem ou vídeo, texto e botões no WhatsApp

O nodo **Carrossel** envia um conjunto de cartões que o usuário pode deslizar horizontalmente. Cada cartão combina uma imagem ou vídeo, texto e até dois botões. É ideal para exibir catálogos de produtos, opções de serviço ou qualquer lista visual em que a ordem importa.

<Note>
  O Carrossel está disponível apenas em canais de **WhatsApp Cloud**. Outros provedores de WhatsApp e outros canais não o suportam.
</Note>

## Configuração geral

* **Título do carrossel**: Texto principal que acompanha o carrossel (obrigatório, máximo de 1.024 caracteres). Você pode escrever texto livre, adicionar variáveis como `{{$user.names}}` ou `{{$memory.categoria}}`, ou combinar ambos.
* **Tipo de cabeçalho para os cartões**: **Imagem** ou **Vídeo**. Aplica-se a todos os cartões do carrossel; não pode ser misturado.

<Warning>
  Alterar o **Tipo de cabeçalho para os cartões** (Imagem ↔ Vídeo) apaga os arquivos multimídia já carregados em todos os cartões. Confirme o tipo antes de subir o conteúdo.
</Warning>

## Cartões

Cada carrossel aceita entre **2 e 10 cartões**.

Cada cartão tem:

* **Mídia**: Imagem ou vídeo exibido no cabeçalho. Você pode fazer upload do arquivo ou colar uma URL. O tipo deve corresponder ao **Tipo de cabeçalho para os cartões** escolhido.
* **Texto do cartão**: Descrição curta exibida abaixo da mídia.
* **Botões**: Ações que o usuário pode tocar.

### Visualizações do painel

Você pode alternar entre duas visualizações usando o ícone à direita do cabeçalho **Cartões**:

| Visualização  | Quando usá-la                                             |
| :------------ | :-------------------------------------------------------- |
| **Expandida** | Editar o conteúdo de um ou vários cartões ao mesmo tempo. |
| **Compacta**  | Reordenar cartões ou excluí-los rapidamente.              |

Arraste o ícone à esquerda de cada cartão para mudar a ordem. A contagem atual é exibida no canto inferior direito (por exemplo, `4/10`).

## Botões

Cada cartão aceita até **2 botões** dos seguintes tipos:

| Tipo                    | Comportamento                                                          |
| :---------------------- | :--------------------------------------------------------------------- |
| **Resposta** (postback) | Envia um payload para o fluxo e continua pela rota conectada ao botão. |
| **Web URL**             | Abre uma URL externa no navegador.                                     |

Você pode reordenar os botões dentro de um cartão arrastando-os.

<Note>
  Todos os cartões do carrossel devem ter **o mesmo número de botões** e **o mesmo tipo de botão**. O primeiro cartão define a estrutura e os demais a herdam.

  Além disso, os botões do tipo **Web URL** aceitam **no máximo 1 por cartão**. Os botões do tipo **Resposta** aceitam até dois.
</Note>

## Casos de uso

<AccordionGroup>
  <Accordion title="Catálogo visual de produtos">
    Um workflow que consulta o estoque de uma loja e exibe os produtos como cartões com foto, nome, preço e um botão **Comprar** que abre a URL do produto. Serve para respostas de um AI Agent ou para campanhas com conteúdo dinâmico.
  </Accordion>

  <Accordion title="Menu de serviços com roteamento">
    Um workflow de atendimento em que o carrossel mostra cada serviço (Consulta médica, Faturamento, Reclamações) com uma imagem ilustrativa e um botão **Escolher** do tipo Resposta. O payload selecionado é salvo na memória e um nodo Condicional roteia a conversa para a equipe correta.
  </Accordion>

  <Accordion title="Filiais e horários">
    Um workflow de pós-venda que mostra as filiais próximas com foto da fachada, endereço e um botão **Como chegar** que abre o Google Maps. Os cartões são gerados a partir de uma consulta a uma base de dados ou a uma API.
  </Accordion>

  <Accordion title="Comparação de planos">
    Um carrossel com um cartão por plano de assinatura, vídeo demonstrativo, resumo do plano e um botão **Contratar** que dispara a próxima parte do fluxo. O plano escolhido é salvo na memória para personalizar a cobrança e a confirmação.
  </Accordion>

  <Accordion title="Cartões de crédito de um banco">
    Um workflow de um banco que apresenta seu portfólio de cartões de crédito: cada cartão do carrossel usa a imagem do plástico, um resumo dos benefícios e dois botões do tipo Resposta — **Ver benefícios**, que mostra o detalhe dentro do chat, e **Solicitar**, que continua o fluxo de solicitação. O cartão escolhido é salvo na memória para preencher previamente os dados do cliente.
  </Accordion>
</AccordionGroup>

## Nodos relacionados

<CardGroup cols={2}>
  <Card title="Botões" icon="hand-pointer" href="/pt/guias/nodos/botoes">
    Até 3 botões interativos sem cartões.
  </Card>

  <Card title="Lista" icon="list" href="/pt/guias/nodos/lista">
    Menu suspenso com até 10 opções.
  </Card>

  <Card title="Call to Action" icon="arrow-up-right-from-square" href="/pt/guias/nodos/call-to-action">
    Botão único que abre uma URL externa.
  </Card>

  <Card title="Template HSM" icon="envelope" href="/pt/guias/nodos/hsm">
    Templates pré-aprovados do WhatsApp com suporte a carrossel.
  </Card>
</CardGroup>