Integration timeout
Significado: uma integração não respondeu dentro do prazo.
Como corrigir: valide o serviço externo e ajuste timeout ou retry com segurança.
Solução de problemas
Comece registrando o horário, ambiente, recurso afetado e identificador de execução. Preserve mensagens de erro, mas remova tokens, credenciais e dados pessoais antes de compartilhar evidências.
Processos
O processo não avança
Possíveis causas
- situação de destino incompatível;
- campo obrigatório ausente;
- responsável sem permissão;
- regra associada pausada ou com falha.
Como diagnosticar
Revise o histórico do processo, a configuração da situação e as execuções de regras disparadas no mesmo horário.
Motor de regras
A execução permanece pausada
Identifique o tipo do checkpoint. USER TASK aguarda ação humana; DELAY aguarda o prazo e a retomada pelo scheduler. Para JOIN, confirme se todos os ramos esperados chegaram à barreira.
SUBFLOW não publica
Confirme se a regra filha está publicada, possui gatilho de subfluxo, declara os inputs obrigatórios e termina em ao menos um SUBFLOW_RETURN. Verifique também ciclos entre regras.
Integrações
A chamada excede o timeout
Possíveis causas
- serviço externo lento ou indisponível;
- DNS ou rede sem acesso ao destino;
- timeout abaixo do comportamento normal da API;
- payload grande ou operação síncrona demorada.
Como resolver
Teste a disponibilidade fora do fluxo, ajuste o timeout com limite seguro e use retry somente se a operação puder ser repetida.
Webhooks
Webhook retorna 401
Possíveis causas
- assinatura inválida;
- segredo incorreto;
- corpo transformado antes da validação;
- timestamp fora da janela aceita.
Como resolver
Capture o corpo bruto, confira o algoritmo e valide o relógio do servidor. Faça rotação do segredo se houver suspeita de exposição.
Conectores
Telegram não recebe eventos
O Telegram permite um webhook por bot. Confirme se outra aplicação substituiu o endpoint e reative o trigger com a conexão correta.
API
A API externa retorna 403
Verifique se a chave está ativa, pertence ao tenant esperado e possui acesso ao recurso. Não tente resolver enviando identificadores de outro tenant.
Autenticação
O usuário perdeu acesso
Confirme status do usuário, vínculo com a organização, role, sessão e exigência de MFA. Revogue sessões antigas ao recuperar uma conta.
Catálogo de erros
Invalid webhook signature
Significado: a assinatura calculada não corresponde à entrega.
Como corrigir: confira segredo, corpo bruto, timestamp e algoritmo.
Códigos oficiais
Os componentes já suportam códigos como IBPMS-INTEGRATION-004, mas nenhum código foi inventado nesta versão. Eles serão adicionados quando houver um catálogo canônico no produto.