Ativação de usuário
Ativar Usuário
O módulo Ativar Usuário permite que você redirecione um contato — ou um grupo de contatos — para outro fluxo, enviando junto as informações e variáveis que você quiser. É útil para encadear fluxos, disparar fluxos em lote por tag ou variável, e personalizar a jornada do usuário com dados do contexto atual.
📷 Inserir print: visão geral do módulo Ativar Usuário no área de trabalho do fluxo do Builder
Como acessar
No menu lateral, clique em Aplicativo.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse o Builder (editor de diagrama).
No painel de módulos, localize a categoria Gatilho (identificada pela cor roxa).
Arraste o módulo Ativar Usuário para o área de trabalho do fluxo.
📷 Inserir print: painel de módulos com a categoria Gatilho expandida e o módulo Ativar Usuário visível
Conhecendo o módulo
Ao clicar duas vezes no módulo no área de trabalho do fluxo, um painel de configuração será aberto na lateral da tela. As opções estão organizadas em seções descritas abaixo.
📷 Inserir print: painel de configuração do módulo Ativar Usuário aberto
Canal
Aqui você define por qual canal o usuário será ativado.
Por padrão, o módulo exibe um seletor de canal (Canal) com os canais já cadastrados na sua conta. Selecione o canal desejado na lista.
Se quiser informar o canal dinamicamente — usando o valor de uma variável — ative a chave Inserir canal manualmente. Um campo de texto será exibido no lugar do seletor, onde você poderá digitar um valor fixo ou referenciar uma variável do fluxo (ex.: {{flow.channel}}).
Canal (seletor)
Selecione na lista o canal pelo qual o usuário será ativado
Canal (manual)
Digite o identificador do canal ou use uma variável (ex.: {{flow.channel}})
📷 Inserir print: campo Canal com o seletor de canal e a opção de inserção manual ativada
Fluxo de destino
No campo Fluxo, selecione para qual fluxo o usuário será redirecionado. Clique no campo e escolha um fluxo na lista.
Após selecionar, uma mensagem de confirmação aparecerá abaixo do campo informando que o usuário será redirecionado para o fluxo escolhido a partir do nó inicial.
Você também pode criar um novo fluxo diretamente por este campo, sem sair da tela de edição.
📷 Inserir print: campo Fluxo preenchido com a mensagem de confirmação do fluxo selecionado
Enviar para
No campo Enviar para, você define quais usuários serão ativados. Há três opções:
1️⃣ Usuário único
Ativa um único usuário identificado por um ID.
🎯 Propósito Redirecionar apenas um contato específico para o fluxo de destino.
✅ Como fazer na tela Selecione Usuário único no campo Enviar para. O campo ID do usuário será exibido. Digite o identificador do usuário ou referencie uma variável (ex.: {{input.phone}}).
O ID do usuário é o identificador único do contato no canal selecionado. Para WhatsApp, use o número com DDD (ex.: 5511999999999). Para Instagram e outros canais, use o ID exclusivo do usuário naquele canal.
📌 Resultado esperado O usuário informado será redirecionado para o fluxo de destino assim que o módulo for executado.
📷 Inserir print: opção "Usuário único" selecionada com o campo ID do usuário preenchido
2️⃣ Múltiplos usuários
Ativa vários usuários a partir de uma lista (array) armazenada em uma variável do fluxo.
🎯 Propósito Disparar o fluxo de destino para uma lista de contatos de forma automática e em lotes.
✅ Como fazer na tela Selecione Múltiplos usuários no campo Enviar para. Os campos abaixo serão exibidos:
Nome da variável
Variável do fluxo que contém a lista de usuários (ex.: {{user.items}}). Deve ser um array.
Apelido do item
Nome que você dará a cada posição da lista para usá-la nos campos seguintes (ex.: item). Após definir, os dados de cada usuário ficam acessíveis como {{item.nome_do_campo}}.
ID do usuário
ID de cada usuário na lista, usando o apelido definido (ex.: {{item.phone}}).
Tamanho do lote
Quantos usuários serão ativados por vez (máximo: 50).
Intervalo em minutos
Intervalo de tempo entre cada lote (mínimo: 1 minuto, máximo: 60 minutos).
📌 Resultado esperado Os usuários da lista serão ativados em grupos (lotes), respeitando o tamanho e o intervalo configurados.
📷 Inserir print: opção "Múltiplos usuários" selecionada com todos os campos preenchidos
3️⃣ Usuários por tag
Ativa todos os usuários que possuem determinadas tags cadastradas na plataforma.
🎯 Propósito Disparar o fluxo de destino para todos os contatos marcados com uma ou mais tags, sem precisar listar cada um manualmente.
✅ Como fazer na tela Selecione Usuários por tag no campo Enviar para. Os campos abaixo serão exibidos:
Nome da tag
Selecione uma ou mais tags. Todos os usuários com essas tags serão ativados.
Tamanho do lote
Quantos usuários serão ativados por vez (máximo: 50).
Intervalo em minutos
Intervalo de tempo entre cada lote (mínimo: 1, máximo: 60 minutos).
Antes de usar este recurso: as tags precisam estar criadas e atribuídas aos contatos na plataforma. Para gerenciar tags, acesse Contatos no menu lateral. Após configurar as tags, volte a este módulo para concluir a configuração.
📌 Resultado esperado Todos os usuários que possuem as tags selecionadas serão ativados no fluxo de destino, em lotes e no intervalo definido.
📷 Inserir print: opção "Usuários por tag" selecionada com tags escolhidas e campos de lote preenchidos
Permitir envio mesmo com atendente humano
Esta opção é uma chave que vem desativada por padrão.
Quando ativada, o fluxo será disparado para o usuário mesmo que ele esteja em atendimento com um agente humano no momento da ativação.
Quando desativada, o fluxo não será disparado para usuários em atendimento humano ativo.
📷 Inserir print: chave "Permitir envio mesmo com atendente humano" em destaque
Parâmetros
O campo Parâmetros permite enviar informações do fluxo atual para o fluxo de destino. Você escreve os dados no formato JSON e pode referenciar variáveis do fluxo.
Exemplo:
Os valores definidos aqui ficam disponíveis como variáveis dentro do fluxo de destino.
📷 Inserir print: campo Parâmetros com exemplo de JSON preenchido
Continuar automaticamente
No próprio bloco do módulo no área de trabalho do fluxo, você verá a opção Continuar automaticamente.
Quando ativada: o fluxo atual continua para o próximo módulo conectado logo após disparar a ativação.
Quando desativada: o fluxo encerra neste ponto após disparar a ativação.
📷 Inserir print: módulo no área de trabalho do fluxo com a opção "Continuar automaticamente" em destaque
Caso de uso
Cenário: uma loja online quer enviar uma mensagem de recuperação de carrinho para todos os clientes que abandonaram a compra e possuem a tag carrinho-abandonado.
Configuração:
No campo Canal, selecione o canal de WhatsApp da loja.
No campo Fluxo, selecione o fluxo
Recuperação de Carrinho.Em Enviar para, escolha Usuários por tag.
Em Nome da tag, selecione
carrinho-abandonado.Defina Tamanho do lote como
20e Intervalo em minutos como5.No campo Parâmetros, envie o link do carrinho:
{ "link_carrinho": "{{user.cart_url}}" }.Salve o módulo.
Resultado: a cada 5 minutos, 20 clientes com a tag carrinho-abandonado receberão a mensagem de recuperação de carrinho pelo WhatsApp, com o link personalizado do carrinho de cada um.
Dicas úteis
Para WhatsApp, o ID do usuário é o número com código do país e DDD, sem espaços ou caracteres especiais (ex.:
5511999999999).O tamanho máximo de cada lote é 50 usuários. Para listas muito grandes, configure um intervalo adequado para não sobrecarregar o canal.
Use o campo Parâmetros para passar o contexto necessário ao fluxo de destino — assim você evita recoletar informações que já estão disponíveis.
Se o canal for dinâmico (varia por usuário ou contexto), prefira a opção Inserir canal manualmente com uma variável.
Ao usar Múltiplos usuários, defina um apelido claro para o item (ex.:
usuario,contato) para facilitar a leitura dos campos seguintes.
Resumo
O módulo Ativar Usuário redireciona contatos de um fluxo para outro, com suporte a usuário único, lista de usuários ou usuários por tag.
É possível passar parâmetros do fluxo atual para o fluxo de destino usando o campo Parâmetros em formato JSON.
Para ativações em lote, configure o tamanho do lote (máx. 50) e o intervalo em minutos entre cada envio.
A opção Continuar automaticamente define se o fluxo atual prossegue após acionar o módulo.
Tags usadas no modo Usuários por tag precisam estar previamente criadas e atribuídas em Contatos.
Last updated