Uma automação é uma sequência de nós ligados: um gatilho dá a partida e cada nó seguinte envia, decide, espera ou grava alguma coisa. Comece pela primeira automação, entenda os conceitos, copie uma receita e consulte a referência técnica de cada nó.
Prefere ver na prática? Os tutoriais em vídeo mostram o editor funcionando.
Monte sua primeira automação
Em poucos minutos você tem um fluxo que responde “oi” com uma mensagem. Depois é só repetir o padrão: gatilho, ação, ligação.
1
Crie a automação
Em Automações, clique em Novo Fluxo, dê um nome, escolha os canais (ou deixe Todos os canais) e selecione Criar do zero. Se preferir, comece por um modelo da biblioteca ou use o botão Criar fluxo com IA e descreva o que quer em português.
2
Escolha o gatilho
O gatilho é o nó que dá a partida. Para a primeira automação use Gatilho com o evento Mensagem recebida, a palavra-chave oi e a comparação É igual a. Toda automação precisa de pelo menos um gatilho.
3
Adicione uma mensagem
Abra o menu Adicionar nó e escolha Conteúdo. Dentro dele, adicione um item de texto como "Oi {{primeiro_nome}}! Como posso ajudar?". O texto entre chaves duplas é substituído pelo dado do contato na hora do envio.
4
Ligue os nós
Arraste da bolinha de saída do gatilho até a bolinha de entrada do Conteúdo. Sem essa ligação, o nó fica solto e nunca roda.
5
Valide e simule
Abra Ferramentas do editor e use Validar Estrutura: ele lista erros (impedem o fluxo de funcionar) e avisos. Depois use Simular Fluxo no modo Simulação segura, que percorre o caminho sem enviar nada de verdade.
6
Salve e ative
Clique em Salvar. Na lista de Automações, ligue a chave do cartão para ativar. Fluxo inativo não dispara. Mande "oi" de outro número para o canal e acompanhe o resultado em Estatísticas e Execuções.
Conceitos essenciais
O que você precisa entender para ler e montar qualquer fluxo.
Nós e ligações
Uma automação é um desenho: cada caixa é um nó que faz uma coisa e cada linha diz qual nó roda depois. A execução começa no gatilho e segue as linhas.
Nós comuns têm uma saída só: tudo que estiver ligado a ela roda em seguida.
Nós que decidem têm saídas nomeadas (Verdadeiro e Falso, uma por botão, uma por caso). Só o caminho escolhido roda; os outros ficam parados.
Um nó pode receber várias ligações de entrada. Dois gatilhos diferentes podem levar ao mesmo Kanban, por exemplo, sem precisar duplicar o nó.
Nó que não é alcançável a partir de um gatilho nunca roda. O validador avisa.
Variáveis
Variável é um dado com nome que os nós leem e escrevem. Use entre chaves duplas em qualquer campo de texto.
{{primeiro_nome}}, {{nome}} e {{whatsapp}} vêm do contato. Colunas extras de uma planilha importada ficam disponíveis como {{variaveis.cidade}} (ou só {{cidade}}).
{{$body.campo}} traz o conteúdo enviado ao gatilho Webhook.
{{$node.nome_do_nó}} traz a saída de um nó anterior (Código, Loop, HTTP Request, Banco de Dados e outros). O nome é o título do nó no canvas.
{{$vars.chave}} lê o que você definiu no nó Variáveis. Deixe ali tudo que você pode querer trocar depois (textos-padrão, IDs, limites), em vez de repetir em vários nós.
{{resposta}} (ou o nome que você escolheu) guarda o que o cliente digitou depois de um nó Aguardar resposta.
Há expressões simples de texto, como {{nome.split(" ")[0]}}. Por segurança, expressões que tentam acessar o servidor (process, require, fetch e similares) são bloqueadas.
Esperas e retomadas
Alguns nós pausam o fluxo e continuam depois. A conversa fica guardada no ponto onde parou.
Espera (Delay) pausa por alguns segundos e depois segue.
Aguardar resposta pausa até a próxima mensagem do cliente naquela conversa, guarda o texto numa variável e continua.
Follow-up espera um prazo (de 1 minuto a 30 dias). Se o cliente responder, segue pela saída Respondeu; se o prazo acabar, pela saída Não respondeu.
Botões esperam um clique real. Digitar o texto da opção não continua o nó. O clique continua a automação que enviou os botões.
Janela de 24 horas e templates
A Meta permite mensagem livre só até 24 horas depois da última mensagem do cliente. Passado esse prazo, só vai template aprovado.
Conteúdo e Botões são mensagens livres: use dentro da janela.
Template serve para falar fora da janela (lembretes, avisos, cobranças).
Depois de um Follow-up longo, a janela provavelmente já fechou: use um nó Template na cutucada.
A Olax avisa quando a janela está fechada, mas quem recusa o envio é a Meta.
Canais
Cada automação vale para os canais que você escolher: números de WhatsApp, Instagram, Messenger e Telegram. Deixar em Todos os canais faz o gatilho valer em todos.
Alguns nós são específicos: Template e Botões são do WhatsApp; Receber comentário e Responder comentário são do Instagram e do Facebook.
Para limitar a um número, selecione-o no campo de canais da automação.
Testar antes de ligar
Valide, simule e só então ative.
Validar Estrutura aponta nós soltos, saídas sem ligação, botão sem destino e campos obrigatórios vazios.
Simulação segura percorre o fluxo sem enviar mensagens nem alterar dados.
No simulador, digitar o título de um botão continua sendo texto. Use os botões exibidos para simular a escolha daquela opção.
Teste de envio manda de verdade, mas só depois de uma confirmação sua, para um contato de teste.
O ícone de execução (play) no cartão roda um fluxo com gatilho Manual de forma pontual.
Receitas prontas
Cada receita lista os nós na ordem em que você os adiciona, com o que preencher. Adapte os textos e valores à sua operação.
Responder uma palavra-chave
Quando a pessoa mandar "preço", responder com a tabela e marcar o contato.
1
Gatilho. Evento Mensagem recebida. Palavra-chave: preço. Comparação: É igual a (use Contém se a pessoa pode escrever uma frase inteira).
2
Conteúdo. Texto "Oi {{primeiro_nome}}! Segue a tabela de valores:" e, em seguida, um item de arquivo ou imagem com a tabela.
3
Chat. Ação Adicionar tag, com a tag pediu-preco, para filtrar essas pessoas depois.
A comparação ignora maiúsculas e acentos: "PRECO" e "preço" são iguais.
Avisar quando estiver fora do horário
Responder só fora do expediente e não repetir o aviso toda hora.
1
Gatilho. Mensagem recebida com a opção Executar sempre (sem palavra-chave).
2
Switch de Tempo. Um caso "Horário comercial": dias seg a sex e horário 09:00 a 18:00. Ligue o caminho "Horário comercial" a nada (ou a um aviso de equipe). Ligue o caminho padrão ao próximo nó.
3
Conteúdo. Texto "Estamos fora do horário. Retornamos amanhã a partir das 9h."
4
Silenciar automação. No Switch de Tempo, ative Silenciar automação por 12 horas: o mesmo contato não cai de novo nesse caminho até lá.
O horário usado é o de São Paulo.
Menu com botões
Perguntar o que a pessoa quer e levar cada escolha para um caminho.
1
Gatilho. Palavra-chave menu, É igual a.
2
Botões. Texto "Como posso ajudar?" e até 3 botões: Agendar, Valores, Falar com atendente.
3
Conteúdo (um por botão). Ligue a saída de cada botão a uma mensagem diferente. A saída do botão Agendar vai para o texto de agendamento, e assim por diante.
4
Kanban. Na opção Falar com atendente, crie um card na coluna de atendimento para a equipe ver.
Botão sem ligação não leva a lugar nenhum. O validador avisa antes de salvar.
Pedir um dado e conferir
Pedir o CPF, esperar a resposta e só seguir se vier preenchido.
1
Conteúdo. Texto "Pode me informar seu CPF?"
2
Aguardar resposta. Variável cpf. O fluxo para aqui até a pessoa responder.
3
Condição. Campo cpf, operador vazio. Saída Verdadeiro (está vazio): peça de novo. Saída Falso: continue.
4
Clinicorp ou Banco de Dados. Use {{cpf}} para buscar o paciente ou gravar o dado.
Cutucar quem não respondeu
Enviar um lembrete se o contato ficar um dia sem responder.
1
Template. Envie o template aprovado de lembrete.
2
Follow-up. Esperar 1 dia (1440 minutos).
3
Template. Ligado à saída Não respondeu: segundo aviso. Use template, pois a janela de 24 horas provavelmente fechou.
4
Kanban. Ligado à saída Respondeu: mova o card para a coluna de conversa em andamento.
Receber de outro sistema (Webhook)
Um formulário do site avisa a Olax e a pessoa recebe uma mensagem.
1
Webhook. Método POST. Salve a automação: a Olax gera a URL e o token. Cole no sistema de origem.
2
Variáveis. Opcional: guarde o telefone recebido, por exemplo whatsapp = {{$body.telefone}}.
3
Template. Envie um template usando {{$body.nome}} e outros campos do corpo recebido.
O Webhook responde 202 na hora, com o executionId, e processa em seguida.
Direct a partir de um comentário
Quem comentar QUERO num post recebe o link no direct.
1
Receber comentário. Plataforma Instagram, publicação específica ou qualquer, palavra-chave QUERO com Contém.
2
Responder comentário. Texto público curto: "Te mandei no direct!"
3
Conteúdo. Mensagem no direct com o link. Pode usar {{primeiro_nome}} do autor.
Cada comentário recebe uma única resposta privada, e comentários editados ou apagados não disparam de novo.
Mensagem para cada item de uma lista
Mandar um aviso para cada contato que cumpre aniversário hoje.
1
Gatilho. Programada, diário, às 09:00.
2
Banco de Dados. Tabela Contatos, operação Buscar, filtro de data com o operador de aniversário no dia.
3
Loop. Lista {{tableRows}}. Atraso entre itens de 1500 ms para não enviar em rajada.
4
Template. Ligado à saída Cada item do Loop. Cada linha tem telefone, então a mensagem vai para o contato daquela volta.
Quando o item da lista tem telefone (phone ou whatsapp) e nome, a Olax passa a tratar esse item como o contato da volta e, ao terminar, devolve o contato original. A saída Fim roda depois da última volta.
Referência dos nós
Cada nó com o que faz, quando usar, os campos, um exemplo preenchido e os detalhes técnicos (saídas, limites e formato dos dados).
Gatilhos
Gatilho
Ponto de partida da automação. Define o que faz o fluxo começar.
Quando usar: Todo fluxo começa por um gatilho. Escolha o evento que deve iniciar a conversa ou a rotina.
Mensagem recebida
Aceita texto digitado e cliques em botões ou opções de lista. Filtra o texto ou o título da opção por "é igual a", "contém" ou "inicia com" uma palavra-chave.
Conversa iniciada
Dispara no primeiro contato de todos os tempos ou numa nova conversa depois de X horas sem mensagem.
Programada
Roda sozinha: diário, semanal, mensal (dias do mês), uma vez, em intervalo ou por cron avançado. Horário de São Paulo.
Manual
Só roda quando alguém ou outro fluxo chama. É o gatilho usado pelo nó Chamar Flow.
Card movido no Kanban
Dispara quando um card entra numa coluna de um board escolhido.
Ligação no WhatsApp
Dispara quando uma ligação pelo WhatsApp termina: perdida, atendida, recusada ou com falha.
Passou a seguir no Instagram
Dispara quando quem está conversando no Direct passa a seguir o perfil, uma vez por contato. A Meta não avisa novos seguidores: só é percebido quem mandou DM ou tocou num botão nas últimas 23h.
Canais
Em quais números de WhatsApp, Instagram ou Messenger o gatilho vale.
Exemplo: Evento Mensagem recebida, palavra-chave "agendar", comparação É igual a. Quando alguém mandar exatamente "agendar", a automação começa.
Palavra-chave com "é igual a" evita disparos por engano, por exemplo quando a pessoa escreve uma frase que só contém a palavra.
Movimentações feitas pelo próprio nó Kanban não disparam o gatilho de card movido, para evitar loop.
Para "siga e ganhe": responda o comentário com um botão, peça para seguir e use "Passou a seguir no Instagram" para mandar a recompensa sem a pessoa precisar tocar em "Já segui".
Detalhes técnicos
Comparação da palavra-chave: É igual a (padrão), Contém ou Inicia com. Ignora maiúsculas e acentos e aceita variáveis na palavra-chave.
Tipos de evento: mensagem recebida, programada e manual. O manual só é disparado por outro fluxo (nó Chamar Flow) e cada fluxo tem no máximo um.
Gatilho sem palavra-chave, com Executar sempre, roda em toda mensagem recebida do canal.
Mensagem recebida aceita texto digitado e respostas interativas. O filtro compara o texto recebido ou o título do botão ou da opção de lista.
Programada usa horário de São Paulo e aceita diário, semanal (dias da semana), uma vez, intervalo em minutos ou cron.
Webhook
Inicia o fluxo a partir de um sistema externo, por uma URL própria da automação.
Quando usar: Quando outro sistema (site, formulário, ERP, Zapier, n8n) precisa avisar a Olax que algo aconteceu.
URL e token
Gerados pela Olax. Copie e cole no sistema de origem.
Método HTTP
POST ou GET.
Modo de resposta
Assíncrono: responde 202 na hora com o executionId e processa em seguida.
Saída: O corpo recebido fica disponível como variável para os próximos nós.
Exemplo: Cole a URL gerada no formulário do site. Quando o formulário enviar {"nome":"Ana","telefone":"5511999990000"}, use {{$body.nome}} e {{$body.telefone}} nos nós seguintes.
Detalhes técnicos
A URL e o token são gerados ao salvar a automação. Não invente nem reutilize os de outra automação.
Com a autenticação ativada (o padrão), a chamada precisa levar o token.
Resposta imediata 202 com o executionId; o fluxo roda em seguida. Use o executionId para localizar a execução no histórico.
O corpo recebido fica em {{$body.campo}}; campos aninhados seguem a mesma notação de ponto.
Receber comentário
Dispara quando alguém comenta num post do Instagram ou do Facebook.
Quando usar: Campanhas do tipo "comente QUERO que eu te mando no direct".
Plataforma
Instagram, Facebook ou ambas.
Publicação
Qualquer publicação ou um post específico.
Filtro do comentário
Contém, contém a palavra exata, é igual a ou inicia com a palavra-chave.
Respostas e limite por autor
Decide se respostas dentro de comentários também disparam e quantas vezes a mesma pessoa pode disparar (hora, dia, semana).
Saída: Nome do autor, primeiro nome, texto do comentário e ID do post.
Exemplo: Plataforma Instagram, qualquer publicação, palavra-chave "quero" com Contém. Quem comentar "Quero o link!" dispara o fluxo.
Detalhes técnicos
Só o primeiro fluxo cujo filtro casar dispara para cada comentário.
A resposta pública é idempotente: o mesmo comentário não recebe duas respostas, mesmo se o webhook chegar repetido.
Comentários do próprio perfil são ignorados, assim como edições e remoções de comentário.
Respostas dentro de um comentário só disparam se você ativar essa opção. O limite por autor (horas) é opcional.
Exige a página conectada em Canais e as permissões do Instagram ou do Facebook concedidas na conexão.
Mensagens
Conteúdo
Envia uma ou mais mensagens em sequência: texto, imagem, vídeo, áudio, arquivo, contato ou localização.
Quando usar: Para qualquer mensagem livre dentro da janela de 24 horas de conversa.
Itens
Adicione blocos de texto, mídia, contato ou localização. A ordem da lista é a ordem de envio.
Atraso
Pausa em segundos entre um item e outro, para a conversa parecer natural.
Variáveis
Use {{nome}}, {{whatsapp}} ou qualquer variável do fluxo dentro do texto.
Exemplo: Texto "Oi {{primeiro_nome}}!", espera de 3 segundos com indicador de digitando, imagem da tabela de preços com legenda e outro texto de despedida.
Fora da janela de 24 horas a Meta só aceita template. Use o nó Template nesses casos.
Detalhes técnicos
Os itens enviam na ordem da lista. Tipos: texto, imagem, vídeo, áudio, arquivo, contato, localização e espera.
O item de espera pausa em segundos e pode mostrar "digitando". Recomenda-se uma espera de 3 a 5 segundos antes de cada texto e mais após mídia pesada.
Mídia pede um link público (URL) do arquivo. Link vazio não envia.
Mensagem livre só é aceita pela Meta dentro das 24 horas da última mensagem do cliente.
Template
Envia um template aprovado pela Meta, com variáveis e mídia de cabeçalho.
Quando usar: Para falar com quem não mandou mensagem nas últimas 24 horas, como lembretes e avisos.
Template
Lista os templates aprovados do canal.
Variáveis {{1}}, {{2}}
Preencha com texto fixo ou variáveis do contato e do fluxo.
URL da mídia
Para templates com cabeçalho de imagem, vídeo ou documento.
Número de destino
Opcional. Envia para outro número em vez do contato do fluxo.
Exemplo: Template "lembrete_consulta" com {{1}} = {{primeiro_nome}} e {{2}} = data da consulta vinda de uma variável.
Detalhes técnicos
Lista só templates aprovados do canal do fluxo. Template pertence ao número (WABA), então trocar de canal pode exigir escolher outro.
Com cabeçalho de mídia, informe a URL pública do arquivo.
As variáveis numeradas aceitam texto fixo ou variáveis do fluxo, resolvidas no momento do envio.
Se a Meta recusar o envio, o motivo aparece no histórico da execução.
Botões
Mensagem interativa: botões de resposta, lista de opções ou botão com link. Cada opção vira uma saída do nó.
Quando usar: Menus, confirmações ("Confirmo" / "Quero remarcar") e qualquer escolha guiada.
Texto
A pergunta que acompanha os botões.
Tipo
Botões de resposta (até 3, limite da Meta), lista de opções ou botão com link (URL).
Opções
Ligue a saída de cada opção ao próximo passo daquela escolha.
Saída: O nó mostra quantas vezes foi enviado, quantas vezes cada botão foi clicado e a taxa de clique.
Exemplo: Texto "Como posso ajudar?" com três botões: Agendar, Valores e Atendente. Ligue cada saída a um Conteúdo diferente.
O clique continua o fluxo que enviou os botões; ele não inicia um fluxo novo.
Só um clique real seleciona a saída. Digitar o texto do botão ou da opção de lista não continua esse nó.
Botão sem ligação não leva a lugar nenhum. O validador avisa antes de salvar.
Detalhes técnicos
Botões de resposta: até 3 (limite da Meta). Para mais opções use o tipo lista. O tipo botão com link abre uma URL e não gera saída.
As saídas são button-0, button-1 e button-2, na ordem dos botões. O texto do botão é o identificador da resposta.
O clique é associado ao fluxo que enviou os botões e continua por aquela saída. Botões antigos continuam funcionando enquanto o fluxo existir.
A saída exige um clique real em botão ou opção de lista. Texto digitado com o mesmo título não é tratado como clique.
O cartão da automação mostra envios, cliques por botão e taxa de clique.
Chat
Ações de atendimento sobre o contato e a conversa.
Quando usar: Para organizar a base e controlar o atendimento sem mandar mensagem.
Adicionar ou remover tag
Marca o contato para filtros, campanhas e relatórios.
Bloquear ou desbloquear
Tira ou devolve o contato das mensagens automáticas.
Controle de IA
Liga ou desliga o agente de IA nesta conversa.
Encerrar atendimento
Fecha o atendimento humano em aberto.
Exemplo: Ação Adicionar tag com "pediu-preco". Depois use essa tag para filtrar uma campanha.
Detalhes técnicos
Parar marketing (opt-out) impede campanhas e follow-ups comerciais, mas mantém atendimento. Os nós legados block_contact/unblock_contact alteram somente marketing. Bloqueio completo é uma ação separada da equipe.
Controle de IA liga ou desliga o agente apenas naquela conversa.
Responder Comentário
Responde publicamente o comentário que disparou o fluxo.
Quando usar: Logo depois do gatilho de comentário, para confirmar que a pessoa foi atendida no direct.
Mensagem
Aceita as variáveis do comentário: nome do autor, primeiro nome, texto e ID do post.
Exemplo: Texto "Oi {{primeiro_nome}}, te mandei no direct!" logo depois do gatilho de comentário.
Detalhes técnicos
Só funciona depois de um Receber comentário, que fornece o ID do comentário a responder.
Ações
Kanban
Cria, move, prioriza ou arquiva cards no Kanban.
Quando usar: Para o funil andar sozinho: lead novo vira card, resposta positiva move de coluna.
Board
O quadro do Kanban onde a ação acontece.
Ação
Adicionar novo card, mover card, alterar prioridade (baixa, média, alta) ou arquivar card.
Coluna de destino
Para criar ou mover.
Exemplo: Ação Adicionar novo card, board "Atendimento", coluna "Novo contato".
O card é criado na empresa dona do board e no canal da conversa.
Detalhes técnicos
O card é criado na empresa dona do board e no canal da conversa. Existe no máximo um card por canal para o mesmo contato.
Mover card pelo nó Kanban não dispara o gatilho de card movido, para evitar laço infinito.
Oportunidade
Cria e atualiza oportunidades no funil de vendas do CRM.
Quando usar: Registrar interesse, mover etapa, perder com motivo, definir dono ou próximo contato.
Ação
Criar, mover, perder, atribuir dono ou definir o próximo contato.
Oportunidade
ID opcional quando há uma única oportunidade aberta do contato. Aceita {{oportunidade.id}}.
Etapa e motivo
Valores cadastrados na empresa. Perder exige motivo válido.
Campos tipados
Na ação de campos, informe um objeto JSON com chaves cadastradas. Dinheiro usa centavos.
Saída: opportunityResult contém success, id e os dados da oportunidade; falha fica em error.
Exemplo: Quando uma oportunidade for criada, marque o próximo contato em dois dias e continue o fluxo com um template aprovado.
Mais de um tratamento aberto exige seleção por ID.
O fluxo respeita a empresa e o contato da conversa. Eventos gerados pelo próprio fluxo não o acionam novamente.
HTTP Request
Chama qualquer API externa.
Quando usar: Consultar um sistema próprio, gravar num ERP ou enviar dados para uma planilha.
Método e URL
GET, POST, PUT, PATCH ou DELETE. A URL aceita variáveis.
Cabeçalhos e corpo
Chave e valor, com variáveis do fluxo.
Saída: A resposta da API fica disponível para os próximos nós.
Exemplo: Método POST para https://api.meusistema.com/pedidos com cabeçalho {"Authorization":"Bearer {{$vars.token}}"} e corpo {"telefone":"{{whatsapp}}"}.
Detalhes técnicos
Prazo de 30 segundos. A resposta fica em {{httpResponse.status}} e {{httpResponse.body}} (texto), cortada em 256 KB.
O endereço é checado antes de chamar: redes internas e endereços de metadados de nuvem são bloqueados e httpResponse devolve status 0 com a mensagem de URL bloqueada.
Cabeçalhos aceitam JSON ou um texto simples, que vira o cabeçalho Authorization.
URL, cabeçalhos e corpo aceitam variáveis. O nó segue para o próximo passo mesmo se a chamada falhar: teste httpResponse.status em uma Condição.
Para interpretar o JSON da resposta use um nó Código com JSON.parse.
Conversão Meta
Envia um evento de conversão para a Meta (API de Conversões).
Quando usar: Para os anúncios de clique para WhatsApp aprenderem com agendamentos e vendas reais.
ID do dataset (pixel)
O dataset que recebe o evento.
Evento
Padrão da Meta ou personalizado, com valor e moeda opcionais.
Token e código de teste
Opcionais. Sem token, usa o do canal de WhatsApp.
Exemplo: Dataset do pixel, evento Purchase com valor 250 e moeda BRL, enviado quando o paciente fecha o tratamento.
Quando a conversa veio de anúncio, o evento vai com o identificador do clique; senão, com o telefone criptografado.
Detalhes técnicos
Envia pela API de Conversões da Meta, com prazo de 15 segundos.
Com conversa vinda de anúncio, o evento leva o identificador do clique (ctwa_clid). Sem ele, usa o telefone com hash.
Sem token informado no nó, usa o token do canal de WhatsApp. O código de teste serve para validar no Gerenciador de Eventos.
Pedir permissão p/ ligar
Pede ao cliente autorização para a empresa ligar pelo WhatsApp.
Quando usar: Antes de ligar para um lead ou paciente: sem a autorização, a Meta não deixa a empresa ligar.
Texto do pedido
Aceita variáveis. O botão de permitir é da Meta e não muda.
Pular quem já autorizou
Ligado por padrão: evita gastar o limite de 1 pedido por dia e 2 por semana.
Saída: Diz se o pedido saiu, se foi pulado e o motivo da falha. A resposta do cliente chega no chat.
Exemplo: Depois do gatilho Ligação no WhatsApp (perdida): "Oi {{primeiro_nome}}, vimos sua ligação. Podemos te ligar de volta?"
Só funciona dentro da janela de 24h e em número com ligações ativas (100% API).
Combine com o gatilho Ligação no WhatsApp para pedir a permissão depois de uma ligação perdida.
Detalhes técnicos
Envia a mensagem interativa call_permission_request da Meta pelo canal da conversa. Só sai dentro da janela de 24h.
Com "Pular quem já autorizou", consulta antes a permissão na Meta e não envia se ela for temporária ou permanente.
Limites da Meta por contato: 1 pedido por dia e 2 por semana. O pedido é cobrado como mensagem.
Discord
Publica um aviso num canal do Discord.
Quando usar: Alertas internos para a equipe: lead quente, falha, resumo do dia.
URL do webhook
Copiada nas configurações do canal do Discord.
Mensagem e embed
Título, descrição, cor, campos e rodapé. Tudo aceita variáveis.
Exemplo: Título "Lead quente", descrição "{{nome}} pediu orçamento", cor vermelha.
Detalhes técnicos
Prazo de 15 segundos. Todos os campos aceitam variáveis. A URL do webhook é um segredo: não a publique.
Clinicorp
Conversa com o sistema da clínica: pacientes, agenda, CRM e financeiro.
Quando usar: Para clínicas com a integração Clinicorp ativa em Configurações, Integrações.
Buscar paciente
Por telefone (padrão: o do contato), CPF, nome ou ID.
Criar paciente
Usa nome e telefone do contato quando os campos ficam vazios.
Horários livres e marcar consulta
Com IDs de clínica e profissional. Data fixa ou relativa (0 = hoje, 1 = amanhã).
Listar, confirmar e cancelar consultas
Base para lembretes. A confirmação marca a consulta como confirmada pelo paciente ou muda a situação dela para um status escolhido.
Criar lead e totais financeiros
Lead no CRM da clínica e totais financeiros do período.
Saída: Fica em {{$node.<nome_do_nó>}} com .success, .found, .patient, .appointments, .slots e .count.
Exemplo: Ação Buscar paciente por telefone (padrão: o do contato). Depois uma Condição em {{$node.buscar_paciente.found}}.
O nó nunca para o fluxo: se a Clinicorp falhar, o erro vai em .error. Use uma Condição em .success logo depois.
Para remarcar: cancele e marque de novo.
Detalhes técnicos
Usa as credenciais salvas em Configurações, Integrações (Token API, Usuário API e ID do assinante).
Saída em {{$node.<nome_do_nó>}}: success, found, patient, appointments, slots, count e error.
Nunca para o fluxo: se a Clinicorp falhar, o erro vai em error e o fluxo segue. Teste success logo depois.
Horários livres e marcação pedem IDs da clínica e do profissional. Data relativa: 0 é hoje, 1 é amanhã.
A Clinicorp limita a quantidade de requisições por conta, então muitos fluxos simultâneos podem encontrar esse limite.
Agente de IA
Entrega a conversa para um agente de IA configurado.
Quando usar: Quando a próxima resposta precisa ser gerada pela IA, com a base de conhecimento e as ferramentas do agente.
Agente
Escolha um dos agentes da empresa.
Exemplo: Escolha o agente "Recepção". A próxima resposta da conversa é gerada por ele.
Só aparece para empresas que já têm um agente de IA criado.
Detalhes técnicos
O agente usa a chave de IA salva em Integrações (OpenAI ou Gemini) e as ferramentas e a base de conhecimento dele.
Dados & Código
Variáveis
Cria ou altera variáveis do fluxo.
Quando usar: Guardar um valor para usar depois: status, contador, texto montado.
Variáveis
Nome e valor, do tipo texto, número, sim/não ou JSON.
Exemplo: Definições: link_agenda = https://exemplo.com/agendar e limite = 3. Depois use {{$vars.link_agenda}} nos textos.
Detalhes técnicos
Valores ficam em {{$vars.chave}} (somente leitura) e também no conjunto de variáveis do fluxo.
Boa prática: concentre aqui textos, IDs e limites ajustáveis. Quem for editar a automação muda num só lugar.
O nome começa com letra ou sublinhado e continua com letras, números e sublinhado.
Banco de Dados
Lê e grava nas tabelas da empresa e na base de contatos.
Quando usar: Cadastros próprios (pedidos, inscrições) ou buscar contatos por tag e variável.
Tabela
Uma tabela criada pela empresa ou Contatos (a base da empresa).
Operação
Inserir, atualizar, buscar ou excluir registro.
Filtros
Igual, diferente, contém, começa com, maior, menor, preenchido e vazio.
Saída: Os registros encontrados ficam disponíveis para um Loop ou uma Condição.
Exemplo: Tabela Contatos, operação Buscar, filtro: tag "paciente-ativo". Resultado em {{tableRows}}, para um Loop.
Detalhes técnicos
Operações: inserir, atualizar, buscar e excluir. Buscar preenche {{tableRows}} (lista), {{currentTableRow}} (primeira linha) e {{tableResult}}.
Filtros: igual, diferente, contém, começa com, maior, maior ou igual, menor, menor ou igual, preenchido e vazio. Informe o tipo (texto, número, sim/não, data) em colunas que não são texto.
Contatos é uma tabela virtual e só de leitura. Filtra por tags (qualquer uma, todas ou nenhuma) e por campos, com E ou OU. Datas aceitam aniversário no dia, em N dias, no mês, antes, depois e últimos ou próximos N dias.
O filtro de aniversário acrescenta aniversario_dia, aniversario_mes, aniversario_proximo, dias_para_aniversario e idade a cada linha.
Código (JS)
Roda um trecho de JavaScript num ambiente isolado.
Quando usar: Transformações que os outros nós não fazem: cálculos, formatação, montar listas.
Código
Precisa terminar com return. O valor devolvido vira a saída do nó.
Timeout
Tempo máximo de execução em milissegundos.
Em caso de erro
Parar o fluxo, continuar gravando o erro, ou seguir pela saída "Erro".
Exemplo: return items.map(...) para montar uma lista de {phone, name} a partir de {{$node.requisicao}} e entregar a um Loop.
Detalhes técnicos
O código roda como função assíncrona e precisa terminar com return (objeto ou lista). Sem código, o nó é ignorado.
Disponíveis: $input (item atual), $node (saídas dos nós anteriores), $vars (nó Variáveis, somente leitura), variables (variáveis do fluxo, mutáveis), $item e $index (dentro de Loop), fetch e console.
Executa em ambiente isolado por empresa: um script travado ou pesado não afeta o sistema nem outras empresas, e o código não enxerga variáveis de ambiente do servidor.
Prazo padrão de 10 segundos, configurável. O ambiente impõe um teto (30 segundos por padrão): o erro de tempo informa quando o valor pedido foi reduzido.
O retorno atravessa serialização: classes viram JSON simples. Alterar $node ou $vars gera erro. As variáveis voltam por mesclagem rasa e chaves de sistema são protegidas.
console.log aparece no histórico e no simulador (até 50 linhas por execução). Respostas de fetch têm limite de tamanho.
Em caso de erro: Parar o fluxo, Continuar gravando o erro, ou Seguir pela saída Erro (cria uma saída extra).
Loop (Para cada)
Repete os próximos nós para cada item de uma lista.
Quando usar: Mandar uma mensagem para cada aniversariante, processar cada linha de uma busca.
Lista
Ex.: {{$node.codigo.output}} ou uma variável com array.
Máximo de itens
Trava de segurança para listas grandes.
Atraso entre itens
Em milissegundos.
Exemplo: Lista {{tableRows}}, máximo 500, atraso de 1500 ms. A saída Cada item envia o template; a saída Fim registra o término.
Detalhes técnicos
A lista precisa resolver para um array. Caso contrário o nó falha com erro e nenhum item é processado.
Padrão de 500 itens, no máximo 5.000. Cada volta tem até 50 passos.
Itens com phone ou whatsapp (e name ou nome) viram o contato daquela volta, no WhatsApp e no Telegram. Ao final o contato original é restaurado.
Saídas: Cada item (obrigatória) e Fim. Loops longos, com atraso total alto, são agendados em fila e a saída Fim roda quando a fila termina.
Saída do nó: processed e errors. Você escolhe se um erro em um item interrompe ou não as demais voltas.
Lógica & Fluxo
Verificar seguidor no Instagram
Verifica se a pessoa segue a conta do Instagram que recebeu a mensagem.
Quando usar: Entregar um material a seguidores ou pedir que a pessoa siga e confirme em Já segui.
Saída: Três caminhos: Segue, Não segue e Não foi possível verificar.
Exemplo: Receber comentário "GUIA", enviar botão Quero receber no Direct e verificar após o clique. Segue entrega o guia. Não segue envia Abrir perfil e Já segui, ligado de volta à verificação.
Depois de um comentário, envie primeiro uma mensagem no Direct com botão de resposta. Verifique após a pessoa interagir.
Detalhes técnicos
Funciona somente no Instagram e usa a conta da conversa na empresa dona da automação.
Consulta a Meta novamente a cada passagem, inclusive após Já segui. O botão deve voltar ao mesmo nó.
Saídas: following (Segue), not_following (Não segue) e unavailable (Não foi possível verificar). Erro ou falta de consentimento nunca significam Não segue.
Comentário sozinho não concede acesso ao perfil. Aguarde a interação da pessoa no Direct. Um botão com link apenas abre o perfil; não segue automaticamente.
O resultado fica em {{$node.verificar_seguidor.status}}, .follows e .reason, conforme o nome único do nó.
O simulador usa o cenário escolhido e não consulta um perfil real.
Condição (If)
Divide o fluxo em Verdadeiro e Falso conforme uma regra.
Quando usar: Decidir o caminho: tem tag, respondeu tal palavra, o nó anterior deu certo.
Campo ou variável
Nome, WhatsApp, mensagem recebida, tags ou qualquer variável.
Operador e valor
Igual, contém, maior, vazio e outros, com opção de ignorar maiúsculas e acentos.
Exemplo: Campo "tags", operador contém, valor "vip". Verdadeiro leva ao atendimento prioritário, Falso ao fluxo normal.
Detalhes técnicos
Saídas: Verdadeiro e Falso. Ligue as duas sempre que fizer sentido.
Operadores de campo: igual, contém, começa com, maior, menor, vazio, além de regras do produto como aniversário hoje, está em uma coluna do Kanban, está em uma campanha ativa.
Comparações de texto podem ignorar maiúsculas e acentos.
Também testa o resultado de um nó anterior (por exemplo, se deu certo).
Switch (Case)
Vários caminhos conforme o valor de uma variável.
Quando usar: Quando uma Condição só não basta: menu com várias opções digitadas.
Variável testada
O valor comparado.
Casos
Cada caso vira uma saída. O que não casar segue pelo caminho padrão.
Exemplo: Variável {{resposta}} com casos "1", "2" e "3". Cada caso vira uma saída; o que não casa vai pelo caminho padrão.
Detalhes técnicos
Cada caso gera a saída case-<valor>. O que não casar com nenhum caso segue pelo caminho padrão.
Switch de Tempo
Escolhe o caminho pelo dia da semana e horário.
Quando usar: Horário comercial x fora do expediente, mensagens diferentes no fim de semana.
Casos
Cada caso combina horário e dias da semana, exigindo todas ou qualquer condição. Fora de todos os casos, segue a saída padrão.
Silenciar automação
Opcional. Depois de passar por uma saída, o mesmo contato só volta a passar por ela depois de X horas.
Exemplo: Caso "Horário comercial": segunda a sexta, 09:00 às 18:00. Fora disso, saída padrão.
Detalhes técnicos
Cada caso combina condições de dia da semana e faixa de horário, exigindo todas (E) ou qualquer uma (OU). Saídas: case-<id> e default.
Horário de São Paulo.
Silenciar automação: depois de passar por uma saída, o mesmo contato só volta a passar por ela depois de N horas.
Espera (Delay)
Pausa o fluxo antes do próximo passo.
Quando usar: Dar um respiro entre mensagens ou esperar alguns minutos antes de insistir.
Espera
Tempo em segundos.
Exemplo: Espera de 5 segundos entre duas mensagens. Para pausas longas (horas ou dias) use Follow-up.
Detalhes técnicos
Valor em segundos, maior que zero. Pode mostrar "digitando" durante a espera.
Para esperar dias ou aguardar resposta do cliente, prefira Follow-up ou Aguardar resposta.
Follow-up
Espera o contato responder; se ele não responder no prazo, segue para o próximo passo.
Quando usar: Retomar orçamento parado, lembrar quem não confirmou.
Esperar
Quantidade e unidade (minutos, horas ou dias).
Exemplo: Esperar 1 dia. Respondeu leva ao atendimento; Não respondeu envia o segundo lembrete.
Se o cliente responder antes, o follow-up é cancelado.
Detalhes técnicos
Prazo de 1 a 43.200 minutos (30 dias). Precisa vir depois de um nó que envia mensagem.
Saídas: Respondeu (a pessoa respondeu antes do prazo; o follow-up é cancelado) e Não respondeu (prazo vencido).
A espera é gravada e retomada depois, inclusive se o sistema reiniciar.
Aguardar resposta
Pausa o fluxo e captura a próxima mensagem do cliente numa variável.
Quando usar: Pedir CPF, data de nascimento, escolha digitada ou qualquer outro dado antes de validar.
Variável
Nome que receberá o texto da próxima resposta.
Exemplo: Variável "cpf". Depois de "Pode me informar seu CPF?", o fluxo para e a próxima mensagem vira {{cpf}}.
Depois, use a variável em uma Condição ou Switch.
Detalhes técnicos
O nome da variável começa com letra ou sublinhado e continua com letras, números e sublinhado.
A pausa vale para aquela conversa e aquele canal. Sem canal ou contato definidos na execução, o ramo fica pausado e não continua.
Use a variável em uma Condição ou Switch logo depois, por exemplo para validar o formato.
Chamar Flow
Chama outra automação e passa dados para ela.
Quando usar: Reaproveitar um trecho comum (ex.: cadastro) em vários fluxos.
Automação destino
A automação chamada, que precisa ter um gatilho Manual.
Parâmetros
Chave e valor enviados para o fluxo chamado.
Exemplo: Chamar o fluxo "Cadastro" passando origem = "campanha_x". O fluxo chamado começa no gatilho Manual dele.
Detalhes técnicos
O fluxo chamado herda uma cópia das variáveis, o contato, o canal e a empresa. Parâmetros sobrescrevem variáveis de mesmo nome.
O fluxo que chamou espera o outro terminar antes de seguir.
Profundidade máxima de 5 níveis. Chamar o próprio fluxo é bloqueado. Fluxo destino inativo não dispara e o fluxo pai continua.
No simulador vale a mesma regra: fluxo destino inativo não é percorrido e o passo mostra um aviso. Para testar o fluxo chamado, ative-o; com gatilho só manual, ele só roda quando outro fluxo o chama.
Anotações
Nota
Post-it no canvas. Não executa nada.
Quando usar: Explicar para a equipe o que um trecho do fluxo faz.
Texto
Anotação livre.
Exemplo: Anote no canvas: "Edite os textos no nó Variáveis."
Detalhes técnicos
Não tem entradas nem saídas e não pode ser ligada a nada. Suporta Markdown e não conta como nó executável.
Limites e comportamento
Valores que o motor de execução aplica. Servem para dimensionar fluxos grandes.
Item
Valor
Detalhe
Passos por execução
200 no fluxo principal
Conta cada nó executado no caminho de topo. Passou disso, a execução é interrompida.
Itens por Loop
500 por padrão, até 5.000
Configurável em Máximo de itens. Listas maiores são cortadas. Se o campo Lista não resolver para uma lista, o nó falha e nenhum item é processado.
Passos por volta de Loop
50
Cada item do Loop tem o próprio orçamento. Voltas não consomem os 200 do fluxo principal. Loops longos, com muito atraso entre itens, são agendados em fila e continuam mesmo se o sistema reiniciar.
Teto absoluto
10.000 passos
Proteção contra loops aninhados fora de controle.
Chamar Flow
profundidade 5
A chama B, B chama C, e assim até 5 níveis. Chamar o próprio fluxo é barrado. Fluxo chamado inativo não dispara.
Nó Código
10 s por padrão, até 30 s
O prazo é configurável no nó. O teto do ambiente pode ser maior em instalações dedicadas.
HTTP Request
30 s e 256 KB de resposta
Passou do prazo, falha. O corpo da resposta guardado é cortado em 256 KB.
Follow-up
1 minuto a 30 dias
Valor em minutos, de 1 a 43.200.
Botões de resposta
3
Limite da Meta. Para mais opções use lista.
Problemas comuns
O que costuma dar errado, por que acontece e o que conferir.
A automação não dispara
Causa provável: Está inativa, o canal não está marcado, a palavra-chave não bate com a comparação escolhida, ou o contato está bloqueado.
O que fazer: Confira a chave de ativação no cartão e os canais da automação. Use Contém se a pessoa escreve frases.
A mensagem não chegou ao cliente
Causa provável: Fora da janela de 24 horas a Meta recusa mensagem livre.
O que fazer: Use um nó Template. Veja o histórico de execuções para o motivo devolvido pela Meta.
Botão clicado e nada acontece
Causa provável: A saída daquele botão não está ligada a nenhum nó.
O que fazer: Valide a estrutura e ligue cada saída. O clique continua o fluxo que enviou os botões.
Execução marcada como sucesso, mas nada foi enviado
Causa provável: Sucesso significa que o fluxo terminou, não que houve envio. Pode ter seguido por um caminho sem mensagem ou o nó anterior devolveu vazio.
O que fazer: Abra a execução e veja por quais nós passou. Simule o mesmo caso.
Variável aparece vazia ou literal na mensagem
Causa provável: Nome digitado diferente, ou o nó que a cria está depois do nó que a usa.
O que fazer: Confira o nome (o título do nó vale para {{$node.titulo}}) e a ordem das ligações.
HTTP Request não retorna o esperado
Causa provável: Endereço bloqueado por segurança (rede interna), prazo de 30 s estourado ou corpo grande demais.
O que fazer: Use endereço público, olhe a variável httpResponse (status e corpo) e reduza o tamanho da resposta.
Nó Código falha por tempo
Causa provável: O script passou do prazo configurado ou do teto do ambiente.
O que fazer: Reduza o trabalho, mova trechos para outros nós ou aumente o prazo no nó. Escolha Em caso de erro para decidir se o fluxo continua.
O fluxo parou no meio
Causa provável: Atingiu o limite de passos, uma espera ainda aguarda resposta ou o Follow-up não venceu.
O que fazer: Veja o histórico da execução. Esperas aparecem como pendentes até a resposta ou o prazo.