Mensagens

Enviar carrossel

Cards horizontais com título, texto e botão. Útil para catálogo curto.

Quando usar

2 a 6 cards costumam funcionar melhor. Cada card tem headerTitle, bodyText, buttonText e buttonId.

POST/api/message/carousel/{instance}

Enviar carrossel

Cards horizontais.

Auth: TokenInstance

Body

Campo	Tipo		Descrição
`number`	string	obrigatório	destino
`body`	string		texto acima dos cards
`footer`	string		rodapé
`cards`	array	obrigatório	[{ headerTitle, bodyText, buttonText, buttonId }]

cURL

curl -X POST https://api.wagzap.com.br/api/message/carousel/vendas \
  -H "token: $TOKEN_INSTANCE" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "5511999999999",
  "body": "Novidades",
  "cards": [
    {
      "headerTitle": "Plano Start",
      "bodyText": "Até 2 instâncias",
      "buttonText": "Ver",
      "buttonId": "start"
    },
    {
      "headerTitle": "Plano Pro",
      "bodyText": "Até 10 instâncias",
      "buttonText": "Ver",
      "buttonId": "pro"
    }
  ]
}'

Resposta

{
  "success": true,
  "messageId": "3EB08FCF27E532F1F5F5",
  "data": { "messageId": "3EB08FCF27E532F1F5F5" }
}

Erros

HTTP	Mensagem
400	number and message required / payload inválido
401	missing token / invalid token
403	token does not match instance
404	instance not found
429	rate limit exceeded (padrão 100/min)
502	Falha no WhatsApp / instância desconectada