Entradas do Workflow
- O que sao entradas de workflow e como funciona a sintaxe de placeholder
{{variable}} - Variaveis de entrada comuns disponiveis para diferentes tipos de trigger
- Como definir entradas personalizadas para workflows manuais
- Como usar entradas dentro das etapas do workflow
Entradas do workflow sao valores dinamicos que transportam dados do evento trigger para as etapas do seu workflow. Elas usam a sintaxe de placeholder {{variable}}, que e substituida por dados reais cada vez que o workflow executa. E isso que torna seus workflows flexiveis -- em vez de codificar valores fixos, voce usa placeholders que se adaptam a cada execucao especifica.
Como a sintaxe de placeholder funciona
Em qualquer lugar que voce possa inserir texto em uma etapa do workflow, voce pode inserir um placeholder envolvendo o nome de uma variavel em chaves duplas. Quando o workflow executa, cada placeholder e substituido pelo valor real do evento trigger ou do contexto do sistema.
Por exemplo, se voce digitar o seguinte em uma etapa de mensagem:
Hello {{client.name}}, your appointment is confirmed for {{event.date}}.
O sistema substitui {{client.name}} pelo nome real do cliente (ex.: "Maria Silva") e {{event.date}} pela data real (ex.: "2025-03-15"), produzindo:
"Hello Maria Silva, your appointment is confirmed for 2025-03-15."
Variaveis de entrada comuns
As variaveis disponiveis para o seu workflow dependem do tipo de trigger e do evento que o disparou. Aqui estao alguns exemplos comuns:
| Variavel | Descricao |
|---|---|
{{client.name}} | O nome do cliente associado ao evento |
{{client.phone}} | O numero de telefone do cliente |
{{client.email}} | O endereco de email do cliente |
{{event.date}} | A data de um evento ou consulta agendada |
{{trigger.channel}} | O canal pelo qual o evento trigger ocorreu (ex.: WhatsApp, web chat) |
{{message.text}} | O conteudo de uma mensagem recebida |
{{employee.name}} | O nome do funcionario associado ao evento |
Os nomes de variaveis usam notacao de ponto para acessar dados aninhados. A parte antes do ponto (ex.: client, event, trigger) indica a fonte de dados, e a parte depois do ponto (ex.: name, date, channel) indica o campo especifico.
Usando entradas nas etapas
Ao configurar qualquer etapa na secao Etapas, simplesmente digite o placeholder {{variable}} diretamente nos campos de texto. O sistema reconhecera o placeholder e o substituira em tempo de execucao. Voce pode combinar texto estatico com multiplos placeholders no mesmo campo:
Dear {{client.name}}, you have an upcoming appointment on {{event.date}}. If you need to reschedule, reply to this message on {{trigger.channel}}.
Entradas personalizadas para workflows manuais
Quando seu workflow usa um trigger manual, voce pode definir campos de entrada personalizados que o funcionario deve preencher antes de executar o workflow. Isso e util quando o workflow precisa de informacoes que nao estao disponiveis de um evento automatico.
Por exemplo, voce pode definir uma entrada personalizada chamada report_date que o funcionario insere ao clicar no botao executeManual. Esse valor fica entao disponivel como um placeholder {{variable}} em todas as etapas do workflow.
Entradas personalizadas tornam os workflows manuais mais versateis, ja que o mesmo workflow pode produzir resultados diferentes dependendo do que o funcionario insere a cada vez.
Sempre envolva referencias {{variable}} em crases ao escrever sobre elas em documentacao ou notas. A sintaxe de chaves duplas e interpretada pelo sistema como um placeholder, entao deixa-la sem escape em contextos de documentacao pode causar erros de analise.