Pular para o conteúdo

Enviar lista

Envia uma mensagem com lista interativa (menu de opções em seções). Resposta assíncrona (202).

POSThttps://api.zapdev.com.br/v1/messages/list
Campo Tipo Descrição
to (obrig.) string Número em E.164 ou JID de grupo (...@g.us)
title (obrig.) string Título da mensagem
description (obrig.) string Texto principal
buttonText (obrig.) string Rótulo do botão que abre a lista
footer (opc.) string Rodapé
sections (obrig.) array 1–10 seções, cada uma com title e rows

Cada item de rows tem id, title e description opcional.

Requisição

cURL
curl -X POST https://api.zapdev.com.br/v1/messages/list \
-H "Authorization: Bearer zd_live_..." \
-H "Content-Type: application/json" \
-d '{
"to": "5511999990000",
"title": "Cardápio",
"description": "Escolha um item",
"buttonText": "Ver opções",
"sections": [
{
"title": "Lanches",
"rows": [
{ "id": "x-burger", "title": "X-Burger", "description": "R$ 22,00" },
{ "id": "x-salada", "title": "X-Salada", "description": "R$ 25,00" }
]
}
]
}'
202 Accepted
{
"data": { "id": "msg_Lst01", "status": "queued" }
}

A opção escolhida chega pelo webhook message.received com o id da linha selecionada.