Tipos de Mensagem
Carrossel
Envie uma mensagem interativa de carrossel com múltiplos cartões
POST
Disponível apenas no WhatsApp
Campos do botão
Parâmetros de rota
string
obrigatório
Identificador único do bot que envia a mensagem.
Parâmetros do corpo
string
obrigatório
Tipo de mensagem. Deve ser
"CAROUSEL".string
obrigatório
Destinatário da mensagem. Aceita um número de telefone no formato E.164 sem o sinal
+ (ex.: 593999999999) ou um BSUID (ex.: US.13491208655302741918) para usuários com a proteção de número ativada no WhatsApp. Veja Identificação do destinatário.string
obrigatório
Texto exibido acima do carrossel.
object
obrigatório
Conteúdo do carrossel.
Resposta
boolean
true se a mensagem foi enviada com sucesso.string
Identificador da mensagem enviada.
Estrutura de cada cartão
Cartão com botões de resposta rápida
Campos do botão quick_reply
Restrições
- Cartões: mínimo 1, máximo 10 por carrossel.
- Header: apenas
imageouvideosão suportados. - Providers compatíveis: WhatsApp Cloud API e Gupshup CAPI.
Este é um carrossel interativo enviado dentro de uma sessão ativa do WhatsApp. Não requer template HSM aprovado pela Meta.
Casos de Uso
- Catálogos de produtos com CTA para a loja
- Comparação de planos ou serviços
- Promoções múltiplas com botões de compra
- Seleção rápida entre opções com imagem associada