Gatilho manual e atalho (botão na conversa/contato)
Inicie um workflow com um clique: o gatilho Atalho roda na caixa de entrada sobre uma conversa, e o Manual é invocado por outra automação ou pela API.
Veja este passo no vídeo · Atalhos para sua equipe na caixa de entrada
Nem toda automação deve disparar sozinha. Às vezes você quer que uma pessoa inicie o processo com um clique sobre uma conversa ou um contato, ou que outra automação o invoque. É para isso que existem os dois gatilhos manuais:
- Atalho (manual a partir da caixa de entrada): um agente o aciona na conversa que está atendendo. O fluxo recebe a conversa e o contato, então pode responder, atribuir, etiquetar, criar uma tarefa e mais. Ótimo para "enviar dados de pagamento", "abrir chamado de garantia" ou "encaminhar ao suporte" em um único clique.
- Manual (invocado por outra automação / API): não aparece na caixa de entrada; é executado pelo botão Testar do editor, pela API ou quando outra automação o chama com um nó Chamar workflow. Funciona como uma sub-rotina reutilizável.
Requisitos
- Disponível em todos os planos (a partir do Lite), com uma cota mensal de execuções de workflows conforme o seu plano.
- Para o atalho, o agente precisa de acesso à Caixa de entrada.
Criar um atalho para a caixa de entrada
- Vá em Configurações → Fluxos de trabalho e clique em Criar workflow.
- Clique em Adicionar gatilho e escolha Atalho (manual a partir da caixa de entrada).
- Dê um nome claro ao workflow (é o que os agentes verão), por exemplo Enviar dados de pagamento.
- Adicione os nós de ação. Você pode usar variáveis do contexto como
{{$contact.name}}e{{$shortcut.triggered_by_name}}(quem acionou o atalho). - Ative o workflow.
- Na Caixa de entrada, abra uma conversa e execute o atalho: o fluxo roda sobre aquele contato na hora.
Criar um workflow manual reutilizável
- Crie um workflow com o gatilho Manual (invocado por outra automação).
- Nos filtros, defina os parâmetros de entrada esperados (por exemplo
order_id = number). - A partir de outro workflow, adicione um nó Chamar workflow e passe esses parâmetros; você os recebe em
{{$caller.input}}. - Para um teste pontual, use o botão Testar ou chame o endpoint da API do workflow.
Verificação
Depois de executar o atalho ou clicar em Testar, abra a aba Execuções do workflow: você verá a origem (qual usuário disparou), a hora e os nós percorridos. Na caixa de entrada, as ações (mensagem enviada, atribuição, etiqueta) aparecem de imediato na conversa.
Se não funcionar
- O atalho não aparece na caixa de entrada: confirme que o gatilho é Atalho (manual a partir da caixa de entrada) e que o workflow está Ativo.
- "Workflow tipo atalho não encontrado ou inativo": o fluxo está desligado ou foi excluído; ative-o novamente.
- O workflow manual não recebe dados: verifique se os nomes dos parâmetros coincidem entre o nó Chamar workflow e o filtro de entrada.
Dica: nomeie os atalhos pela ação que executam ("Enviar dados de pagamento", "Encaminhar ao suporte"). É o texto que sua equipe vê ao escolher.
Dica: combine os dois: um atalho da caixa de entrada pode chamar um workflow manual reutilizável para não duplicar a mesma lógica em vários fluxos.
Artigos relacionados
Artigos relacionados
-
Crie sua primeira automacao (workflow)
Os workflows do Omnifox automatizam sua operacao: um gatilho inicia a automacao e os nos de acao fazem o trabalho. Crie uma mensagem de boas-vindas em minutos.
-
Catálogo de disparadores (triggers) dos workflows
Conheça os eventos que podem iniciar um workflow automaticamente no Omnifox.
-
Guia completo dos fluxos de trabalho (Workflows)
Os Workflows a fundo, em 54 capítulos: gatilhos, nós, variáveis, testes, histórico, modelos, importar e exportar, com cada opção explicada e um fluxo real de ponta a ponta.
-
Nós de ação disponíveis nos workflows
Descubra as ações que um workflow pode executar de forma automática.
-
Condições e ramificações (se/então) em um workflow
Faça seus fluxos tomarem decisões e seguirem caminhos diferentes conforme os dados de cada contato.