Gatilho: Mensagem recebida

O gatilho Mensagem recebida (message.received) é o mais usado nas Automações: inicia um workflow toda vez que um contato envia uma mensagem em qualquer canal conectado (WhatsApp, Telegram, Webchat, E-mail, SMS, Instagram, Messenger, TikTok). É a base dos fluxos de boas-vindas, respostas automáticas por palavra-chave e encaminhamento ao Agente de IA.

Quando dispara

Dispara assim que a mensagem entra na caixa de entrada, em paralelo (ou antes) da atribuição automática e do roteamento por IA.

Requisitos

• Pelo menos um canal conectado no workspace.

Configuração do gatilho

• Tipo de canal / Canal específico: limite o fluxo a um canal específico (por exemplo, só Webchat).
• Contém palavra-chave: dispara só se o texto incluir uma palavra (ex.: "preço", "cancelar").
• Tipo de mensagem: filtre por texto, imagem, áudio/voz, vídeo, arquivo ou localização.
• Somente na primeira mensagem: ative para restringir o workflow à primeira vez que o contato escreve naquela conversa — ideal para boas-vindas.

Variáveis disponíveis

• $message.id, $message.text, $message.type, $message.media_url, $message.timestamp
• Variáveis padrão $conversation.* e $contact.*

Exemplo

Um workflow "Boas-vindas" disparado por message.received com Somente na primeira mensagem ativado envia uma saudação usando o nome do contato ($contact.first_name) e um menu de opções (Vendas / Suporte / Financeiro).

Dicas

• Combine Contém palavra-chave com um nó de condição para montar mini-FAQs sem precisar do Agente de IA.
• Se você já usa o Roteador de Recepção com IA, mantenha este gatilho manual só para casos específicos que a IA não trata, ou para canais onde ai_routing esteja em never.

Solução de problemas

Se um workflow disparar duas vezes para a mesma mensagem, verifique se há mais de um workflow ativo no mesmo gatilho sem filtros que os diferenciem entre si.