Voltar para Central de ajuda
FT-INTEGRATION-LIST-STATES· v1.7.0Integrações

Mapeamentos: o que quer dizer cada estado da lista (Entregando, Recebendo, Exige ação, Falhou, Sem tráfego)

Na lista de integrações da tela Mapeamentos, o estado de cada integração nas últimas 24 horas — e por que "Parada" aqui não é o mesmo que na Visão geral.

Atualizado em 10/10/2026
A tela Mapeamentos (menu Produto › Integrações) é a lista de integrações da empresa. A coluna Estado responde "está entregando?", sempre pelas últimas 24 horas:

EstadoQuando aparece
Entregandoentregou mensagem no destino nas últimas 24 h, sem falha
Exige açãofalta algo seu: disparo agendado sem período definido, ou integração sem nenhum mapeamento (tradução)
Falhoua integração está em erro ou alguma execução falhou nas últimas 24 h; o motivo aparece na mesma linha
Pausadaalguém pausou a integração; vale mais que o último resultado (veja abaixo)
Recebendochegou mensagem nas últimas 24 h, mas nenhuma foi entregue nem falhou: observadas (modo observação) ou ainda em andamento
Sem tráfegonenhuma mensagem nas últimas 24 h: nunca rodou ou só não chegou nada
Arquivadaalguém arquivou: fora de operação, só aparece no filtro Arquivadas (veja o artigo "Arquivar ou excluir uma integração")


Sem tráfego não é erro. Quer dizer que nada passou pela integração nas últimas 24 horas. É o mesmo nome que o semáforo da Visão geral usa para o mesmo caso. A coluna Últimas 24 h conta as mensagens como a Visão geral conta: entregues, observadas (lidas e convertidas no modo observação, sem envio ao destino), em andamento e falhas. Integração que só recebe observadas fica em Recebendo, nunca em Sem tráfego.

Pausada



Pausar é uma decisão sua, então o estado da linha passa a ser Pausada — mesmo que a integração tenha falhado antes da pausa. O último resultado não some: ao lado do estado aparece última execução falhou ou última execução entregou, a coluna Últimas 24 h continua com os números, e o painel da linha mostra a Última falha quando houve.

Pausar e Retomar ficam no menu de ações da linha (ou na barra, com várias linhas marcadas). Depois de confirmar, a linha e os contadores dos filtros mudam na hora — não precisa recarregar a página.

Minha integração está Sem tráfego — o que fazer



  1. Veja a coluna Últimas 24 h: ela confirma que nada chegou nem saiu.
  2. Clique na linha. O painel mostra o disparo, a Próxima execução e as Últimas execuções. Só integração agendada tem próxima execução; manual, webhook e evento mostram Nenhuma agendada. No topo do painel, junto do nome, o botão Abrir a integração leva à tela da integração (testar, mapeamentos, execuções).
  3. Se o disparo é agendado, confira a próxima execução. Se é webhook ou evento, a integração só roda quando o outro sistema manda — sem envio, fica Sem tráfego.
  4. Para rodar agora, use Execuções (quem administra a empresa).


Os filtros



  • Todas — a lista inteira.
  • Ativas — ativas e sem falha.
  • Com erro — as que estão em Falhou. Uma pausada que falhou antes da pausa fica em Pausadas, não aqui.
  • Pausadas — as pausadas por alguém.
  • Arquivadas — as tiradas de operação. Não entram em nenhum outro filtro nem nas contagens.


Exige ação



A linha fica em âmbar quando a integração não consegue rodar sozinha: disparo agendado sem período ("Agendada, sem período definido") ou nenhuma tradução configurada. O painel da linha leva direto para configurar o disparo ou Corrigir a tradução.

Falhou



O motivo real — como o destino respondeu — aparece ao lado do estado, na mesma linha. No painel, Última falha e Ver a mensagem abrem o detalhe para reprocessar.

E na Visão geral?



O semáforo da Visão geral mede mensagens, não execuções: Entregando, Degradada, Parada (chegou mensagem e tudo deu erro), Silenciosa e Sem tráfego. Veja o artigo "Semáforo das integrações, mensagens paradas e envelhecimento".

Agendamento pausado (28/09/2026)



