> 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/ativacao-de-usuario.md). # 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 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. **📷 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}}`). | 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}}`) | **📷 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}}`). {% 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 canal. {% endhint %} 📌 **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: | 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. **📷 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: | 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. **📷 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: ```json { "nome": "{{user.name}}", "pedido": "{{flow.order_id}}" } ``` 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:** 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 por tag**. 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 por tag** precisam estar previamente criadas e atribuídas em **Contatos**. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/gatilho/ativacao-de-usuario.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.