Gatilho: Mensagem lida

O gatilho Mensagem lida (message.read) inicia um workflow quando a Meta confirma que o contato abriu (dois tiques azuis) uma mensagem que você enviou por um canal de WhatsApp. Serve para medir a abertura real das suas mensagens e disparar follow-ups que só fazem sentido se o cliente realmente viu o conteúdo.

Quando dispara

Dispara quando chega o evento de status read da Meta para uma mensagem enviada — pode levar segundos ou minutos, dependendo de quando o contato abre o WhatsApp.

Requisitos

• Um canal de WhatsApp Cloud API conectado.
• Uma mensagem enviada anteriormente (o contato precisa ter a confirmação de leitura ativada no WhatsApp dele; se estiver desativada, este evento nunca chega).

Configuração do gatilho

• Tipo de canal e Canal específico: limite o disparo ao WhatsApp ou a um número específico.

Variáveis disponíveis

• $message.id — ID interno da mensagem
• $message.external_id — wamid da Meta
• $message.read_at — Timestamp de quando o contato leu
• Variáveis padrão $conversation.* e $contact.*

Exemplo

Você envia um lembrete de pagamento. Um workflow disparado por message.read adiciona a etiqueta "Lembrete-visto" ao contato, e outro workflow (disparado por tag.added com um atraso de 24h) verifica se ele ainda não pagou e escala para um atendente humano.

Dicas

• Não confunda com "Mensagem entregue" (message.delivered): entregue significa que chegou no telefone, lida significa que ele abriu.
• Se sua campanha precisa saber se o cliente viu a mensagem antes de escalar, este gatilho é mais preciso do que medir apenas o tempo decorrido.

Solução de problemas

Se nunca disparar para certos contatos, provavelmente eles desativaram a confirmação de leitura nas configurações do WhatsApp — nesse caso a Meta nunca entrega o evento read, e não há como forçar isso.