# Enviar lista interativa

`POST /send/list`

Pasta: **Enviar Mensagem**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Enviar lista interativa

Envia uma mensagem com lista expansível de opções (seções e linhas). Melhor que botões quando há muitas escolhas.

## Endpoint

```http
POST {{baseUrl}}/send/list
```

## Autenticação

Envie o token da instância no header:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| number | string | Sim* | Destinatário |
| chatid | string | Sim* | Alternativa a number |
| text / title / description | string | Sim | Texto do corpo da lista |
| footer / footerText | string | Não | Rodapé |
| buttonText / listButton | string | Não | Texto do botão que abre a lista |
| sections | array | Sim* | Seções com `title` e `rows` |
| sections[].rows[].title | string | Sim | Título da linha |
| sections[].rows[].description | string | Não | Descrição da linha |
| sections[].rows[].rowId / id | string | Não | ID retornado ao selecionar |
| choices | string[] | Sim* | Formato curto: `[Seção]` e `Título|descrição|id` |
| type / menuType / kind | string | Não | Opcional; neste endpoint o envio é sempre lista |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/send/list" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"number": "{{remoteJid}}", "type": "list", "text": "Escolha uma categoria:", "buttonText": "Ver opções", "sections": [{"title": "Atendimento", "rows": [{"title": "Suporte", "description": "Ajuda técnica", "rowId": "support"}, {"title": "Financeiro", "description": "Pagamentos", "rowId": "billing"}]}]}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": {
    "id": "3EB0A1B2C3D4E5F6",
    "timestamp": "2026-07-17T12:34:56Z",
    "sender": "5511888888888@s.whatsapp.net"
  }
}
```

## Erros comuns

- `sections or choices are required`
- Texto do corpo vazio
- Cooldown interativo por contato

## Corpo (exemplo)

```json
{
  "number": "{{remoteJid}}",
  "type": "list",
  "text": "Escolha uma categoria:",
  "buttonText": "Ver opções",
  "sections": [
    {
      "title": "Atendimento",
      "rows": [
        {
          "title": "Suporte",
          "description": "Ajuda técnica",
          "rowId": "support"
        },
        {
          "title": "Financeiro",
          "description": "Pagamentos",
          "rowId": "billing"
        }
      ]
    }
  ]
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/send/list" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "{{remoteJid}}",
  "type": "list",
  "text": "Escolha uma categoria:",
  "buttonText": "Ver opções",
  "sections": [
    {
      "title": "Atendimento",
      "rows": [
        {
          "title": "Suporte",
          "description": "Ajuda técnica",
          "rowId": "support"
        },
        {
          "title": "Financeiro",
          "description": "Pagamentos",
          "rowId": "billing"
        }
      ]
    }
  ]
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=enviar-mensagem/enviar-lista-interativa)