Gatilho: Opção de lista selecionada

O gatilho Opção de lista selecionada (message.list_selected) inicia um workflow assim que o contato responde a uma mensagem de lista interativa do WhatsApp escolhendo uma das linhas do menu. É a forma nativa de montar menus de opções ("Ver planos", "Falar com um atendente", "Consultar meu pedido") e ramificar a conversa de acordo com a escolha do cliente.

Quando dispara

Dispara assim que a Meta entrega a resposta list_reply do contato, depois que você (ou outro workflow) enviou uma mensagem de lista usando a ação "Enviar mensagem interativa".

Requisitos

• Um canal de WhatsApp Cloud API conectado no seu workspace.
• Uma mensagem de lista já enviada ao contato (manual, por IA ou por outro workflow) com linhas identificadas por row_id.

Configuração do gatilho

• Canal específico: limita o disparo a um canal de WhatsApp específico.
• ID da linha: deixe em branco para capturar qualquer seleção, ou defina um row_id exato para criar um ramo por opção do menu.

Variáveis disponíveis

• $list.row_id — ID da linha escolhida
• $list.title — Título visível da linha
• $list.description — Descrição da linha
• $message.id — ID da mensagem recebida com a resposta
• Variáveis padrão $conversation.* e $contact.*

Exemplo

Um workflow envia um menu com as linhas "financeiro", "suporte_tecnico" e "vendas". Você cria um workflow disparado por message.list_selected com um nó de condição: se $list.row_id for financeiro, atribui a conversa à equipe Financeiro; se suporte_tecnico, atribui ao Suporte; se vendas, encaminha para o Agente de IA de Vendas.

Dicas

• Cada row_id precisa ser único dentro da mensagem de lista — a Meta exige isso.
• Combine este gatilho com um nó de condição em vez de criar um workflow separado para cada opção do menu.

Solução de problemas

Se o workflow nunca disparar, confirme que a lista foi realmente enviada como mensagem interativa (não como texto simples listando as opções) e que o canal de WhatsApp continua conectado.