Skip to main content
POST
Disponível apenas no WhatsApp

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

Não inclua o campo type no nível do cartão quando usar botões quick_reply. Ele deve ser definido apenas quando a ação é cta_url. Incluí-lo em cartões com quick_reply faz a Meta rejeitar a mensagem com erro 400/500.

Campos do botão quick_reply

Restrições

  • Cartões: mínimo 1, máximo 10 por carrossel.
  • Header: apenas image ou video sã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