Se a origem recusou a credencial em várias execuções agendadas seguidas e a política da empresa (seção Alertas) ou da integração é pausar, o painel da linha mostra Agendamento pausado, com o motivo e a data. Renovar credencial abre a edição da conexão (salvar a credencial nova ou concluir o Reconectar do OAuth retoma o agendamento); Retomar agendamento tenta de novo sem trocar nada. Nas Últimas execuções do painel, a execução com erro mostra o motivo logo abaixo. Detalhes no artigo "Execuções".

Arquivar falhas já vistas



Quando a integração mostra "Falhou" por mensagens que você já viu e que não têm conserto (por exemplo, registros que não pertencem ao parceiro), abra o painel da integração e use Arquivar falhas já vistas. As mensagens seguem com o erro no Monitor, mas deixam de marcar a integração como "Falhou"; a coluna das últimas 24 h passa a mostrar "N falhas arquivadas". Se uma mensagem for processada de novo e falhar outra vez, ela volta a contar sozinha. Desarquivar falhas devolve todas à contagem.

Histórico de versões

  • v1.7.0

    A lista de integrações e a página da integração não carregam mais as regras de todos os mapeamentos da empresa: a lista só diz se há mapeamento ativo, a prévia do $select do OData é lida quando o modal de edição abre, e a página da integração filtra os mapeamentos no banco. Mapeamento grande não pesa mais a navegação.

    10/10/2026 · updated

  • v1.6.0

    Falhas que o operador já viu podem ser arquivadas pelo painel da integração: seguem com o erro no Monitor, mas deixam de marcar a integração como "Falhou" e aparecem como "N falhas arquivadas" nas últimas 24 h. Nova tentativa da mensagem zera o arquivamento dela.

    10/10/2026 · updated

  • v1.5.0

    A lista de integrações conta o tráfego como o semáforo da Visão geral: toda mensagem das últimas 24 h. Uma entrada em modo observação, que só recebe e converte mensagens sem enviar, deixava de aparecer como "Sem tráfego" e passa a "Recebendo"; a coluna Últimas 24 h mostra as observadas e as ainda em andamento ao lado das entregues e das falhas. "Sem tráfego" fica só para quando nenhuma mensagem chegou nas 24 h.

    03/10/2026 · updated

  • v1.4.0

    Painel da integração: as últimas execuções com erro mostram o motivo (código traduzido + texto), e a integração com agendamento pausado por credencial recusada mostra o aviso com "Renovar credencial" (abre a edição da conexão) e "Retomar agendamento". O mesmo aviso aparece na tela da integração.

    28/09/2026 · updated

  • v1.3.0

    Novo estado "Arquivada" e filtro "Arquivadas" na lista de integrações. Arquivada não entra em Todas, Ativas, Com erro nem Pausadas, nem nos contadores da empresa; o painel dela mostra que está fora de operação e oferece Desarquivar.

    26/09/2026 · updated

  • v1.2.0

    Lista de integrações da empresa (/mapeamentos/empresa/:id e /admin/empresa/:id): estado Pausada vence o último resultado. Uma função só (integrationStateOf em lib/integrations/list-model) deriva o estado a partir do status da integração + últimas 24 h e devolve o último resultado como detalhe ("última execução falhou/entregou"); linha, painel, filtros e o servidor MCP (list_integrations, health = paused) leem dela. Antes, healthOf punha a falha antes da pausa: a integração pausada aparecia "Falhou" e contava em "Com erro". Pausar/Retomar (menu da linha e barra em lote) aplica na lista o status que o servidor confirmou (applyConfirmedStatus), sem esperar o router.refresh() trazer a rota inteira; o status confirmado vale até o próximo carregamento da rota. Painel continua mostrando a Última falha da pausada. Ajuda: artigo integration-template-clone reescrito nos 3 idiomas (credenciais e certificados vão na cópia, nome _clone, mesma empresa e ambiente, tudo ou nada) e lista-integracoes-estados com o estado Pausada.

    25/09/2026 · updated

  • v1.1.0

    Painel da integração: "Abrir a integração" é o botão primário no topo, junto do título (antes era um link sublinhado no rodapé). A rota de detalhe sai de uma fonte só (integrationDetailHref) e o painel do /admin/empresa/[id] ganhou o botão, igual ao da lista da empresa.

    24/09/2026 · updated