Erros de sistemas externos
Administração › Erros de sistemas externos mostra as chamadas que a plataforma fez para fora e que falharam: toda chamada HTTP da plataforma (integrações, o botão Testar de conexões e canais, o bloco API do fluxo, o Keycloak, os provedores de canal, a IA, o LiveKit, o download de anexos), o e-mail (envio SMTP e leitura IMAP das caixas), a telefonia (Asterisk) e a ponte de áudio das chamadas. Campo em branco num formulário não é erro de terceiro e não entra aqui.
Na coluna sistema aparece o nome do canal ou serviço quando existe (meta_whatsapp, keycloak, nlu, smtp) e, para o resto, o endereço chamado (api.openai.com). O destino vem sem parâmetros e com trechos longos do caminho resumidos em … — é proposital: ali costumam viajar identificadores e credenciais.
É a tela para responder "por que o robô não abriu o chamado?" sem abrir log de servidor.
Uma linha por erro, não por ocorrência
Quando um sistema cai, ele não falha uma vez: falha em rajada. Por isso a lista agrupa as falhas iguais — mesmo sistema, mesmo destino, mesma resposta, mesma mensagem — e mostra quantas vezes aconteceu, com a primeira e a última ocorrência.
Uma linha dizendo "citsmart · /createTicket · 500 · 1.482 vezes · última há 2 min" conta a história inteira; 1.482 linhas iguais só empurram o resto da tela para baixo.
O que cada coluna diz
- Última — quando aconteceu a vez mais recente (o horário exato aparece ao passar o mouse). É a coluna que separa "está falhando agora" de "falhou hoje de manhã".
- Sistema — quem foi chamado. Vermelho é falha; amarelo é degradação.
- Destino — o método e o endereço/ação chamada.
- Resposta — o código devolvido, ou sem resposta quando não houve resposta nenhuma (servidor fora do ar, endereço errado, tempo esgotado, host recusado por segurança).
- Vezes — quantas ocorrências desta mesma falha na janela.
- Mensagem — o motivo, como o sistema externo o devolveu.
Clique na linha para abrir os detalhes: primeira e última ocorrência, atendimento envolvido e o corpo que o destino devolveu.
Falha e degradação
- Falha: a chamada quebrou o que o usuário pediu. O chamado não abriu, a mensagem não foi entregue, a pessoa não conseguiu entrar.
- Degradação: o caminho alternativo assumiu e a conversa seguiu. A IA de intenção ficou fora do ar e o fluxo seguiu pelo "senão"; o modelo secundário respondeu no lugar do principal. Vale saber que aconteceu, mas ninguém ficou sem resposta.
O filtro nasce em Só falhas porque é o que costuma exigir ação. Troque para Falhas e degradações quando estiver investigando qualidade de atendimento.
A janela é curta — de propósito
A lista guarda as últimas 48 horas. Não é histórico nem relatório: é a tela do diagnóstico de agora. Para investigar algo mais antigo, o registro fica no log do serviço, com a equipe de plataforma.
Quem vê o quê
Quem administra o workspace vê os erros do próprio workspace — a mesma permissão da aba Webhooks. Quem tem papel de plataforma pode trocar o filtro para Todos os workspaces e ver também as falhas que não pertencem a nenhum (login, verificação de provedor), com a coluna do workspace de origem nos detalhes.