> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/gatilho/ativar-usuario.md). # 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.

Imagem 1 - Apresentação e busca pelo módulo 'Ativar usuário'.

*** ### Como acessar 1. No menu lateral, clique em **Aplicativo**. 2. Em seguida, clique em **Fluxos**. 3. Abra ou crie um fluxo e acesse o **Builder** (editor de diagrama). 4. No painel de módulos, localize a categoria **Gatilho** (identificada pela cor roxa). 5. Arraste o módulo **Ativar Usuário** para o área de trabalho do fluxo.

Imagem 2 - Busca pelo módulo 'Ativar usuário'

*** ### 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.

Imagem 3 - Dois cliques no módulo 'Ativar usuario'.

*** #### 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}}`). | Campo | O que preencher | | --------------- | ----------------------------------------------------------------------------- | | 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}}`) |

Imagem 4 - Apresentação do campo Canal.

*** #### 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.

Imagem 5 - Apresentação do campo 'Fluxo'

*** #### 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}}`). {% hint style="info" %} 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 Você também pode usar o BSUID do contato no lugar do número — mas ele precisa pertencer ao mesmo Business de onde a mensagem será enviada, senão o envio não funciona.canal. {% endhint %} 📌 **Resultado esperado** O usuário informado será redirecionado para o fluxo de destino assim que o módulo for executado.

Imagem 6 - Opção de 'Enviar para' selecionando 'Usuário único'.

*** **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: | Campo | O que preencher | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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.

Imagem 7 - Opção de 'Enviar para' selecionando 'Múltiplos usuários'.

*** **3️⃣ Usuários tagueados** 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 tagueados**no campo **Enviar para**. Os campos abaixo serão exibidos: | Campo | O que preencher | | -------------------- | ---------------------------------------------------------------------------- | | 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). | {% hint style="warning" %} **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. {% endhint %} 📌 **Resultado esperado** Todos os usuários que possuem as tags selecionadas serão ativados no fluxo de destino, em lotes e no intervalo definido.

Imagem 8 - Opção de 'Enviar para' selecionando 'Usuários tagueados'.

*** #### Permitir envio de mensagem mesmo transbordado 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.

Imagem 9 - Opção de 'Permitir envio de mensagem mesmo transbordado'

*** #### 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: ```json { "nome": "{{user.name}}", "pedido": "{{flow.order_id}}" } ``` Os valores definidos aqui ficam disponíveis como variáveis dentro do fluxo de destino.

Imagem 10 - Parâmetros.

*** #### 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.

Imagem 11 - Opção de 'Continuar automaticamente'.

*** ### 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:** 1. No campo **Canal**, selecione o canal de WhatsApp da loja. 2. No campo **Fluxo**, selecione o fluxo `Recuperação de Carrinho`. 3. Em **Enviar para**, escolha **Usuários tagueados** 4. Em **Nome da tag**, selecione `carrinho-abandonado`. 5. Defina **Tamanho do lote** como `20` e **Intervalo em minutos** como `5`. 6. No campo **Parâmetros**, envie o link do carrinho: `{ "link_carrinho": "{{user.cart_url}}" }`. 7. 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 tagueados** precisam estar previamente criadas e atribuídas em **Contatos**.