A aba WhatsApp do seletor Gatilho de entrada reúne três gatilhos, todos ligados a conversas e mensagens no WhatsApp:
Gatilho | Quando dispara |
Mensagem recebida | O cliente envia uma mensagem no WhatsApp. |
Respondeu template (API Oficial) | O cliente responde a um template enviado. |
Mensagem lida (API Oficial) | A mensagem enviada é marcada como lida pelo cliente. |
Se você ainda não sabe como abrir o seletor e escolher um gatilho, comece por Gatilhos: visão geral. Lá também está explicado o que significam o asterisco, o selo Falta preencher e os botões do rodapé da folha.
Sobre o tempo de disparo. Este artigo descreve o que cada gatilho observa e como configurá-lo. Ele não promete quanto tempo leva entre o acontecimento no WhatsApp e a entrada do cliente no fluxo.
Faixa de horário nos três gatilhos. Cada um tem um interruptor de horário (Hora de recebimento, Hora da resposta ou Hora da leitura). Ele vem desligado. Ao ligar, aparecem dois seletores:
A partir de, que vem em 08:00. Opções: 00:00, 06:00, 08:00, 09:00, 12:00 e 18:00.
Até, que vem em 20:00. Opções: 12:00, 18:00, 20:00, 22:00 e Fim do dia.
Fora da faixa, o acontecimento não entra no fluxo. Se o fim for antes do início, a faixa passa da meia-noite (por exemplo, das 22:00 às 06:00).
Mensagem recebida
O que é e quando dispara
Este gatilho coloca o cliente no fluxo quando ele envia uma mensagem para a sua loja pelo WhatsApp. Dá para restringir por conexão, por número que recebeu, por horário, por palavra-chave, por tipo de mensagem e por grupo do cliente.
Na tela, a folha mostra o texto "O cliente envia uma mensagem no WhatsApp."
Como configurar
Os campos aparecem nesta ordem:
Campo (como aparece) | Obrigatório | O que escolher / opções | Para que serve |
Conexão do WhatsApp | Sim (asterisco) | Marque uma das duas opções. Nenhuma vem marcada. API Oficial: números aprovados pela Meta; tem template, botões e retorno de leitura. API Não Oficial (selo Em breve): número conectado por QR Code; mensagem livre, sem retorno de entrega. A API Não Oficial ainda não pode ser marcada. | Define em qual tipo de conexão a mensagem precisa chegar. Se tentar salvar sem marcar, a tela avisa: "Escolha em qual conexão a mensagem é recebida." |
Números que recebem (opcional) | Não | Botão Selecionar números cadastrados: escolha, na lista de números de WhatsApp da sua loja, um ou mais. Vem vazio. | Considera só as mensagens que chegam nos números escolhidos. Sem seleção, vale para qualquer número. |
Hora de recebimento | Não | Interruptor, desligado por padrão. Ao ligar, aparecem A partir de (padrão 08:00) e Até (padrão 20:00), com as opções da seção acima. | Limita o gatilho a uma faixa de horário: fora dela, a mensagem não entra no fluxo. Se o fim for antes do início, a faixa passa da meia-noite. |
Palavras-chave na mensagem (opcional) | Não | Campo de texto: digite a palavra e pressione Enter para adicionar. Cada palavra vira uma etiqueta, com um botão para remover. Vem vazio. | O fluxo dispara quando a mensagem contém qualquer uma das palavras. Sem palavras-chave, qualquer mensagem entra. |
Tipo de mensagem | Não | Lista com busca (Buscar…). Opções: Texto, Imagem, Áudio, Vídeo, Documento, Localização, Contato, Figurinha, Resposta de botão, Mensagem editada, Mensagem com erro, Mensagem interativa, Pedido, Reação, Mensagem apagada e Tipo não suportado. Sem escolha, aparece Qualquer tipo. As escolhas viram etiquetas, e há um botão Limpar seleção. | Limita o gatilho a certos formatos de mensagem. Sem seleção, vale para qualquer formato. |
Grupo do cliente | Não | Qualquer cliente (padrão) ou um ou mais grupos da sua loja. Link Criar novo grupo. | Só deixa entrar clientes dos grupos escolhidos. Nos outros gatilhos esse filtro se chama Se o cliente é de um grupo. |
Sobre a Hora de recebimento. Vale o horário em que a mensagem foi recebida, no fuso do fluxo (se o fluxo não tiver fuso próprio, vale o da loja). O horário de início entra e o de fim não.
Exemplo de uso
Exemplo: você quer atender quem pede "troca" ou "devolução". Marque a conexão API Oficial, adicione as palavras-chave troca e devolução e deixe os demais campos como estão. Quando um cliente mandar uma mensagem com uma dessas palavras, ele entra no fluxo.
Pegadinhas
A conexão é obrigatória. Sem marcar API Oficial, o gatilho não salva, e o fluxo não pode ser ativado.
Sem palavra-chave, qualquer mensagem entra. Se você deixar Palavras-chave na mensagem vazio, toda mensagem recebida (dentro dos outros filtros) coloca o cliente no fluxo.
Várias palavras = qualquer uma. Basta a mensagem conter uma das palavras.
Números que recebem. Se você escolher números, mensagens cujo número não foi identificado não entram.
Só WhatsApp. A tela oferece apenas a Conexão do WhatsApp. A API Não Oficial aparece com o selo Em breve.
Texto da mensagem some depois de 30 dias. O conteúdo da mensagem recebida não fica disponível para sempre nas variáveis do fluxo: por privacidade, ele deixa de existir após 30 dias.
O que este gatilho não faz
Não responde ao cliente: a resposta é uma ação que você liga depois.
Não funciona com outros canais além do WhatsApp.
Nome técnico (para suporte): chat.message.received
Respondeu template (API Oficial)
O que é e quando dispara
Este gatilho coloca o cliente no fluxo quando ele responde a um template do WhatsApp oficial que a sua loja enviou. Só templates de feedback rápido podem disparar um fluxo.
Na tela, a folha mostra o texto "O cliente responde a um template enviado." No seletor, a descrição é "Cliente respondeu a um botão de template do WhatsApp oficial."
Como configurar
Os campos aparecem nesta ordem:
Campo (como aparece) | Obrigatório | O que escolher / opções | Para que serve |
Template | Sim (asterisco) | Botão Selecionar template: escolha, na lista de templates da sua loja, o template que o gatilho vai acompanhar. Vem vazio. | O template cuja resposta dispara o fluxo. A tela avisa: "Só templates de feedback rápido podem disparar um fluxo." Se tentar salvar sem escolher, aparece: "Selecione o template que dispara o fluxo." |
Hora da resposta | Não | Interruptor, desligado por padrão. Ao ligar, aparecem A partir de (padrão 08:00) e Até (padrão 20:00), com as opções da seção de horário acima. | Limita o gatilho a uma faixa de horário: fora dela, a resposta não entra no fluxo. Se o fim for antes do início, a faixa passa da meia-noite. |
Se o cliente é de um grupo | Não | Qualquer cliente (padrão) ou um ou mais grupos da sua loja. Link Criar novo grupo. | Só deixa entrar clientes dos grupos escolhidos. Sem seleção, vale para qualquer cliente. |
Sobre a Hora da resposta. Vale o horário da resposta, no fuso do fluxo (sem fuso próprio, o da loja). O início entra e o fim não.
Exemplo de uso
Exemplo: você enviou um template de feedback rápido com os botões "Gostei" e "Não gostei". Escolha esse template em Template. Quem responder ao template entra no fluxo.
Pegadinhas
O template é obrigatório. Sem escolher um template, o gatilho não salva.
Só templates de feedback rápido podem disparar um fluxo. Respostas a outros tipos de template não servem como gatilho.
O que este gatilho não faz
Não vale para mensagens livres do cliente (para isso use Mensagem recebida).
Não vale para o WhatsApp não oficial: o nome do gatilho indica API Oficial.
Nome técnico (para suporte): chat.template.replied
Mensagem lida (API Oficial)
O que é e quando dispara
Este gatilho coloca o cliente no fluxo quando uma mensagem enviada pelo WhatsApp oficial passa a constar como lida pelo cliente. É o retorno de leitura que a API Oficial oferece.
Na tela, a folha mostra o texto "A mensagem enviada é marcada como lida pelo cliente." No seletor, a descrição é: "Status "read" de uma mensagem do WhatsApp oficial."
Como configurar
Os campos aparecem nesta ordem:
Campo (como aparece) | Obrigatório | O que escolher / opções | Para que serve |
Templates | Sim (asterisco) | Botão Selecionar templates: escolha, na lista de templates da sua loja, um ou mais. Vem vazio. | Os templates cuja leitura faz o cliente entrar. Vale para a leitura de qualquer um dos templates escolhidos. Se tentar salvar sem escolher, a tela avisa: "Selecione ao menos um template ou marque todos." |
Hora da leitura | Não | Interruptor, desligado por padrão. Ao ligar, aparecem A partir de (padrão 08:00) e Até (padrão 20:00), com as opções da seção de horário acima. | Limita o gatilho a uma faixa de horário: fora dela, a leitura não entra no fluxo. Se o fim for antes do início, a faixa passa da meia-noite. |
Se o cliente é de um grupo | Não | Qualquer cliente (padrão) ou um ou mais grupos da sua loja. Link Criar novo grupo. | Só deixa entrar clientes dos grupos escolhidos. Sem seleção, vale para qualquer cliente. |
Sobre a Hora da leitura. Vale o horário da leitura, no fuso do fluxo (sem fuso próprio, o da loja). O início entra e o fim não.
Exemplo de uso
Exemplo: você enviou um template de lançamento. Escolha esse template em Templates para iniciar um fluxo de acompanhamento com quem leu a mensagem.
Pegadinhas
Os templates são obrigatórios. Sem escolher ao menos um template, o gatilho não salva. Para acompanhar leituras de vários templates, escolha todos eles no mesmo campo.
Só API Oficial. Na conexão não oficial não há retorno de entrega.
O que este gatilho não faz
Não vale para o WhatsApp não oficial.
Não envia nada por conta própria: o próximo passo é uma ação.
Nome técnico (para suporte): chat.message.read
Próximos passos
Ações de envio: como mandar a resposta ao cliente.
Condições: como ramificar o fluxo depois do gatilho.
Por que não disparou: como investigar um cliente que não entrou.