Onde posso monitorar a saúde das ações de integração?

O que a página mostra

Toda tarefa que suas etapas de fluxo e o agente executam nas integrações chega aqui: quantas vezes rodou, quantas falharam e por quê. As ferramentas do agente da loja (busca de produtos, status do pedido…) também são contadas aqui. Se uma conexão cair ou uma etapa parar de funcionar, sua equipe é avisada.

Abra a aba “Estatísticas de ações” na página Integrações. Todo membro pode ver.

Os mesmos dados também aparecem nos cards “O que ele faz” na página do fornecedor e na aba Análise do agente.

Partes da página

• Filtros: o período fica ao lado das abas; o padrão são os últimos 7 dias. O filtro “Integração” fica abaixo dos alertas e não os filtra; “Limpar” o redefine.
• Indicadores: “Com sucesso”, “Com falha”, “Taxa de sucesso” e “Duração média”.
• Gráficos: “Execuções por dia”, “Execuções com falha por dia” e “Por agente” (execuções e taxa de sucesso).
• A tabela “Por ação”: execuções e falhas de cada ação, taxa de sucesso e “Erro mais comum”. Clique em uma linha para abrir a página da integração.
• “Chamadas”: cada execução, uma a uma, da mais recente à mais antiga, filtradas por “Status” e “Origem” (“Etapa do fluxo” ou “Assistente de IA”). Clique em uma linha para ver o erro, a resposta do fornecedor e o status HTTP, o número de tentativas se houve repetição, um link para o registro criado e os campos enviados ao fornecedor. E-mails e números longos ficam ocultos; campos enviados e o texto de erro ficam guardados por 7 dias, e a execução continua na lista. Execuções interrompidas pelo limite por hora também são contadas.

Um resultado salvo retornado ao recarregar a página não é contado; só execuções reais contam.

Alertas

Um alerta abre em três casos:

• Conexão: abre no primeiro erro de autorização. Enquanto isso, as etapas dos seus agentes seguem pelo ramo de erro; é preciso reconectar.
• Fornecedor: abre com base na janela de tempo e no limite da página Ferramentas (por padrão, 5 falhas em 15 minutos).
• Etapa do fluxo: abre quando uma etapa de um fluxo encontra um erro de configuração 3 vezes seguidas. Use “Abrir agente” para verificar as configurações da etapa.

Erros como “Campo obrigatório vazio” e erros de limite são contados, mas não abrem alerta.

Os alertas vão para os canais vinculados à notificação “Falha de etapa de integração” na página “Alertas e notificações”; em um novo espaço de trabalho, proprietários e administradores os recebem por e-mail. Quando tudo volta ao normal, uma mensagem “funcionando de novo” também é enviada.

No catálogo, uma integração com alerta aberto mostra “Precisa de atenção” em vez de “Conectada”. Alertas fechados aparecem em “Histórico de alertas”, logo abaixo dos alertas abertos, como “Recuperado”, “Reconectado” ou “Expirado”. “Expirado” significa que não houve nova falha por 7 dias.

Erros comuns

• “Autorização recusada” / “Reconexão necessária”: remova a conexão e conecte de novo.
• “Limite por hora atingido”: o limite por hora do espaço de trabalho foi atingido. Ele é de 20 para exclusões e cancelamentos e de 100 para envios (como e-mails).
• “Campo obrigatório vazio”: um campo obrigatório da etapa, ou a variável que o preenche, estava vazio.
• “O destino é um valor digitado pelo visitante”: o destino de uma ação irreversível não pode ser a resposta do visitante; escolha o destino na etapa.
• “Nenhum canal selecionado” / “Nenhuma lista selecionada”: escolha o canal ou a lista na etapa.