> ## Documentation Index
> Fetch the complete documentation index at: https://docs-zap.loce.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar lista

<Badge size="lg" shape="rounded" color="green" stroke color="green">POST</Badge> /message/list

<CodeGroup>
  ```javascript Node.js theme={null}
  // Lista interativa (máx. 5 opções no total) (Só disponível em planos pagos)
  await zap.sendMessageList('my-session-id', {
    to: '5564999999999',
    text: 'Escolha uma opção',
    buttonText: 'Abrir menu',
    title: 'Menu principal',
    footer: 'Selecione uma das opções',
    sections: [
      {
        title: 'Opções disponíveis',
        rows: [
          { title: 'Ver pedidos', rowId: 'pedidos' },
          { title: 'Ver cobranças', rowId: 'cobrancas' },
        ],
      },
    ],
  });
  ```

  ```python python.py theme={null}
  zap.send_message_list(
              SESSION_ID,
              PHONE,
              "Escolha uma opcao",
              "Abrir menu",
              sections=[
                  {
                      "title": "Menu principal",
                      "rows": [
                          {"title": "Ver pedidos", "rowId": "pedidos"},
                          {"title": "Ver cobrancas", "rowId": "cobrancas"},
                      ],
                  }
              ],
              footer="Selecione uma das opcoes",
          )
  ```

  ```curl curl theme={null}
  API_URL="http://localhost:8080/v1"
  API_KEY="SUA_API_KEY"
  SESSION_ID="sessao-123"
  PHONE="5599999999999"

  curl -X POST "$API_URL/message/list" \
    -H "Authorization: Bearer $API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "'"$SESSION_ID"'",
      "phone": "'"$PHONE"'",
      "text": "Escolha uma opção:",
      "buttonText": "Ver opções",
      "title": "Título opcional",
      "footer": "Rodapé opcional",
      "sections": [
        {
          "title": "Seção 1",
          "rows": [
            { "title": "Item A", "rowId": "item-a", "description": "Descrição opcional" },
            { "title": "Item B", "rowId": "item-b" }
          ]
        }
      ]
    }'
  ```
</CodeGroup>

* Sempre envie `Authorization: Bearer <API_KEY>`.
* `phone` aceita DDI/DDD/número ou `groupId@g.us`.
* Listas permitem no máximo 5 opções somando todas as seções.