---
title: Erros de sistemas externos
slug: aura/erros-de-sistemas-externos
createdAt: 2026-11-19T14:33:14.520Z
---

**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](https://docs.citsmart.com/aura/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.

:::BlockQuote
**Nota:** Senhas, tokens e chaves nunca aparecem aqui: o valor é substituído por `•••` antes de a linha ser gravada.
:::
