Referência de fluxos de trabalho
Esta página lista tudo o que você pode usar em um fluxo de trabalho e explica exatamente como cada item se comporta. Para aprender a montar um passo a passo, comece por Fluxos de trabalho e automação.
Como um fluxo de trabalho é executado
Seção intitulada “Como um fluxo de trabalho é executado”Um fluxo de trabalho é um conjunto de etapas. Cada etapa é uma regra: gatilho → condições → ações.
- Algo acontece: um cliente envia uma mensagem, um webhook é chamado, um acompanhamento vence, e assim por diante.
- O Wabot encontra as etapas cujo gatilho corresponde. Para mensagens, o canal e o tipo de mensagem também precisam corresponder. Só são verificadas as etapas ativadas que estão em fluxos de trabalho ativados.
- Cada etapa correspondente verifica suas condições. Sem condições, ela sempre é executada.
- Toda etapa cujas condições são atendidas executa suas ações, de cima para baixo. Não vale “a primeira que corresponder”: se duas etapas corresponderem à mesma mensagem, as duas são executadas, sem ordem garantida. O painel Configuração avisa quando duas etapas começam com a mesma mensagem.
- Se nenhuma etapa foi executada para a mensagem de um cliente, o seu bot de IA responde (quando a IA está ativada para o canal e o contato). Se alguma etapa foi executada, mesmo uma que só adiciona uma etiqueta, o bot de IA não responde essa mensagem.
Como as ações são executadas
Seção intitulada “Como as ações são executadas”- As ações são executadas na ordem da lista. Se uma falhar, as seguintes continuam sendo executadas.
- Aguardar antes de enviar é em segundos e é contado a partir do momento em que o gatilho aconteceu, não a partir da ação anterior. Para enviar três mensagens com um dia de intervalo, use 0, 86400 e 172800.
- As mensagens em espera ficam guardadas com segurança e são enviadas mesmo se o servidor reiniciar. Elas não são canceladas se o cliente responder ou se você desativar a etapa, então mantenha as sequências longas curtas.
- Só Enviar um modelo e Enviar uma mensagem podem aguardar. Todas as outras ações são executadas na hora.
- Mensagens de formato livre (Enviar uma mensagem) só chegam dentro de 24 horas após a última mensagem do cliente. Fora dessa janela, use Enviar um modelo.
Próximas etapas
Seção intitulada “Próximas etapas”Uma etapa ligada por uma linha de próxima etapa (a condição Fluxo de trabalho anterior no editor de formulário) só é executada se a etapa anterior já tiver sido executada com sucesso para o mesmo contato.
- Ela continua precisando do seu próprio gatilho, por exemplo a próxima mensagem do cliente ou um toque em botão. Ela não começa sozinha depois da etapa anterior.
- Não há limite de tempo: a etapa anterior pode ter sido executada há uma hora ou há um mês.
- Depois de desbloqueada, a etapa é executada toda vez que o gatilho e as condições dela corresponderem.
- Se várias etapas levarem a ela, todas precisam ter sido executadas.
- Se a etapa anterior e a seguinte corresponderem à mesma mensagem, as duas podem ser executadas com ela. Dê à etapa seguinte um gatilho diferente, como um toque em botão.
Execuções e resultados
Seção intitulada “Execuções e resultados”Execuções mostra, para cada etapa, para quem ela foi executada e o resultado de cada ação. Uma mensagem conta como bem-sucedida assim que é entregue ao WhatsApp. Se o WhatsApp a rejeitar depois (por exemplo, fora da janela de 24 horas), a falha aparece na conversa, não em Execuções.
As etapas que começam pelo relógio (Sem resposta há algum tempo, Acompanhamento vencendo), por Etapa do pipeline alterada ou por uma integração enviam do seu número de WhatsApp padrão. Sem resposta há algum tempo usa o número em que a conversa aconteceu, se ele ainda estiver conectado.
Gatilhos
Seção intitulada “Gatilhos”| Gatilho | É executado quando… | Configurações | Fornece estas variáveis |
|---|---|---|---|
| O cliente envia uma mensagem | Um cliente envia uma mensagem para você no WhatsApp, Instagram ou Messenger | Canal, tipo de mensagem, texto a corresponder (opcional) | senderName, senderID e outras conforme o tipo de mensagem (veja Variáveis) |
| Mensagem entregue ou lida | Qualquer mensagem que você enviou (por um fluxo de trabalho, uma campanha, a caixa de entrada ou o bot de IA) é enviada, entregue ou lida | Nenhuma: use as condições Status e Modelo | Nenhuma |
| Iniciado manualmente | Você o inicia para contatos ou grupos escolhidos, em Contatos, em um formulário de leads da Meta ou com Iniciar outro fluxo de trabalho | Nenhuma | Nenhuma (veja Iniciado manualmente) |
| Etapa do pipeline alterada | Um cartão é adicionado a um pipeline ou passa para outra etapa | Pipeline, tipo de etapa, da etapa, para a etapa | deal_title, stage_name e outras |
| Sem resposta há algum tempo | Uma conversa fica em silêncio pelo tempo que você definir | De quem esperar a resposta, quanto tempo | waiting_hours, waiting_since |
| Acompanhamento vencendo | Uma tarefa de acompanhamento chega à hora de vencimento ou continua aberta algum tempo depois | Quando, quanto tempo de atraso | followup_text, followup_due_at, followup_assignee, followup_overdue_hours |
| Webhook chamado | Outro sistema envia um POST com um corpo JSON para a URL da etapa |
A URL (aparece depois do primeiro salvamento) | Os campos do corpo JSON, mapeados em Variáveis |
| Resposta da ação de webhook | Uma ação Enviar para um webhook ou Executar código em outra etapa recebe uma resposta | Adicionar resposta de exemplo para transformar os campos da resposta em variáveis | response e cada campo da resposta |
| Eventos de integrações (por ex., pedido criado no Shopify, carrinho abandonado) | Uma integração conectada informa o evento | Nenhuma | Os campos do evento |
O cliente envia uma mensagem
Seção intitulada “O cliente envia uma mensagem”Complete a frase Quando um cliente envia pelo canal uma mensagem do tipo tipo de mensagem que correspondência texto.
Canais: WhatsApp, Instagram e Messenger. No Instagram, escolha também como ele está conectado: Login do Instagram ou Página do Facebook (a mesma opção que você usou ao vinculá-lo).
Tipos de mensagem
| Canal | Tipos de mensagem |
|---|---|
| Texto, Mensagem de anúncio Click-to-WhatsApp, Botões interativos de resposta rápida, Mensagem de lista interativa, Imagem, Vídeo, Documento, Áudio, Flow, Pedido, Pagamento | |
| Texto, Resposta rápida, Postback, Comentário, Imagem, Vídeo, Documento, Áudio | |
| Messenger | Texto, Resposta rápida, Postback, Comentário, Opt-in, Cupom, Imagem, Vídeo, Documento, Áudio |
| Tipo de mensagem do WhatsApp | É executado quando o cliente… | Observações |
|---|---|---|
| Texto | Escreve uma mensagem | |
| Mensagem de anúncio Click-to-WhatsApp | Envia a primeira mensagem a partir do seu anúncio Click-to-WhatsApp | Adiciona as variáveis do anúncio. Se nenhuma etapa de anúncio corresponder, as etapas de Texto respondem |
| Botões interativos de resposta rápida | Toca em um botão de resposta, em uma mensagem de um fluxo de trabalho ou em um modelo | Use o título do botão para a correspondência. button_reply_identifier guarda o que foi tocado |
| Mensagem de lista interativa | Escolhe uma linha de uma lista | Use o título da linha para a correspondência |
| Imagem, Vídeo, Documento, Áudio | Envia esse tipo de arquivo | A legenda é o texto da mensagem. No áudio, o texto é a transcrição, se o seu plano incluir |
| Flow | Envia um WhatsApp Flow | Escolha o flow em Selecione um flow. Cada campo do formulário vira uma variável |
| Pedido | Faz um pedido pelo seu catálogo | Use a condição Valor total para verificar o valor do pedido |
| Pagamento | Paga (ou não consegue pagar) um pedido do catálogo | status é success, failed ou pending. Pagamentos de solicitações de pagamento personalizadas não iniciam este gatilho |
Figurinhas, localizações compartilhadas, contatos compartilhados e reações não iniciam fluxos de trabalho.
Texto a corresponder: contém, é exatamente, começa com ou não é. Deixe vazio para executar em todas as mensagens desse tipo. A correspondência diferencia maiúsculas de minúsculas (Preço não corresponde a preço), e os espaços contam. Para respostas de botão e de lista, o texto é o título do botão ou da linha.
Mensagem entregue ou lida
Seção intitulada “Mensagem entregue ou lida”É executado a cada atualização de status de cada mensagem que você envia, incluindo campanhas e as mensagens da própria etapa. Sempre adicione duas condições:
- Status: Enviada, Entregue ou Lida.
- Modelo: o modelo que você está acompanhando.
Sem elas, a etapa é executada para todas as mensagens da conta, e uma etapa que envia uma mensagem pode acionar a si mesma de novo.
Etapa do pipeline alterada
Seção intitulada “Etapa do pipeline alterada”| Configuração | Opções |
|---|---|
| Pipeline | O pipeline a observar (obrigatório) |
| Só quando a nova etapa for | Aberto, Ganho, Perdido (nenhum marcado = qualquer um) |
| Da etapa | Qualquer etapa (inclui cartões novos) ou uma etapa |
| Para a etapa | Qualquer etapa ou uma etapa |
Uma mudança de etapa feita por um fluxo de trabalho inicia outros fluxos de pipeline só um nível abaixo, então dois fluxos de trabalho não podem ficar movendo um cartão de um lado para o outro. Precisa que os Pipelines estejam ativados em Configurações → Pipelines.
Sem resposta há algum tempo
Seção intitulada “Sem resposta há algum tempo”| Configuração | Opções |
|---|---|
| Iniciar quando | O cliente não respondeu (depois de qualquer mensagem que você enviar a ele, incluindo campanhas) ou Ninguém respondeu ao cliente (qualquer resposta da sua equipe, do bot de IA ou de um fluxo de trabalho conta) |
| Depois de ficar sem resposta por | De 5 minutos a 30 dias |
Cada nova mensagem reinicia a espera. Ele é executado uma vez por silêncio: depois de executado para um contato, só volta a ser executado quando o outro lado escrever. Como as transmissões também iniciam a espera do lado do cliente, adicione uma condição como Contato de um grupo para limitá-lo.
Acompanhamento vencendo
Seção intitulada “Acompanhamento vencendo”| Configuração | Opções |
|---|---|
| Iniciar | Quando vencer ou Quando ainda estiver aberto após o vencimento |
| Atrasado em | De 5 minutos a 30 dias (para a segunda opção) |
É executado uma vez por acompanhamento, para todos os acompanhamentos da conta (incluindo os criados manualmente e por fluxos de trabalho) que estejam vinculados a um contato. No caso “ainda aberto”, nada acontece se ele foi concluído a tempo.
Webhook chamado
Seção intitulada “Webhook chamado”- Envie um
POSTcom um corpo JSON para a URL. O Wabot responde na hora e executa a etapa em segundo plano. - A etapa só é executada quando a chave dela e a chave do fluxo de trabalho estão ativadas e quando as condições são atendidas. As condições podem usar Variável e Fluxo de trabalho anterior.
- Mapeie os campos do corpo em Variáveis com caminhos que começam com
body., por exemplobody.phonepara{"phone": "919876543210"}. - Diga às ações para quem enviar a mensagem com Variável de número de telefone, por ex.
{{phone}}. O número precisa incluir o código do país. Uma variável chamadanamedá nome a um novo contato. - Escolha o número de envio com Selecionar canal ou deixe vazio para usar seu número padrão.
- Para uma imagem, um documento ou um vídeo, coloque o link público do arquivo em Variável de URL: uma variável como
{{invoice}}, um link fixo comohttps://example.com/brochure.pdfou um link com variáveis comohttps://example.com/invoices/{{order_id}}.pdf. - Passar para um bot de IA e Salvar dados não fazem nada aqui: não há mensagem do cliente para responder nem pedido para salvar.
- Mensagens de formato livre só chegam dentro da janela de 24 horas; para alcançar um cliente novo, envie um modelo.
Resposta da ação de webhook
Seção intitulada “Resposta da ação de webhook”Começa depois que uma ação Enviar para um webhook ou Executar código recebe uma resposta. Cole uma resposta de exemplo com Adicionar resposta de exemplo: cada campo vira uma variável, por ex. {{response}} para a resposta inteira ou {{order_id}} para response.order_id. Uma resposta com código de erro (4xx ou 5xx) também conta. Um tempo esgotado, não.
Condições
Seção intitulada “Condições”As condições são verificações extras em Avançado → Condições. A etapa só é executada se elas forem atendidas.
O que você pode verificar
Seção intitulada “O que você pode verificar”| Condição | Verifica | Comparações | Disponível em |
|---|---|---|---|
| Conteúdo da mensagem | O texto da mensagem, o título do botão ou da linha, ou a legenda | é, não é, contém, não contém, começa com | O cliente envia uma mensagem, Mensagem entregue ou lida |
| Mensagem etiquetada | As etiquetas de conversa da mensagem | é qualquer um de, não é nenhum de | O cliente envia uma mensagem |
| Contato de um grupo | Os grupos do contato | é qualquer um de, não é nenhum de | O cliente envia uma mensagem, Iniciado manualmente, Etapa do pipeline alterada, Sem resposta há algum tempo, Acompanhamento vencendo |
| Canal | O número, a conta do Instagram ou a Página pela qual a mensagem chegou | é um de, não é nenhum de | O cliente envia uma mensagem, Mensagem entregue ou lida |
| Variável | Qualquer uma das variáveis da etapa | é, não é, contém, não contém, começa com, é maior que, é menor que | Todos os gatilhos, exceto Iniciado manualmente e Mensagem entregue ou lida |
| Valor total | O total do pedido (preço × quantidade de cada item) | é, não é, é maior que, é menor que | O cliente envia uma mensagem → Pedido |
| Status | O status da mensagem: Enviada, Entregue, Lida | é qualquer um de, não é nenhum de | Mensagem entregue ou lida |
| Modelo | Qual modelo era a mensagem | é qualquer um de, não é nenhum de | Mensagem entregue ou lida |
| Prompt atendido | Se a conversa atinge um objetivo que você descreve, verificado por IA | é atendido, não é atendido | O cliente envia uma mensagem |
| Fluxo de trabalho anterior | Se etapas anteriores já foram executadas para este contato (veja Próximas etapas) | é | Todos os gatilhos, exceto Iniciado manualmente |
Como as comparações funcionam
Seção intitulada “Como as comparações funcionam”| Comparação | Verdadeira quando… |
|---|---|
| é / não é | O valor é exatamente o texto que você digitou, ou não é. Diferencia maiúsculas de minúsculas, e os espaços contam |
| contém / não contém | O texto aparece em qualquer parte do valor, ou não aparece. Diferencia maiúsculas de minúsculas. Um valor vazio não contém nada |
| começa com | O valor começa com o texto. Diferencia maiúsculas de minúsculas |
| é qualquer um de / não é nenhum de | Pelo menos um dos itens escolhidos se aplica, ou nenhum se aplica |
| é um de / não é nenhum de | (Canal) a mensagem chegou por um dos canais escolhidos, ou por nenhum deles |
| é maior que / é menor que | Os dois lados são números e a comparação é verdadeira. Símbolos de moeda e separadores de milhar são ignorados (₹1,250.50 = 1250.5). Se um dos lados não for número, é falsa |
| é atendido / não é atendido | A IA avalia que a conversa atinge o objetivo, ou não. Cada verificação usa uma solicitação de IA |
Grupos e junções (e / ou)
Seção intitulada “Grupos e junções (e / ou)”- As regras dentro de um grupo são unidas com e (todas precisam ser verdadeiras) ou ou (basta uma). Os grupos são unidos da mesma forma. Até 6 grupos por etapa.
- As junções são lidas da esquerda para a direita: A e B ou C significa (A e B) ou C. Para combinar de outro jeito, use grupos.
- Uma junção ausente conta como e.
- Um ou ao lado de uma regra de Fluxo de trabalho anterior deixa a etapa ser executada sem a etapa anterior. Mantenha a ligação unida com e.
| Ação | O que faz | Pode aguardar? |
|---|---|---|
| Enviar um modelo | Envia um modelo aprovado do WhatsApp para o cliente ou para outro número | Sim |
| Enviar uma mensagem | Envia uma mensagem de formato livre: texto, mídia, botões, uma lista, um catálogo, um flow ou uma solicitação de pagamento (dentro da janela de 24 horas) | Sim |
| Adicionar a grupos ou etiquetas | Adiciona o contato a grupos e etiquetas | Não |
| Marcar como lead | Marca o contato como lead, para que ele conte nos relatórios de leads | Não |
| Atribuir a um membro da equipe | Passa a conversa para um colega, em rodízio, para o menos ocupado, ou remove a atribuição | Não |
| Criar acompanhamento | Adiciona uma tarefa à página Follow-ups | Não |
| Mover negócio para etapa | Move o cartão do contato para uma etapa e pode criar um | Não |
| Criar negócio | Adiciona um cartão do contato a um pipeline | Não |
| Marcar negócio como ganho ou perdido | Move o cartão para a primeira etapa de ganho ou de perda do pipeline | Não |
| Alterar responsável pelo negócio | Passa o cartão para um colega ou para quem estiver atribuído à conversa | Não |
| Atualizar valor do negócio | Define o valor do cartão como um número ou uma variável | Não |
| Passar para um bot de IA | Deixa um bot de IA responder a conversa | Não |
| Enviar para um webhook | Envia dados para a URL de outro sistema (REST ou GraphQL) | Não |
| Executar código | Executa o seu JavaScript e repassa o resultado | Não |
| Salvar dados | Adiciona os dados da mensagem ao pedido do cliente | Não |
| Atualizar um valor de estado | Guarda um valor por contato ou por fluxo de trabalho para etapas posteriores | Não |
| Repetir uma etapa | Executa de novo as ações de outra etapa para este contato | Não |
| Iniciar outro fluxo de trabalho | Executa um fluxo de trabalho Manual para este contato | Não |
| Ações de integrações (por ex., Shopify) | Acionam a integração conectada | Não |
Enviar um modelo
Seção intitulada “Enviar um modelo”| Configuração | O que faz |
|---|---|
| Enviar para | O cliente (quem iniciou a etapa) ou Outro número (com código do país, só dígitos) |
| Modelo | Qualquer modelo aprovado |
| Aguardar antes de enviar | Segundos, a partir do momento do gatilho |
| Variáveis | Preencha cada variável do modelo. Para Nome, escolha Nome do cliente, Telefone do cliente ou Outro; para E-mail, E-mail do cliente; para variáveis personalizadas, digite o valor ou exatamente uma variável, como {{senderName}} |
| Mídia | A imagem, o vídeo ou o documento do cabeçalho, nos modelos que têm um |
Uma variável personalizada precisa ser exatamente uma {{variable}}. Texto ao redor dela, como em Olá {{senderName}}, é enviado como está escrito. Variáveis de estado e respostas de Flow não podem ser usadas em modelos. Um valor ausente não é verificado antes do envio, então o WhatsApp pode rejeitar a mensagem.
Enviar uma mensagem
Seção intitulada “Enviar uma mensagem”| Tipo de mensagem | O que você define | Limites |
|---|---|---|
| Somente texto | O texto | 4096 caracteres |
| Com mídia | Um arquivo (imagem, vídeo, documento ou áudio) e a legenda | Legenda: 1024 |
| Resposta rápida | Cabeçalho (texto, imagem, vídeo ou documento), texto e botões | Até 3 botões, com 20 caracteres cada |
| Chamada para ação | Cabeçalho, texto e um botão com um link | Botão: 20 caracteres |
| Lista interativa | Cabeçalho, corpo, rodapé, seções com linhas (título e descrição) e o texto do botão | Título da linha: 24, descrição: 72 |
| Catálogo | Um único produto, vários produtos ou o catálogo inteiro, com texto | Precisa de um catálogo vinculado ao número |
| Flow | Cabeçalho, corpo, rodapé, o flow e o texto do botão | Botão: 25 caracteres |
| Pagamento | Pagamento por catálogo para o pedido que acabou de ser feito, ou Pagamento personalizado com seus próprios itens e valores | Razorpay. Pagamentos personalizados são em INR |
Instagram e Messenger têm tipos próprios: Somente texto, Com mídia, Resposta rápida, Modelo genérico, Modelo com botões, Resposta ao comentário (a um comentário) e, no Messenger, também os modelos de cupom, recibo, produto e opt-in.
As variáveis funcionam no texto e na legenda. Se alguma variável usada ali estiver ausente ou vazia (ou for 0), a mensagem não é enviada, e a execução aparece como com falha. Cabeçalhos, rodapés, botões e linhas de lista são enviados como estão escritos.
Enviar para um webhook
Seção intitulada “Enviar para um webhook”| Configuração | O que faz |
|---|---|
| Tipo de API | REST ou GraphQL |
| URL | Para onde enviar. Pode conter {{variables}} |
| Método | POST ou GET (o GET não envia corpo) |
| Cabeçalhos | Pares de chave e valor. {{name}} em um cabeçalho significa um valor de estado |
| Dados de entrada como | Parâmetros de corpo, de consulta ou de caminho (REST) |
| Payload / Consulta e Variáveis | O JSON a enviar. As {{variables}} nele são preenchidas; as desconhecidas são enviadas como estão escritas |
A solicitação expira após 15 segundos. Para usar a resposta, inicie outra etapa com Resposta da ação de webhook.
Ações da equipe
Seção intitulada “Ações da equipe”Atribuir a um membro da equipe
| Configuração | Opções |
|---|---|
| Como escolher | Um colega específico, Rodízio (revezamento), Menos ocupado (menos conversas aguardando resposta), Remover atribuição |
| Colegas | Um, ou dois ou mais para rodízio e menos ocupado |
| Só se a conversa ainda não estiver atribuída | Não mexe nas conversas que já têm alguém |
| Manter as respostas do bot de IA ativas | Desativado: a atribuição desativa o bot de IA nessa conversa |
Criar acompanhamento
| Configuração | Opções |
|---|---|
| Acompanhamento | O que fazer, até 160 caracteres. Pode usar {{name}} (o nome do contato) e as variáveis do gatilho |
| Vence em | De 0 a 365 minutos, horas ou dias |
| Para | O atribuído da conversa (ou o dono da conta), Um colega específico ou Ninguém |
| Vincular ao cartão aberto do contato no pipeline | Mostra o acompanhamento também no cartão |
Marcar como lead não tem configurações.
Ações de pipeline
Seção intitulada “Ações de pipeline”Todas precisam de um Pipeline. Quando a etapa foi iniciada por Etapa do pipeline alterada, elas alteram esse cartão. Caso contrário, alteram o cartão aberto do contato atualizado mais recentemente nesse pipeline, e não fazem nada se não houver um.
| Ação | Configurações |
|---|---|
| Mover negócio para etapa | Mover para a etapa; Criar um nesta etapa se o contato não tiver nenhum item aberto (com produto e quantidade opcionais) |
| Criar negócio | Etapa (padrão: primeira etapa aberta), Título (pode usar variáveis; vazio = nome do contato e rótulo do cartão), Valor, Responsável, produto e quantidade, Pular se o contato já tiver um item aberto (ativado por padrão) |
| Marcar negócio como ganho ou perdido | Ganho ou Perdido |
| Alterar responsável pelo negócio | Um colega específico ou O atribuído da conversa |
| Atualizar valor do negócio | Um número ou uma variável, por ex. {{order_total}}. ₹1,250.50 é lido como 1250.5 |
Passar para um bot de IA
Seção intitulada “Passar para um bot de IA”| Configuração | O que faz |
|---|---|
| Selecionar bot de IA | O bot que assume |
| Tempo de inatividade e Unidade de tempo | Quanto tempo o cliente pode ficar em silêncio antes de o bot devolver a conversa |
| Quantidade de solicitações de resposta | Quantas respostas antes de o bot perguntar se o cliente ficou satisfeito |
| Mensagem de saída | Enviada quando o tempo de inatividade passa, com os botões Sim e Não |
O bot responde a mensagem atual na hora, se a IA estiver ativada para o canal e o contato e a mensagem tiver texto. Até o tempo de inatividade passar ou o cliente tocar em Sim, as mensagens dele que não corresponderem a outra etapa vão para esse bot.
Dados e controle do fluxo
Seção intitulada “Dados e controle do fluxo”| Ação | Configurações e comportamento |
|---|---|
| Executar código | O seu JavaScript. As variáveis da etapa podem ser usadas nele, por ex. {{senderName}} ou um campo do webhook como {{order_id}}. O resultado inicia qualquer etapa Resposta da ação de webhook ligada a ele |
| Salvar dados | Pedidos: adiciona os dados da mensagem recebida (como um endereço vindo de um Flow) ao pedido do cliente |
| Atualizar um valor de estado | Selecione uma variável de estado e Valor (uma das variáveis da etapa). Um valor vazio falha |
| Repetir uma etapa | Executa de novo as ações da etapa escolhida para este contato, sem verificar as condições dela. Não aponte uma etapa para ela mesma |
| Iniciar outro fluxo de trabalho | Executa o fluxo de trabalho Manual que você escolher para este contato, a partir do número que você escolher |
Variáveis
Seção intitulada “Variáveis”Escreva uma variável como {{name}}. A seção Variáveis de uma etapa lista as que você pode usar, com um botão de copiar.
Variáveis integradas
Seção intitulada “Variáveis integradas”| Variável | Valor | Adicionada por |
|---|---|---|
senderName |
O nome do perfil do WhatsApp do cliente | O cliente envia uma mensagem, Resposta da ação de webhook |
senderID |
O número de telefone do cliente | Os mesmos |
button_reply_identifier |
O botão que foi tocado | Botões interativos de resposta rápida |
ad_headline, ad_body, ad_source_url, ad_source_id, ad_source_type, ctwa_clid |
Os detalhes do anúncio em que o cliente clicou | Mensagem de anúncio Click-to-WhatsApp |
Cada campo do Flow, por ex. {{preferred_date}} |
A resposta do cliente | Flow |
status |
success, failed ou pending |
Pagamento |
response e cada campo da resposta |
A resposta do webhook ou do Executar código | Resposta da ação de webhook (depois de Adicionar resposta de exemplo) |
| Cada campo do evento | Os dados do evento | Gatilhos de integrações |
deal_id, deal_title, deal_value, deal_currency, pipeline_name, stage_name, previous_stage_name, owner_name, deal_items |
O cartão que foi movido | Etapa do pipeline alterada |
waiting_hours, waiting_since |
Há quanto tempo e desde quando a conversa está em silêncio | Sem resposta há algum tempo |
followup_text, followup_due_at, followup_assignee, followup_overdue_hours |
O texto, a hora de vencimento, o atribuído e as horas de atraso do acompanhamento | Acompanhamento vencendo |
name |
O nome do contato (ou o número) | Sempre, no texto do acompanhamento e no título e valor do negócio |
Suas próprias variáveis
Seção intitulada “Suas próprias variáveis”Clique em Adicionar variável em Avançado → Variáveis. Os nomes usam letras, números e _ e começam com uma letra.
| Origem | Valor | Exemplo |
|---|---|---|
| Dos dados do gatilho | Um caminho dentro dos dados do gatilho. A primeira parte diz de onde vem (messageMetadata., body., response., timer.), e o resto é o campo |
body.customer.email lê customer.email do corpo de um webhook |
| Valor fixo | O mesmo texto todas as vezes | Um código de desconto |
As variáveis que você adiciona são mantidas quando você muda o gatilho, o canal ou o tipo de mensagem.
Variáveis de estado
Seção intitulada “Variáveis de estado”Os estados guardam um valor por contato (ou por fluxo de trabalho) entre as etapas e ao longo do tempo, por exemplo o idioma escolhido pelo cliente. Crie-os em Estados, no menu do cartão de um fluxo de trabalho: Estado (o nome), Valor (o padrão), Tipo (por ex., estado do contato) e Tipo de dado. Todas as etapas podem usá-los como {{state}}; defina-os com Atualizar um valor de estado. Eles funcionam em mensagens, condições e webhooks, mas não em modelos.
Onde as variáveis funcionam
Seção intitulada “Onde as variáveis funcionam”| Lugar | O que está disponível | Se um valor estiver ausente |
|---|---|---|
| Texto e legenda de Enviar uma mensagem | Tudo: dados do gatilho, respostas de Flow, suas variáveis, estados | A mensagem não é enviada (falha) |
| Variáveis de Enviar um modelo | Dados do gatilho e suas variáveis (não respostas de Flow nem estados) | Enviada vazia, ou como está escrita se não for uma das variáveis da etapa; o WhatsApp pode rejeitá-la |
| URL e payload de Enviar para um webhook | Tudo | Enviada como está escrita, por ex. {{phone}} |
| Condição Variável | Tudo | A condição compara um valor vazio |
| Texto de Criar acompanhamento, título de Criar negócio, Atualizar valor do negócio | name, as variáveis do gatilho (webhook, relógio, pipeline, integração), suas variáveis, estados |
Fica vazio |
| Atualizar um valor de estado | Dados do gatilho, suas variáveis, estados | A ação falha |
| Executar código | Dados do gatilho (incluindo o corpo ou a resposta de um webhook), suas variáveis, estados | undefined |
Iniciado manualmente
Seção intitulada “Iniciado manualmente”Os fluxos de trabalho manuais são executados para os contatos ou grupos que você escolher, em Contatos (Executar fluxo), em um formulário de leads da Meta ou com Iniciar outro fluxo de trabalho. Eles funcionam de forma diferente dos automáticos:
- Só as condições Contato de um grupo são usadas (com o primeiro grupo escolhido).
- Cada ação aguarda seu tempo depois da ação anterior. Deixe a espera do modelo em 0, porque ela é aplicada duas vezes.
- Enviar uma mensagem não pode usar variáveis: uma mensagem com
{{variables}}interrompe a execução. Os modelos podem usar as predefinições Nome e E-mail e valores fixos. - Estas ações funcionam: Enviar um modelo, Enviar uma mensagem, Adicionar a grupos ou etiquetas, ações da equipe e ações de pipeline. Webhooks, Executar código, passagem para IA, estados, Salvar dados, Repetir uma etapa e Iniciar outro fluxo de trabalho não são executados.
- As execuções manuais não aparecem em Execuções e não desbloqueiam próximas etapas.
Limites
Seção intitulada “Limites”| Item | Limite |
|---|---|
| Etapas por fluxo de trabalho | 10 no editor de formulário |
| Grupos de condições por etapa | 6 |
| Botões de resposta rápida | 3 |
| Aguardar antes de enviar | Sem máximo (em segundos) |
| Espera sem resposta / de atraso | De 5 minutos a 30 dias |
| Vencimento do acompanhamento | Até 365 dias |
| Texto do acompanhamento, título do negócio | 160 caracteres |
| Tempo limite do webhook | 15 segundos; respostas de até 64 KB são guardadas |
| Novas tentativas de envio | 5 tentativas, depois a mensagem é descartada |
Ainda não disponível
Seção intitulada “Ainda não disponível”| Você talvez queira… | Por enquanto |
|---|---|
| Um gatilho em uma data ou hora (por ex., um lembrete de consulta) | Crie um acompanhamento para um colega ou defina um lembrete pela caixa de entrada |
| Parar uma sequência quando o cliente responder | Mantenha as sequências curtas e use Sem resposta há algum tempo para o lembrete |
| Uma espera nas ações da equipe ou de pipeline | Use Sem resposta há algum tempo ou Acompanhamento vencendo para agir depois |
| Itens do pedido como variáveis | Verifique o valor com Valor total |
| Um gatilho de pagamento para solicitações de pagamento personalizadas | Só pedidos do catálogo iniciam Pagamento |
| Um gatilho para figurinhas, localizações, contatos ou reações | Não é compatível |
