Construtor de fluxo/Ferramentas (Construtor de Fluxos)/Logs de Erros/Categorias de Código de Erro (MMEE)
Categorias de Código de Erro (MMEE)
Os erros que aparecem em Logs de Erros seguem um sistema interno de categorização por código, apelidado de MMEE (agrupamento por Módulo/Motivo do Erro). Cada erro registrado carreg
Nota
⚠️ Nota da equipe de documentação: a tabela abaixo lista as categorias confirmadas até o momento. O conjunto completo de códigos (todas as ~28 categorias internas) precisa ser validado e complementado pelo time de produto/engenharia antes desta página ser considerada uma referência definitiva — o objetivo aqui é registrar a estrutura para que o preenchimento completo seja feito diretamente por quem tem acesso ao código-fonte da categorização.
Estrutura do código
De forma geral, cada categoria de erro está associada a uma área funcional do NicoChat, por exemplo:
Área
Exemplos de erro que caem nela
Envio de mensagem (canal)
falha ao entregar mensagem por limite de janela de 24h, número inválido, canal desconectado
Integrações externas (API/Solicitação Externa)
timeout, erro 4xx/5xx do serviço de terceiros, resposta em formato inesperado
IA (Agentes/Tarefas/Funções de IA)
erro do provedor de IA, limite de tokens excedido, falha de autenticação da chave de API
Comércio eletrônico
falha ao criar/atualizar pedido, produto/variante inexistente, erro de checkout
Webhooks e gatilhos
payload inválido recebido, falha ao processar gatilho configurado
Como usar isso na prática
Ao abrir um erro em Logs de Erros, observe o tipo/código do erro antes de investigar o nó específico — isso ajuda a saber rapidamente se o problema é do lado do NicoChat, de um serviço externo integrado, ou de configuração do próprio fluxo.
Caso encontre um código que não esteja documentado aqui, adicione-o a esta página (ou reporte para quem mantém esta documentação) para irmos completando a tabela ao longo do tempo.