Mensagens

Enviar lista

Cada item vira um card do carrossel. O seletor nativo de lista o WhatsApp companion descarta.

Quando usar

Cardápio, FAQ, escolha de departamento. Cada row tem id (volta no webhook), title e description.

Até 10 itens. O destinatário desliza os cards e toca em Escolher.

ListMessage e single_select são aceitos pelo servidor e sumidos no celular. O carrossel é o formato que chega com várias opções.

POST/api/message/list/{instance}

Enviar lista

Menu com seções.

Auth: TokenInstance

Body

Campo	Tipo		Descrição
`number`	string	obrigatório	destino
`contentText`	string	obrigatório	corpo
`headerText`	string		título
`footerText`	string		rodapé
`buttonText`	string		rótulo do menu (ex.: Abrir)
`sections`	array	obrigatório	[{ title, rows: [{ id, title, description }] }]

cURL

curl -X POST https://api.wagzap.com.br/api/message/list/vendas \
  -H "token: $TOKEN_INSTANCE" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "5511999999999",
  "contentText": "Escolha um assunto",
  "buttonText": "Abrir menu",
  "sections": [
    {
      "title": "Atendimento",
      "rows": [
        {
          "id": "sales",
          "title": "Vendas",
          "description": "Orçamentos"
        },
        {
          "id": "support",
          "title": "Suporte",
          "description": "Problemas técnicos"
        }
      ]
    }
  ]
}'

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