Listas Interativas (List Button)
As listas interativas permitem mostrar um menu organizado com até 10 opções selecionáveis, ideal para catálogos de produtos, menus de serviços ou navegação estruturada.
Formato do Comando
#List|Título|Descrição|Texto do botão|Opção*Descrição*ID/...
Parâmetros
| Parâmetro | Descrição | Exemplo |
|---|---|---|
| Título | Título principal da lista | "Cardápio do dia" |
| Descrição | Texto descritivo | "Escolha uma opção" |
| Texto do botão | Label do botão que abre a lista | "Ver Cardápio" |
| Opção | Nome da opção | "Pizza" |
| Descrição | Detalhe de cada opção | "Pizza de queijo" |
| ID | Identificador único | "id1" |
Separadores
- Use
*para separar: OpçãoDescriçãoID - Use
/para separar diferentes opções
Exemplo Prático
#List|Cardápio do dia|Escolha uma opção|Ver Cardápio|Pizza*Pizza de queijo*id1/Suco*Suco de laranja*id2/Sobremesa*Doce de leite*id3
Casos de Uso
Restaurante - Cardápio Completo
#List|Cardápio Restaurante|Selecione seu prato favorito|Ver Opções|Entrada*Salada Caesar*ent1/Prato Principal*Filé com Fritas*pp1/Bebida*Suco Natural*beb1/Sobremesa*Tiramisu*sob1
E-commerce - Categorias
#List|Categorias Disponíveis|Explore nossa loja|Ver Categorias|Eletrônicos*Celulares, tablets e mais*cat1/Moda*Roupas e acessórios*cat2/Casa*Decoração e móveis*cat3/Esportes*Equipamentos fitness*cat4/Livros*Best sellers do mês*cat5
Hotel - Serviços
#List|Serviços do Hotel|O que você precisa?|Ver Serviços|Café da Manhã*Buffet livre 7-11h*srv1/Room Service*Disponível 24h*srv2/Spa*Massagens e tratamentos*srv3/Academia*Aberta 6-23h*srv4/Piscina*Horário 8-20h*srv5
Escola Online - Cursos
#List|Cursos Disponíveis|Comece seu aprendizado hoje|Ver Cursos|Marketing Digital*12 semanas • Online • R$497*curso1/Excel Avançado*8 semanas • Online • R$297*curso2/Inglês Online*24 semanas • Online • R$697*curso3/Python Básico*10 semanas • Online • R$397*curso4
Limitações
Importante
- Máximo 10 opções por lista
- Funciona apenas em chats privados (não em grupos)
- Cada opção pode ter:
- Título (máx. ~24 caracteres)
- Descrição (máx. ~72 caracteres)
- ID único para identificação
Melhores Práticas
Títulos Claros e Concisos
✅ Bom: "Pizza Margherita"
❌ Ruim: "A melhor pizza margherita do mundo com ingredientes frescos"
Descrições Informativas
✅ Bom: "Mozzarella, tomate, manjericão - R$25"
❌ Ruim: "Pizza"
IDs Organizados
✅ Bom: cat_electronics, prod_123, srv_spa
❌ Ruim: id1, a, xyz
Capturando a Resposta
Quando o usuário seleciona uma opção, você recebe o ID correspondente. Use para:
Automatizações
if (resposta.includes("cat_electronics")) {
// Mostrar produtos eletrônicos
}
Analytics
// Registrar quais opções são mais populares
tracker.log("opcao_selecionada", { id: "cat_electronics" });
Lista vs Botões de Resposta
| Característica | Lista | Botões Resposta |
|---|---|---|
| Opções | Até 10 | Até 3 |
| Espaço visual | Compacto | Maior |
| Descrições | Incluídas | Não disponível |
| Melhor para | Muitas opções | Poucas opções |
| Visualização | Menu dropdown | Botões diretos |
Gerador de Comandos
Crie suas listas interativas facilmente: