Quando a integração para de responder: o histórico de chamadas

Uma consulta do seu sistema para de responder e o efeito na conversa é sempre o mesmo: o agente fica "Processando…", e o cliente espera. O histórico de chamadas é onde isso se lê por inteiro — quando, qual consulta, o que voltou, quanto demorou.

Onde abrir

Em Inteligência › Agentes › aba APIs, o número vermelho ao lado de uma API ou de uma ação abre o histórico já filtrado no que deu errado. Dá para abrir também pela própria ação, no botão do histórico dentro dela.

Cada linha traz a hora, a consulta chamada, o resultado, o tempo e a mensagem inteira do erro, copiável — inclusive o fim da URL com os parâmetros que produziram a falha, que é a parte que costuma explicar tudo.

Quando o seu sistema nem chegou a responder (tempo esgotado, conexão caída), o resultado aparece como Sem resposta. É diferente de "respondeu com erro", e a diferença muda o conserto.

Quanto tempo a plataforma espera

Uma consulta tem até 2 minutos para responder. O teto era de 15 segundos e derrubava relatório grande que o outro lado ainda estava montando: o cliente ouvia "não foi possível consultar" de um sistema que estava de pé, e quem tinha cortado a conexão era a plataforma. Se a sua consulta pesada leva mais que isso, devolva um recorte menor — menos período, menos campos —, ou recorte a resposta no cadastro da ação, como explica Ações da API: endereço, parâmetros, resposta e instruções.

A chamada não é repetida. Quando ela estoura o tempo, a plataforma não tenta de novo: repetir seria pedir o mesmo relatório pesado a um sistema que já estava lento, e triplicar a espera de quem está na conversa. O agente diz que não conseguiu consultar e segue o atendimento — e a falha fica registrada aqui.

Agrupadas, porque a mesma falha se repete

Quando uma integração cai, as falhas são a mesma falha repetida — doze tentativas da mesma consulta, mudando só uma data na URL. Mil linhas iguais não informam mais que uma.

  • Agrupadas (a vista padrão): uma linha por consulta e resultado, com o total ("12×"), a hora da última e a mensagem da ocorrência mais recente. Clique no grupo para abrir as ocorrências.
  • Uma a uma: o fluxo cru, na ordem em que aconteceu.

Os filtros de cima escolhem o período (7 ou 30 dias) e se você quer todas ou só as com erro. O rodapé sempre diz o tamanho real do recorte ("Mostrando 50 de 312") — a lista rola sozinha, mas nunca esconde quanto falta.

Quando o problema aparece sozinho

Se uma consulta passa a não responder — tempo esgotado, conexão caída ou erros seguidos do servidor —, isso vira um cartão em Desempenho, na página do agente. Ele não sugere texto nenhum: endereço fora do ar não se conserta escrevendo instrução, então o cartão leva direto para a consulta.

Tirar do ar enquanto conserta

Enquanto o seu sistema não volta, o caminho é desligar a consulta para o agente parar de tentar. O interruptor Ativa, na ação, e o da API inteira valem na hora — desligar a API desliga junto todas as ações dela.

Limites e regras

  • O histórico guarda os últimos 30 dias.
  • O tempo mostrado é o que a chamada levou até responder (ou até desistir).
  • Desligar a API desliga as ações dela; religar devolve cada uma ao estado em que estava.