O que é
As listas do Bot Studio Pro são estruturas de exibição de dados organizados no fluxo do bot. Podem ser dinâmicas (alimentadas por API ou integração com lojas físicas) ou estáticas (valores fixos). O campo "Formatação" define como as informações serão apresentadas ao cliente.
Para que serve / Benefícios
Exibe informações estruturadas: endereços de lojas, status de pedidos, listagens de produtos.
Permite que o bot navegue por dados dinâmicos via API.
Cria menus de seleção que preenchem variáveis automaticamente.
Tipos de lista disponíveis
Lista via API: exibe dados dinâmicos retornados por uma API (ex: pedidos via integração VTEX).
Lista de lojas físicas: exibe endereços cadastrados na aba de Endereços da loja Omnichat.
Lista estática: exibe opções fixas cadastradas manualmente (ex: lista de cidades).
Passo a passo — Criar uma lista no bot
Acesse o bot pela plataforma web.
No Bot Studio Pro, selecione a opção Listas.
Clique em Criar Lista.
Escolha o tipo de lista desejado.
Preencha o campo Formatação com as variáveis e texto que serão exibidos ao cliente.
Salve e publique o bot para que as alterações entrem em produção.
Variáveis do campo Formatação
Lista de lojas físicas:
@Local.nome— Nome da loja@Local.logradouro— Nome da rua@Local.numero— Número do endereço@Local.cidade— Cidade@Local.UF— Estado
Lista via API — múltiplos resultados (lista de pedidos): use prefixo @Local antes dos campos. Ex: @Local.numero_pedido
Lista via API — dado único (endpoint específico): use prefixo @API. Ex: @API.status
Lista estática — campos obrigatórios:
Id: valor exato como está cadastrado no sistema.
Nome: como a opção aparece para o cliente.
Sinônimos: variações aceitas na digitação (abreviações, erros comuns).
⚠️ Atenção
Todas as alterações só entram em vigor após a publicação em produção.
A variável
@Localpara lojas físicas busca dados cadastrados em Configurações → Endereços.É possível inserir emojis no campo Formatação — basta copiar de uma biblioteca e colar.