O que significa tool health

O que é o health check de uma ferramenta

O health check verifica automaticamente se a API configurada em cada Custom Tool está acessível e respondendo corretamente. Isso permite identificar problemas antes que afetem as conversas dos seus clientes.

Status possíveis

Saudável (Healthy)

A API está acessível e respondeu dentro do tempo esperado. A ferramenta está operacional.

Degradado (Degraded)

A API está respondendo, mas com lentidão ou com um código de resposta fora do normal (como 401 ou 403, que indicam autenticação incorreta). O bot pode usar a ferramenta, mas o desempenho pode ser comprometido.

Com falha (Failed)

A API não está respondendo, retornou erro de servidor ou ultrapassou o tempo limite. O bot pode não conseguir usar a ferramenta, o que pode causar handoffs desnecessários.

Não verificado

A ferramenta ainda não teve um health check executado, ou a verificação automática não está configurada.

Como executar o health check manualmente

1. Acesse Custom Tools
2. Clique na ferramenta que deseja verificar
3. Clique em Verificar saúde
4. O sistema testa a conexão e atualiza o status

O que fazer quando o status é "Com falha"

1. Verifique se a API externa está no ar — acesse o endpoint diretamente no navegador ou com uma ferramenta de teste
2. Confira as credenciais — tokens de API expiram; verifique se o header de autenticação ainda é válido
3. Verifique o endpoint — o URL pode ter mudado (versão de API, domínio atualizado)
4. Confira o timeout — se a API for lenta, aumente o timeout configurado na ferramenta
5. Após corrigir, clique em Verificar saúde novamente para confirmar a recuperação

Health check para ferramentas de alto risco

Ferramentas configuradas com nível de risco Alto ou Crítico exigem um endpoint específico de health check configurado separadamente. Isso evita que o sistema execute chamadas com dados reais apenas para verificar a saúde da API.