Usando variáveis em fluxos de trabalho

As variáveis são o que torna os fluxos de trabalho do Dailybot dinâmicos em vez de estáticos. Sem variáveis, cada ação de fluxo de trabalho enviaria a mesma mensagem, usaria os mesmos dados e ignoraria o contexto que o acionou. Com variáveis, você pode personalizar mensagens com o nome do respondente, incluir respostas de um check-in, referenciar dados de formulários, inserir carimbos de data/hora e adaptar o conteúdo com base no que realmente aconteceu.

Este artigo cobre como as variáveis funcionam, as categorias disponíveis e padrões práticos para usá-las efetivamente nas suas automações.

Como as variáveis funcionam

Uma variável é um marcador de posição escrito com sintaxe de chaves duplas, como {{user.name}} ou {{response.answer_1}}. Quando o fluxo de trabalho é executado, o Dailybot substitui cada marcador pelo valor real do contexto de execução atual. Se um fluxo de trabalho é acionado por um envio de check-in, por exemplo, as variáveis dão acesso ao nome do respondente, às respostas fornecidas, ao carimbo de data/hora e a outros metadados.

Para inserir uma variável, digite {{ em qualquer campo de texto dentro de uma ação de fluxo de trabalho. O Dailybot exibe uma lista suspensa de todas as variáveis disponíveis, organizadas por categoria. Você pode navegar pela lista ou digitar para buscar a que precisa. Quando seleciona uma variável, ela aparece como marcador de posição no seu texto, e o valor real é preenchido cada vez que o fluxo de trabalho é executado.

Categorias de variáveis

As variáveis são agrupadas pela origem dos seus dados. As categorias disponíveis dependem do tipo de gatilho do seu fluxo de trabalho, porque cada gatilho expõe um conjunto diferente de dados.

Variáveis de usuário

As variáveis de usuário referenciam informações sobre a pessoa que acionou o fluxo de trabalho ou para quem a ação está direcionada. Variáveis de usuário comuns incluem o nome da pessoa, e-mail, participação em equipes e fuso horário. São úteis para personalizar mensagens, como cumprimentar alguém pelo nome ou ajustar o conteúdo com base no seu papel.

Variáveis de resposta

Quando um fluxo de trabalho é acionado pela conclusão de um check-in ou envio de formulário, as variáveis de resposta dão acesso a cada resposta que a pessoa forneceu. Cada pergunta é mapeada para uma variável numerada como {{response.answer_1}}, {{response.answer_2}}, e assim por diante. Você pode usá-las para incluir respostas específicas em mensagens de follow-up, rotear dados para diferentes canais com base no conteúdo, ou passar informações para uma chamada de API.

Variáveis de evento

As variáveis de evento contêm metadados sobre o que acionou o fluxo de trabalho. Isso inclui carimbos de data/hora, tipos de evento e identificadores que ajudam a construir ações contextuais. Por exemplo, você pode incluir a hora de envio em uma notificação para que o destinatário saiba exatamente quando o evento ocorreu.

Variáveis de equipe e organização

Essas variáveis referenciam dados organizacionais mais amplos, como nomes de equipes, identificadores de canais e valores de configuração. São úteis quando você quer publicar em um canal específico dinamicamente ou incluir contexto a nível de equipe em uma mensagem.

Exemplos práticos

Resumos personalizados de check-in

Um fluxo de trabalho acionado por um check-in completado pode enviar um resumo para um canal da equipe usando variáveis. A mensagem pode dizer: “{{user.name}} completou seu standup. Destaques: {{response.answer_1}}. Bloqueadores: {{response.answer_3}}.” Isso transforma dados brutos do check-in em uma atualização formatada e legível sem que ninguém precise compilá-la.

Notificações dinâmicas de formulários

Quando um envio de formulário aciona um fluxo de trabalho, você pode usar variáveis de resposta para construir notificações direcionadas. Se a pergunta 2 pede o nível de prioridade e a resposta é “crítico”, você pode rotear a notificação para um canal de escalação. O corpo da mensagem pode incluir todas as respostas relevantes do formulário para que o destinatário tenha contexto completo sem abrir o app web.

Payloads de API ricos em contexto

Se seu fluxo de trabalho inclui uma ação de chamada de API, as variáveis permitem construir corpos de requisição dinâmicos. Você pode passar o e-mail do remetente, suas respostas e o carimbo de data/hora do evento para um sistema externo, garantindo que a API sempre receba dados atuais e precisos. Isso é particularmente útil para integrar com sistemas de tickets, CRMs ou dashboards personalizados.

Dicas para trabalhar com variáveis

Comece explorando o menu suspenso de variáveis nas ações do seu fluxo de trabalho. Digite {{ e navegue pelas opções disponíveis antes de construir sua mensagem. Isso ajuda a descobrir variáveis que talvez você não conhecesse, especialmente quando trabalha com um tipo de gatilho pela primeira vez.

Mantenha seu uso de variáveis legível. Quando construir um template de mensagem com múltiplas variáveis, rascunhe a saída final no papel primeiro para garantir que leia naturalmente. Uma mensagem lotada de variáveis pode parecer robótica, então misture dados dinâmicos com texto estático que forneça contexto e um toque humano.

Teste seu fluxo de trabalho com um gatilho real para verificar que as variáveis se resolvem corretamente. Algumas variáveis podem ficar vazias se o evento acionador não incluiu aqueles dados, então verifique os casos limite. Você também pode usar texto de fallback nas suas mensagens para lidar com situações onde uma variável pode não ter valor.

As variáveis são a funcionalidade que leva os fluxos de trabalho do Dailybot de sequências simples a automações inteligentes. Ao conectar cada passo aos dados que o acionaram, você cria fluxos de trabalho que são relevantes, personalizados e genuinamente úteis para sua equipe.