Use a ferramenta Troubleshoot Workflows para inspecionar as configurações dos gatilhos e entender por que um workflow foi ou não executado para uma conversa ou ticket específico.

Esta ferramenta ajuda você a:

Ver todos os workflows que corresponderam ou não às condições para cada evento de gatilho.
Entender quais condições do workflow foram atendidas.
Depurar o comportamento da automação diretamente do seu workspace.
Entender as razões comuns para falhas em workflows, como configurações incorretas do público ou conflitos de agendamento.
Identificar problemas como incompatibilidades de canal, conflitos de prioridade e limitações de interação do bot que podem impedir os workflows de serem acionados.

Como solucionar problemas de workflows

Você pode solucionar problemas de workflows tanto na seção Workflows quanto diretamente de uma conversa/ticket na Inbox.

A partir dos workflows

Você pode solucionar problemas dos gatilhos de workflow para qualquer conversa ou ticket.

Navegue até Fin AI Agent > Workflows.
Selecione Troubleshoot no topo.
Digite a URL da conversa ou ticket.
Use o menu suspenso Event type para restringir os resultados a gatilhos específicos no início de uma conversa, como "Customer opened a new conversation in the Messenger", ou durante uma conversa, como “Customer sent a message".
Você também pode usar o menu suspenso Status para filtrar workflows que foram:
- Corresponderam e iniciaram
- Corresponderam, mas não iniciaram
- Não corresponderam
Selecione um workflow na linha do tempo dos eventos de gatilho para analisá-lo em mais detalhes.

A partir de uma conversa

Você também pode acessar a ferramenta Troubleshoot Workflows diretamente de uma conversa ou ticket na Inbox.

Abra a conversa ou ticket na Inbox.
Na barra lateral direita, selecione Edit apps e fixe o app Troubleshoot Workflows na sua barra lateral.
Clique em Troubleshoot para visualizar e analisar os workflows disponíveis para esta conversa/ticket.

Nota: Os dados de correspondência são mantidos apenas por 30 dias.

Se a última atividade de uma conversa for mais antiga que 30 dias, nenhum dado de gatilho de workflow estará disponível, e o app na barra lateral será desativado.
Se partes da conversa tiverem menos de 30 dias, apenas esses eventos recentes de gatilho serão exibidos.

Como funciona

A ferramenta Troubleshoot Workflows exibe uma linha do tempo cronológica de todos os eventos de gatilho para uma conversa ou ticket, mostrando:

A ordem em que os eventos ocorreram (seguindo a mesma prioridade da página de visão geral dos Workflows).
Um ✓ tick para workflows acionados e um ✕ cross para workflows que não foram acionados.
Ícones indicando se um workflow é voltado para o cliente ou em segundo plano.

Por exemplo, esta conversa correspondeu e iniciou o workflow “Customer opened a new conversation in the Messenger”. Mas os gatilhos “Customer sent a message” e "Teammate has been unresponsive" não iniciaram um workflow porque as condições de segmentação para esses gatilhos não foram atendidas.

Selecione um evento de gatilho para ver quais workflows corresponderam às condições e foram iniciados na conversa/ticket.

Aqui, você pode inspecionar as configurações do gatilho do workflow configuradas, incluindo:

Regras de público: por exemplo, leads vs. users.
Regras de canal: por exemplo, web, email, WhatsApp, etc.
Regras de agendamento: por exemplo, workflows projetados para operar apenas em dias ou períodos específicos.

Por exemplo, esta conversa foi iniciada por um lead, então o gatilho "Customer sent a message" não correspondeu porque o público estava definido como user.

Para workflows voltados para o cliente, apenas o workflow de mais alta prioridade será iniciado, mesmo que vários correspondam às mesmas condições.

Além disso, um workflow agendado para sábados entre 00:00–08:00 GMT não será acionado para eventos ocorridos fora dessa janela, como às 20:00 GMT em um sábado.

Nota:

Isso mostra apenas as configurações do gatilho (o primeiro bloco do seu workflow) e se corresponderam. Ainda não mostra se o workflow foi concluído ou se cada etapa foi executada com sucesso.
Workflows reutilizáveis não são atualmente suportados pela ferramenta Troubleshoot Workflows e exibirão uma mensagem de erro.
Se existirem regras legadas da Inbox, elas podem interferir nos workflows. Considere migrar as regras da Inbox para garantir uma automação suave.
Para conversas criadas via integração Zapier ou API, os gatilhos de workflow exigem um canal confirmado. Workflows reutilizáveis não validam canais, portanto não serão acionados para essas conversas.
Incluir tanto uma etapa de atribuição quanto uma ação de workflow reutilizável (por exemplo, enviar dados para Salesforce) no mesmo caminho pode impedir que a conversa seja roteada para a inbox pretendida. Para garantir o roteamento correto, use apenas a atribuição no caminho.

Perguntas frequentes

Até que ponto os dados de gatilho de workflow estão disponíveis?

Apenas eventos de gatilho dos últimos 30 dias estão disponíveis. Eventos mais antigos não aparecerão na ferramenta Troubleshoot Workflows.

Posso ver todas as etapas do workflow na ferramenta?

Ainda não. A ferramenta Troubleshoot Workflows atualmente mostra apenas dados das configurações do gatilho, não a execução completa das etapas do workflow.

Por que um workflow corresponde, mas não é executado?

Quando múltiplos workflows voltados para o cliente correspondem às mesmas condições, apenas o workflow de maior prioridade é executado.

Por que workflows não responsivos não são acionados após uma mensagem do bot?

Workflows não responsivos são acionados apenas depois que um colega envia a última mensagem. Se um bot enviar a última mensagem, o temporizador do workflow não será iniciado.

Por que minha conversa não está sendo roteada para a inbox correta?

Incluir tanto uma etapa de atribuição quanto uma ação de workflow reutilizável (por exemplo, enviar dados para Salesforce) no mesmo caminho do workflow pode impedir que a conversa seja roteada para a inbox pretendida.

Para garantir o roteamento correto, use apenas a atribuição no caminho — não a combine com uma ação de workflow reutilizável.

Solucione os gatilhos do seu workflow