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.

Jun 26, 2026

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

  1. Vá em Configurações → Fluxos de trabalho e clique em Criar workflow.
  2. Clique em Adicionar gatilho e escolha Atalho (manual a partir da caixa de entrada).
  3. Dê um nome claro ao workflow (é o que os agentes verão), por exemplo Enviar dados de pagamento.
  4. 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).
  5. Ative o workflow.
  6. 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

  1. Crie um workflow com o gatilho Manual (invocado por outra automação).
  2. Nos filtros, defina os parâmetros de entrada esperados (por exemplo order_id = number).
  3. A partir de outro workflow, adicione um nó Chamar workflow e passe esses parâmetros; você os recebe em {{$caller.input}}.
  4. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp