Principal Fluxos
🔀

Fluxos

Automatize seu atendimento com fluxos visuais
Christopher
Por Christopher
• 12 artigos

Criando seu primeiro fluxo de automação

Os Fluxos permitem automatizar o seu atendimento de forma visual: você monta o caminho que a conversa deve seguir (mensagens, perguntas, condições, ações) e a plataforma executa tudo automaticamente. Neste tutorial, você vai criar seu primeiro fluxo: uma mensagem automática de boas-vindas para cada nova conversa. Passo 1 — Acesse a área de Fluxos No menu lateral, clique em Fluxos. Você verá a lista com todos os fluxos da sua conta, o estado de cada um (ativo/inativo) e as execuções recentes. Lista de fluxos Clique no botão azul Criar Fluxo, no canto superior direito. Passo 2 — Conheça o editor O editor abre com o Gatilho já posicionado — é ele que define quando o fluxo dispara. O padrão é Conversa Criada: o fluxo executa sempre que uma nova conversa chegar. Editor com o gatilho 💡 Clicando no gatilho você pode trocar o tipo de disparo (palavra-chave, webhook, disparo agendado, entre outros). Para este tutorial, mantenha Conversa Criada. Passo 3 — Adicione um nó de mensagem Clique no botão + (canto superior esquerdo do editor) para abrir o painel de nós. Pesquise por "mensagem" e clique em Enviar Mensagem. Adicionar nó de mensagem O nó aparece no quadro, ainda vazio. Passo 4 — Escreva a mensagem Clique no nó recém-criado para abrir o painel de configuração à direita. Em Adicionar Conteúdo, clique em Texto e escreva a mensagem de boas-vindas. Configurar a mensagem 💡 Digite {{ em qualquer campo de texto para inserir variáveis (nome do contato, dados coletados etc.) e personalizar a mensagem. Passo 5 — Conecte o gatilho à mensagem Todo fluxo funciona por conexões. Clique na bolinha verde na parte de baixo do Gatilho, segure e arraste até a bolinha no topo do nó de mensagem. A linha pontilhada indica o caminho da conversa. Conectar os nós Passo 6 — Dê um nome e salve Clique no título "Nome do fluxo" (canto superior esquerdo), escolha um nome descritivo — por exemplo, Boas-vindas automáticas — e confirme. Depois clique em Salvar, na barra superior. Fluxo salvo Passo 7 — Ative o fluxo Um fluxo recém-criado nasce inativo. Para colocá-lo para funcionar, marque a caixa Ativo na barra superior do editor (ou use o botão liga/desliga no cartão do fluxo, na listagem) e salve. Pronto! 🎉 A partir de agora, toda nova conversa recebe sua mensagem de boas-vindas automaticamente. Dicas para evoluir - Aguardar resposta: ative essa opção no nó de mensagem para o fluxo pausar até o contato responder — ideal para perguntas. - Condições e menus: combine os nós de Lógica para criar menus de atendimento ("digite 1 para Suporte…"). - Organização: use o botão Organizar (varinha ✨) para arrumar automaticamente o desenho do fluxo. - Diagnóstico: o botão Registros de execuções na barra do editor mostra cada execução, passo a passo.

Última atualização em Aug 11, 2026

Gatilhos: quando o seu fluxo dispara

O Gatilho é o primeiro nó de todo fluxo: ele define quando a automação dispara. Escolher o gatilho certo é a decisão mais importante do seu fluxo — este guia apresenta cada tipo e quando usar. Para trocar o tipo, clique no nó de Gatilho no editor e selecione a opção em Tipo de Gatilho. Conversa Criada (padrão) Dispara uma vez quando uma nova conversa é aberta — ideal para boas-vindas, menus de atendimento e triagem inicial. Gatilho Conversa Criada Em Tipo de Canal você limita o disparo a um canal específico (ex.: só WhatsApp) ou mantém Todos os canais. Mensagem Criada Dispara a cada mensagem recebida do contato. Use para responder palavras-chave ou reagir durante a conversa. Gatilho Mensagem Criada ⚠️ Como dispara a cada mensagem, ative "Ignorar conversas já atribuídas a um agente" para o fluxo não interferir em atendimentos humanos em andamento. Webhook (HTTP POST) Permite que um sistema externo dispare o fluxo por uma chamada HTTP — e faz muito mais: se o contato do payload não existir, ele é cadastrado automaticamente (telefone/e-mail), a conversa é aberta no canal escolhido e todos os campos enviados viram variáveis ({{variables.campo}}) para usar nas mensagens. Gatilho Webhook Recursos do painel: - URL do Webhook: o endereço que o sistema externo vai chamar (trate como senha; dá para regenerar o token). - Capturar exemplo: receba um POST de teste e mapeie os campos do payload com cliques. - Canal: onde a conversa será criada — obrigatório se o fluxo envia mensagens. - Mapeamento de campos: grava dados do payload direto no cadastro do contato. Ideal para: integrar formulários do site, CRMs e sistemas próprios que cadastram contatos e já iniciam a jornada. Disparo agendado (diário) Executa o fluxo 1× por dia no horário e nos dias da semana escolhidos (fuso de Brasília) — para rotinas como lembretes de agendamento, cobranças e follow-ups diários. Gatilho Disparo agendado Combine com um nó "Fonte de contatos" logo após o gatilho: é ele que busca os registros do dia (consultas, cobranças, listas) e abre uma conversa para cada contato. Outros gatilhos - Conversa Aberta / Conversa Resolvida — reagem à mudança de status da conversa (ex.: mensagem de pesquisa de satisfação ao resolver). - Entrada por Sub-fluxo — o fluxo não dispara sozinho; ele é chamado por outro fluxo (nó "Chamar Fluxo"). Use para modularizar jornadas grandes. - Evento de integração — dispara a partir de eventos das integrações nativas (ex.: ligação recebida no PABX), com os dados do evento disponíveis como variáveis. Dicas - Um fluxo, um gatilho: cada fluxo tem um único gatilho. Precisa de dois comportamentos? Crie dois fluxos. - Campanhas também disparam fluxos: ao criar uma Campanha de WhatsApp, você pode escolher um fluxo como conteúdo — o disparo em massa fica por conta da campanha. - Depois de mudar o gatilho, salve o fluxo e confira se ele está Ativo.

Última atualização em Aug 16, 2026

Mensagens, botões e coleta de dados

O nó Enviar Mensagem é o coração de qualquer fluxo — e vai muito além de texto. Neste guia você conhece os tipos de conteúdo, aprende a criar botões e a coletar dados do contato. Tipos de conteúdo Clique no nó de mensagem para abrir o painel de configuração. Em Adicionar Conteúdo, você pode empilhar vários blocos na mesma mensagem: Painel de conteúdos do nó de mensagem - Texto — mensagem simples; aceita variáveis e emojis - Imagem / Arquivo — mídia enviada junto - Botões — opções de resposta rápida (cada botão vira um caminho do fluxo!) - Capturar Dados — pergunta e guarda a resposta do contato - Template WhatsApp — modelos aprovados pela Meta (obrigatórios fora da janela de 24h) - Flow do WhatsApp, Carrossel, Botão de Link, Pedir Localização — recursos nativos do WhatsApp 💡 Em qualquer campo de texto, digite {{ para inserir variáveis — nome do contato, respostas coletadas, dados de APIs. Ex.: Olá {{contact.first_name}}! Botões: cada opção vira um caminho Adicione o bloco Botões e crie uma opção por linha. O detalhe mais importante: cada botão ganha uma saída própria no nó — conecte cada uma a um caminho diferente do fluxo. Botões com saídas próprias No exemplo acima, "Falar com vendas" e "Suporte técnico" aparecem como conectores separados na parte de baixo do nó — o contato toca no botão e o fluxo segue pelo caminho correspondente, sem precisar de condições. Capturar Dados: pergunte e guarde O bloco Capturar Dados faz uma pergunta, espera a resposta e guarda o valor: Capturar dados 1. Mensagem de pergunta — o que o contato vai receber (ex.: "Qual é o seu CPF?") 2. Tipo de dado — os atalhos (Nome, E-mail, Telefone, CPF, Nascimento…) já validam o formato da resposta 3. Nome da variável — como você vai referenciar depois (ex.: nome_cliente → {{variables.nome_cliente}}) 4. Salvar também no campo do contato — além da variável, grava direto na ficha do contato (ex.: atualiza o e-mail do cadastro) Aguardar resposta O interruptor Aguardar resposta pausa o fluxo até o contato responder — essencial quando o próximo passo depende da resposta (menus, confirmações). Sem ele, o fluxo dispara a mensagem e segue imediatamente para o próximo nó. Dicas - Menu interativo: botões + "Aguardar resposta" + um nó de Roteador comparando {{context.last_user_reply}} — veja o tutorial Condições e roteamento. - Pausa natural: o campo "Aguardar antes do próximo" adiciona segundos de espera entre blocos — deixa a conversa com ritmo humano. - A resposta mais recente do contato está sempre em {{context.last_user_reply}}.

Última atualização em Aug 11, 2026

Condições e roteamento: menus, regras e testes A/B

Depois de enviar mensagens, o próximo passo é decidir caminhos: menus de atendimento, regras por perfil do contato e testes A/B. Três nós resolvem tudo isso. Roteador — o nó de menus O Roteador compara uma variável com valores exatos e envia o contato para a rota correspondente. É o nó ideal para menus ("digite 1 para Suporte…"). Roteador configurado Como configurar: 1. Variável a comparar — para menus, use {{context.last_user_reply}} (última resposta do contato) 2. Rotas — um valor por rota. Aceita vários valores separados por vírgula: 1, vendas faz tanto "1" quanto "vendas" caírem na mesma rota 3. Handle padrão — para onde vai quem digitou algo fora do menu. Sempre conecte (ex.: mensagem "Opção inválida" voltando ao menu) Condição Avançada — regras com operadores Quando a decisão não é um menu, e sim uma regra ("se tem oportunidade aberta", "se a resposta contém sim", "se o CPF não está vazio"), use a Condição Avançada: Condição Avançada - Cada Caminho tem sua condição: atributo/variável + operador (igual, contém, vazio, maior que, regex…) + valor - A primeira condição que corresponder vence — a ordem importa - O caminho Fallback recebe quem não se encaixou em nenhuma condição — sempre conecte O painel ainda mostra variáveis especiais prontas: {{context.is_working_hours}} (dentro do horário de atendimento?), {{context.has_opportunity}} (contato já tem oportunidade no CRM?) e {{context.opportunity_status}}. Dividir Tráfego — testes A/B e rotação O Dividir Tráfego distribui os contatos por percentuais — sem olhar conteúdo, só sorteio: Dividir Tráfego A/B Usos clássicos: testar duas versões de mensagem (A/B), revezar templates de WhatsApp em campanhas (para não desgastar um modelo só) e distribuir carga entre jornadas. Qual usar? | Situação | Nó | |---|---| | Menu de opções ("1, 2, 3") | Roteador | | Regra sobre dados ("se…, então…") | Condição Avançada | | Sorteio percentual / teste A/B | Dividir Tráfego | ⚠️ Regra de ouro dos três: nunca deixe o caminho padrão/fallback desconectado. É por ele que saem os casos inesperados — desconectado, o fluxo simplesmente termina em silêncio.

Última atualização em Aug 11, 2026

Requisição HTTP: integre APIs ao seu fluxo

O nó Requisição HTTP conecta seus fluxos a qualquer sistema com API: consultar um pedido no ERP, buscar um cadastro, registrar um lead. Este guia mostra a configuração completa. Abrindo a configuração Adicione o nó Requisição HTTP (categoria Integrações) e clique em Configurar Requisição HTTP — abre o editor completo: Editor da Requisição HTTP - Método + URL — GET para consultar, POST para enviar. A URL aceita variáveis: https://api.exemplo.com/pedidos/{{contact.phone}} - Salvar resposta em variável — o corpo da resposta fica disponível como {{variables.nome_da_variavel.campo}} nos próximos nós - O painel Entrada (à direita) lista as variáveis que você pode usar na URL, headers e corpo - Abas: Auth (Basic, Bearer, API Key), Headers, Body, Options e Settings (tentativas em caso de erro) Enviando dados (Body) Na aba Body, marque Enviar body, escolha JSON e monte o corpo — variáveis funcionam normalmente: Body JSON com variáveis ⚠️ O passo mais esquecido: marcar "Enviar body". Corpo preenchido com o envio desligado = a API recebe uma requisição vazia. Teste e mapeie a resposta com cliques Clique em Testar no topo: a requisição real é executada e a resposta aparece na aba Saída. Melhor parte: na sub-aba Mapping, clique em qualquer campo do JSON retornado para transformá-lo numa variável própria (ex.: campo dados.nome → {{variables.nome}}) — sem digitar caminhos na mão. As duas saídas do nó - Sucesso — a API respondeu 2xx: siga o fluxo usando os dados - Erro — falha de rede, timeout ou status 4xx/5xx 🚨 Sempre conecte a saída de Erro — por exemplo, a uma Nota privada explicando a falha + transferência para um atendente. Com a saída de erro desconectada, uma instabilidade da API encerra o fluxo em silêncio e ninguém fica sabendo. Boas práticas - Feedback ao contato: antes de uma consulta, envie "Só um momento enquanto verifico… 🔎" — nunca deixe o cliente no vácuo - Retry: na aba Settings, ative "Tentar novamente em falha" para APIs instáveis - Confirmação antes de ações: para APIs que executam algo (criar pedido, agendar), confirme com o contato antes de chamar - Combine com a Condição Avançada para tratar a resposta (ex.: {{variables.status}} igual a "aprovado" → um caminho; senão → outro)

Última atualização em Aug 11, 2026

Webhook: cadastre contatos e dispare fluxos de fora da plataforma

E se o seu site, CRM ou sistema interno pudesse cadastrar um contato e disparar uma jornada completa no WhatsApp com uma única chamada? É exatamente isso que o gatilho Webhook faz — a integração mais poderosa dos fluxos. O que acontece em uma chamada Quando o seu sistema envia um POST para a URL do fluxo, a plataforma: 1. Busca o contato pelo telefone ou e-mail — e cadastra automaticamente se não existir 2. Abre a conversa no canal configurado (ou reutiliza a que já estiver aberta) 3. Dispara o fluxo na hora — template, mensagens, consultas, tudo 4. Deixa todos os campos do payload disponíveis como variáveis ({{variables.campo}}) Configurando o gatilho Crie (ou duplique) um fluxo e, no nó de Gatilho, escolha Webhook (HTTP POST): Gatilho Webhook - URL do Webhook — o endereço que o sistema externo vai chamar. Salve o fluxo para gerar a URL definitiva. 🔐 Trate como senha: quem tem a URL dispara o fluxo. Vazou? Use Regenerar token. - Canal — onde a conversa será criada. Selecione sempre que o fluxo enviar mensagens. O payload POST https://chat.simplesdesk.com.br/webhooks/flows/SEU_TOKEN Content-Type: application/json { "phone_number": "+5511999998888", "name": "Maria da Silva", "email": "[email protected]", "pedido_id": "123" } Regras de ouro: - phone_number sempre no formato internacional +55 + DDD + número — formato diferente duplica contato - Envie phone_number ou email (é assim que o contato é localizado/criado) - Qualquer campo extra vira variável: pedido_id acima fica disponível como {{variables.pedido_id}} em todas as mensagens e nós do fluxo — sem configurar nada A resposta da chamada confirma o resultado: {"received": true, "contact_id": …, "conversation_id": …}. Capturar exemplo: mapeie campos com cliques Clique em Capturar exemplo e peça um POST de teste ao sistema externo — o payload real aparece na tela e os campos são sugeridos para mapeamento: Capturar exemplo aguardando Mapeamento e política de conversa Mapeamento e política - Mapeamento de campos do payload — grava campos do payload direto na ficha do contato (campos padrão ou atributos personalizados). Sem mapeamento, o dado continua disponível como variável — só não persiste no cadastro. - Se já houver conversa aberta/pendente — escolha entre Reutilizar e executar o fluxo (padrão), Reutilizar sem executar ou seguir pela saída especial "Conversa existente" do gatilho, que permite tratar esse caso num caminho próprio. - Requisições recentes — o log de todas as chamadas recebidas (sucesso e erro, com o payload): o primeiro lugar para investigar quando "não chegou". Casos de uso - Formulário do site → cadastro + primeira mensagem em segundos - CRM/ERP → evento no sistema (proposta enviada, boleto vencendo) dispara a régua no WhatsApp - Vários números: crie um fluxo por canal (cada um com a sua URL) e distribua os cadastros entre as URLs no seu sistema — protege os números e organiza a operação 💡 Dica: enviando os dados que o fluxo usaria para perguntar (ex.: CPF), dá para pular etapas de coleta com uma Condição Avançada no início: variável presente → segue direto; ausente → pergunta normalmente.

Última atualização em Aug 16, 2026

Organização e diagnóstico: fluxos legíveis e fáceis de depurar

Fluxo que cresce vira bagunça — nós sobrepostos, linhas cruzadas, e ninguém mais entende o desenho. E quando algo "não funciona", como descobrir o que aconteceu? Este guia fecha a série mostrando as ferramentas de organização e diagnóstico do editor. Organize com um clique Reconhece a cena? Nós amontoados depois de várias edições: Fluxo desorganizado Clique no botão Organizar (varinha ✨ — na barra do rodapé do editor; em telas menores, dentro do menu ☰). O editor recalcula todas as posições a partir da estrutura do fluxo: camadas de cima para baixo, espaçamento uniforme, ramos paralelos lado a lado: Fluxo organizado automaticamente - Ctrl+Z desfaz se preferir o arranjo anterior - As notas adesivas ficam onde estão (marcações suas não se movem) - Ao arrastar nós manualmente, eles agora encaixam numa grade — alinhamento sem esforço Avisos de configuração O editor vigia os erros silenciosos mais comuns. Quando encontra algum, um selo âmbar ⚠️ aparece na barra — clique para ver a lista: Painel de avisos O que ele detecta: - Saída de erro de Requisição HTTP desconectada — se a API falhar, o fluxo terminaria em silêncio - Variável usada que nenhum nó produz — nome digitado errado ou mapeamento esquecido - Templates WhatsApp de canais diferentes no mesmo fluxo — a resposta do contato cairia em outra conversa - Corpo preenchido com "Enviar body" desligado — a API receberia uma requisição vazia São avisos, não bloqueios — mas cada um representa um problema real que já custou horas de investigação de algum time. Vale resolver antes de ativar. Registros de execuções: o raio-X do fluxo "O contato disse que não recebeu nada" — e agora? Clique em Registros de execuções na barra do editor. Cada execução mostra o caminho completo, passo a passo: Painel de execuções Para cada execução você vê: - Status geral (concluído, falha, rodando, aguardando resposta) e duração - O trace nó a nó: quais executaram, por qual saída seguiram, quanto tempo levou cada um - Respostas de APIs: o status HTTP e um trecho do que a API devolveu naquele nó — dá para ver na hora um erro 400 ou um "status: pendente" - Variáveis da execução: tudo que o fluxo coletou e mapeou (CPF informado, nome retornado pela API…) - Link direto para a conversa do contato 💡 Fluxos com gatilho Webhook têm ainda o log próprio de Requisições recentes no nó de gatilho — mostra cada chamada que o sistema externo fez, com o payload recebido. Checklist de qualidade antes de ativar 1. ✅ Clicou em Organizar e o desenho está legível? 2. ✅ O selo de avisos está zerado (ou você sabe explicar cada aviso restante)? 3. ✅ Toda saída de erro/fallback/padrão está conectada a algum destino? 4. ✅ Fez um disparo de teste e conferiu o registro da execução de ponta a ponta? 5. ✅ O fluxo está Ativo e salvo? Com isso você fecha a série de Fluxos: criação, gatilhos, mensagens, decisões, APIs, integrações externas e — agora — organização e diagnóstico. Bons fluxos! 🚀

Última atualização em Aug 11, 2026

Editor de fluxos: atalhos e gestos que aceleram a montagem

O editor de fluxos ganhou uma série de gestos que tornam a montagem muito mais rápida. Este guia resume todos. Paleta rápida: solte a conexão no vazio Arraste a partir de qualquer saída de um nó e solte num espaço vazio do canvas: uma paleta compacta abre no ponto exato, com busca e os nós usados recentemente. O nó escolhido já nasce conectado à saída de origem. Prefere teclado? Aperte Tab com o canvas em foco — a paleta rápida abre no centro da tela. Inserir um nó no meio de uma ligação Crie um nó pela paleta (ele fica solto) e arraste-o até encostar numa linha entre dois nós: ao soltar, ele entra no meio da ligação (origem → nó novo → destino), preservando o rótulo do caminho. Nós de ramificação (Condição, Dividir Tráfego) não fazem essa inserção automática — ligue-os manualmente para escolher as saídas. Atalhos de teclado | Atalho | Ação | |---|---| | Ctrl + C / Ctrl + V | Copiar e colar nós — os colados já ficam selecionados | | Ctrl + D | Duplicar a seleção | | Delete / Backspace | Excluir a seleção (o início do fluxo é protegido) | | Setas | Mover a seleção (10px; com Shift, ajuste fino de 1px) | | Ctrl + A | Selecionar todos os nós | | Ctrl + Z / Ctrl + Shift + Z | Desfazer / refazer | | Tab | Abrir a paleta rápida | Busca que entende português A busca da paleta aceita o que você quer fazer, não só o nome do nó: "planilha" encontra Google Sheets, "cobrança" encontra Asaas, "esperar" encontra Aguardar, "carrinho abandonado" encontra Nuvemshop, "se" encontra Condição. Outros gestos - Duplo clique no título de um nó renomeia na hora, sem abrir o painel. - Notas adesivas agora têm 6 cores — selecione a nota e escolha a cor na paleta que aparece acima dela. Ótimo para convenções de equipe ("amarelo = pendência"). - Botão direito → Selecionar daqui para baixo / para cima seleciona a cadeia inteira ligada ao nó — mover ou duplicar um ramo completo vira um gesto só.

Última atualização em Aug 13, 2026

Depurando fluxos: caminho da execução, dados por nó e reexecução

Quando um fluxo não faz o esperado, o editor tem quatro ferramentas de diagnóstico — todas sem sair do canvas. Ver o caminho da execução no canvas No painel Logs, cada execução tem o link "Ver caminho": os nós percorridos ficam verdes, o ponto de falha vermelho, e onde a execução está aguardando pulsa em âmbar — com as ligações atravessadas destacadas. Um clique no chip flutuante limpa o destaque. Dados reais de cada nó Botão direito num nó → "Ver dados do nó": um painel mostra as últimas execuções que passaram por ali — resultado, duração, saída tomada, erro, resposta HTTP e as variáveis daquela execução. É a resposta rápida para "o que exatamente chegou neste nó?". Reexecutar a partir de onde falhou Execução falhou por instabilidade de uma API? No painel de Logs, execuções com falha têm o botão "Reexecutar daqui": a plataforma retoma a execução do nó que falhou, reaproveitando todas as variáveis já coletadas — sem recomeçar a conversa com o contato. Depuração ao vivo No menu do editor, "Depuração ao vivo (5 min)" liga um modo em que cada execução real é pintada no canvas em tempo real, nó a nó, enquanto acontece. Ideal para acompanhar um teste com um contato real. Desliga sozinho após 5 minutos (ou no clique do chip vermelho). Desativar um nó sem apagar Botão direito → "Desativar nó": ele fica translúcido com o selo ⏸ e as execuções pulam direto por ele, seguindo pelo caminho "Continuar". Perfeito para testar hipóteses em produção sem desmontar o fluxo — reative quando quiser.

Última atualização em Aug 13, 2026

Versões, fluxo de erro e subfluxos: fluxos grandes sob controle

Quatro recursos para operar fluxos grandes com segurança. Histórico de versões Cada salvamento que muda a estrutura do fluxo gera um snapshot (mantemos os últimos 20). No menu do editor → Histórico de versões, veja quando e por quem cada versão foi salva e restaure qualquer uma — a restauração guarda o estado atual antes, então nada se perde. Fluxo de erro No menu do editor, defina um Fluxo de erro: quando uma execução deste fluxo falhar, o fluxo escolhido roda automaticamente na mesma conversa, recebendo as variáveis {{variables.error_message}}, {{variables.failed_flow_name}} e {{variables.failed_node_id}}. 📘 O fluxo de erro roda na conversa do cliente — prefira ações internas (nota, etiqueta, transferir para um time) a mensagens, para o contato não receber detalhes técnicos. Extrair seleção para subfluxo Selecione um trecho do fluxo (com uma entrada e até uma saída) → botão direito → "Extrair seleção p/ subfluxo": o trecho vira um fluxo separado e reutilizável, e no lugar entra um nó "Chamar subfluxo" com repasse de variáveis. A mesma régua (ex.: coleta de CPF) passa a existir uma vez só e é chamada por quantos fluxos precisar. Gatilho "Conversa criada": Ativo × Receptivo O gatilho Conversa criada ganhou o filtro Origem da conversa: - Receptivo — só quando o contato inicia a conversa; - Ativo — só quando a plataforma inicia (disparo de fluxo); - Qualquer — comportamento clássico (padrão dos fluxos existentes). Use Receptivo no seu fluxo de boas-vindas para ele não disparar em cima das conversas criadas pelos seus próprios disparos ativos. A reabertura de uma conversa resolvida conta como Receptivo (é o contato voltando). Bônus: saídas por botão de template Nós que enviam template do WhatsApp com botões de resposta rápida agora mostram uma saída por botão — ligue "Confirmar" para um caminho e "Cancelar" para outro, sem nó de condição. Botão sem ligação segue pelo "Continuar", como antes.

Última atualização em Aug 13, 2026

Referência completa de variáveis dos fluxos

Em qualquer campo de texto dos fluxos você pode usar variáveis no formato {{grupo.nome}} — elas são substituídas pelo valor real no momento da execução. Digite {{ no editor para ver o autocompletar. Variável sem valor vira texto vazio (a mensagem não quebra). Contato — {{contact.*}} | Variável | Conteúdo | |---|---| | {{contact.name}} | Nome cadastrado | | {{contact.full_name}} | Nome completo (nome + sobrenomes) | | {{contact.first_name}} | Primeiro nome (ex.: "João da Silva" → "João") | | {{contact.last_name}} | Último sobrenome | | {{contact.phone_number}} | Telefone | | {{contact.email}} | E-mail | | {{contact.language}} | Idioma detectado | | {{contact.lead_source}} | Fonte do lead | | {{contact.labels}} | Etiquetas do contato | | {{contact.custom_attributes.SEU_CAMPO}} | Qualquer campo personalizado (ex.: {{contact.custom_attributes.cnpj_cpf}}) | Conversa — {{conversation.*}} | Variável | Conteúdo | |---|---| | {{conversation.display_id}} | Número da conversa | | {{conversation.status}} | Status (open, pending, resolved…) | | {{conversation.inbox_name}} | Nome do canal | | {{conversation.labels}} | Etiquetas da conversa | | {{conversation.is_assigned}} | "true" se tem agente atribuído | | {{conversation.last_input}} | Última mensagem recebida do contato | | {{conversation.last_input_type}} | Tipo da última mensagem (text, image…) | | {{conversation.hours_since_last_contact_message}} | Horas desde a última mensagem do contato (ótima para lógica de janela de 24h) | Agente, time e conta | Variável | Conteúdo | |---|---| | {{assigned_agent.name}} / {{assigned_agent.email}} | Agente atribuído | | {{assigned_team.name}} | Time atribuído | | {{account.name}} | Nome da conta | Contexto — {{context.*}} (data, hora e situação) | Variável | Conteúdo | |---|---| | {{context.current_date}} | Data de hoje (AAAA-MM-DD) | | {{context.current_time}} | Hora atual (HH:MM) | | {{context.current_hour}} / {{context.current_day}} / {{context.current_month}} | Hora / dia / mês numéricos | | {{context.current_weekday}} | Dia da semana (monday, tuesday…) | | {{context.is_working_hours}} | "true" dentro do horário de atendimento da caixa | | {{context.hours_since_interaction}} | Horas desde a última interação | | {{context.has_opportunity}} / {{context.opportunity_status}} | Se o contato tem oportunidade no CRM e o status (open/won/lost) | | {{context.completed_flows}} | Fluxos já concluídos pelo contato | | {{context.flow_sent}} | Se este fluxo já foi enviado ao contato | Variáveis do fluxo — {{variables.*}} O grupo mais usado: tudo que o próprio fluxo cria ou recebe vive aqui. - Coleta de dados: cada campo coletado vira {{variables.nome_do_campo}}. - Salvar como variável (saveAsVar) e mapeamentos de resposta do nó Requisição HTTP. - Gatilho Webhook: cada campo do payload recebido vira variável (ex.: um POST com "cpf": "123" vira {{variables.cpf}}). - Gatilho Evento de integração: o evento popula variáveis específicas (veja abaixo). - Fonte de contatos (disparo agendado): cada contato entra no fluxo com as variáveis da fonte. - Nós de integração: cada nó grava suas variáveis de resultado. Por integração (nós, fontes e eventos) Asaas — asaas_cliente_id, asaas_cliente_nome, asaas_cobranca_id, asaas_cobranca_valor, asaas_cobranca_vencimento, asaas_link_pagamento, asaas_boleto_url, asaas_pix_copia_cola, asaas_pendentes_count, asaas_vencidas_count, asaas_total_aberto; fonte de cobranças: asaas_valor, asaas_vencimento, asaas_status, asaas_descricao, asaas_link_boleto. Omie — omie_cliente_id, omie_cliente_nome, omie_cliente_documento, omie_titulo_id, omie_titulo_valor, omie_titulo_vencimento, omie_titulo_status, omie_titulos_count, omie_titulos_resumo, omie_boleto_link, omie_boleto_linha_digitavel. Conta Azul — contaazul_cliente_id, contaazul_cliente_nome, contaazul_cliente_documento, contaazul_conta_valor, contaazul_conta_vencimento, contaazul_conta_situacao, contaazul_contas_count, contaazul_contas_resumo. G-Click — gclick_tarefas_count, gclick_tarefas_resumo, gclick_primeira_tarefa, gclick_tarefa_id, gclick_solicitacao_id, gclick_documentos_enviados. IXC — ixc_cliente_id, ixc_cliente_nome, ixc_cliente_ativo, ixc_fatura_id, ixc_fatura_valor, ixc_fatura_vencimento, ixc_fatura_linha_digitavel, ixc_fatura_pix, ixc_faturas_count, ixc_desbloqueio_ok, ixc_os_id. Sienge — sienge_customer_id, sienge_customer_nome, sienge_bill_id, sienge_bills, sienge_boleto_url, sienge_boleto_linha_digitavel, sienge_overdue_count, sienge_overdue_total. Superlógica Assinaturas — superlogica_customer_id, superlogica_customer_nome, superlogica_charge_id, superlogica_charge_valor, superlogica_charge_vencimento, superlogica_boleto_link, superlogica_inadimplente, superlogica_inadimplencia_total. Superlógica Condomínios — slcond_condominio_nome, slcond_condomino_nome, slcond_unidade_nome, slcond_charge_id, slcond_charge_valor, slcond_charge_vencimento, slcond_boleto_link, slcond_found. Nuvemshop — nuvemshop_cupom_codigo, nuvemshop_cupom_percentual, nuvemshop_cupom_validade (+ variáveis do carrinho na fonte de carrinho abandonado). Magazord — magazord_pedido_codigo, magazord_pedido_situacao, magazord_pedido_total, magazord_pedido_data, magazord_rastreio_codigo, magazord_rastreio_situacao, magazord_frete_valor, magazord_frete_prazo, magazord_frete_transportadora, magazord_frete_opcoes. Loja Integrada — li_cliente_nome, li_pedido_numero, li_pedido_situacao, li_pedido_total, li_pedido_rastreio, li_cupom_codigo, li_cupom_validade. RD Station — rd_nome, rd_email, rd_lead_stage, rd_tags, rd_conversao, rd_opportunity_outcome. CV CRM — cvcrm_idpessoa, cvcrm_person_nome, cvcrm_idlead, cvcrm_lead_criado, cvcrm_interacao_registrada. Feegow (fonte de consultas) — feegow_agendamento_id, feegow_data, feegow_horario, feegow_especialidade, feegow_profissional_nome, feegow_paciente_nome, feegow_valor, feegow_telemedicina. Consultorio.me (fonte de consultas do dia) — consultoriome_consulta_id, consultoriome_data, consultoriome_horario, consultoriome_profissional, consultoriome_paciente_nome, consultoriome_clinica, consultoriome_endereco, consultoriome_link_confirmacao, consultoriome_link_video. SONAX Pabx (evento de ligação) — sonax_numero, sonax_status, sonax_atendida, sonax_atendente, sonax_ramal, sonax_duracao, sonax_data_inicio, sonax_data_fim, sonax_gravacao_url, sonax_id_chamada, sonax_id_fila, sonax_id_campanha, sonax_tabulacao. Crefaz (crédito) — crefaz_proposta_id, crefaz_processo_id, crefaz_status_processamento (nós de proposta); evento Processo concluído (Motor de Crédito) no gatilho "Evento de integração": crefaz_aprovado ("sim"/"nao"), crefaz_proposta_id, crefaz_processo_id, crefaz_status, crefaz_mensagens. Disponível na próxima atualização da plataforma. Google — gcal_event_url, gcal_meet_url (evento criado), sheets_linha (linha lida/gravada). 📘 Cada nó de integração também grava <integração>_erro quando a consulta falha — útil na Condição Avançada para tratar o caminho de erro com mensagem própria. Avançadas | Variável | Conteúdo | |---|---| | {{http_response.NOME.campo}} | Resposta JSON de um nó Requisição HTTP (prefira os mapeamentos de resposta do próprio nó) | | {{nodes.ID_DO_NO.campo}} | Saída de um nó específico (aceita id ou rótulo do nó) | | {{saved_data.chave}} | Dados salvos por nós de captura | Dicas - Teste com dados reais: o painel de Logs mostra as variáveis finais de cada execução — confira o nome exato lá. - Nomes diferenciam apenas o caminho (variables.cpf ≠ variables.CPF dependendo de como foi criado — padronize em minúsculas). - Na Condição Avançada, compare variáveis com operadores como contém, é igual, está vazio — combine com {{context.is_working_hours}} e {{conversation.hours_since_last_contact_message}} para regras de horário e janela de 24h.

Última atualização em Aug 16, 2026