📋 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: