385 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha CRM que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| Leads criados pelo Asterisk não aparecem no CRM | Falha na integração ou erro de autenticação na API | Verifique logs do script de integração e permissões do usuário API | Acompanhando o CRM: logs, auditoria e integridade dos regist |
| Alterações em leads não são auditadas | Auditoria não ativada para o campo ou módulo | Habilite auditoria no Studio/Admin do CRM | Acompanhando o CRM: logs, auditoria e integridade dos regist |
| Backup não restaura corretamente | Arquivo corrompido ou restauração em banco incompatível | Teste o backup em ambiente separado e valide a integridade | Acompanhando o CRM: logs, auditoria e integridade dos regist |
| Erro de conexão no EspoCRM durante picos de uso | max_connections do MariaDB insuficiente | Aumente o valor em my.cnf e reinicie o serviço | Ajustando para grandes volumes: tuning de banco e PHP |
| PHP retorna erro de memória esgotada | memory_limit baixo no php.ini | Aumente para 512M ou mais e reinicie o PHP-FPM | Ajustando para grandes volumes: tuning de banco e PHP |
| Consultas lentas mesmo após aumentar RAM | Falta de índices em campos críticos | Analise o slow_query_log e crie índices adequados | Ajustando para grandes volumes: tuning de banco e PHP |
| O CRM ficou mais lento após ativar cache externo | Configuração incorreta do backend ou serviço Redis/Memcached indisponível | Verifique se o serviço está rodando e revise as credenciais e portas no config.php | Ajustando parâmetros de performance e cache em EspoCRM e Sui |
| Erros de memória ao importar dados | memory_limit ou max_execution_time insuficientes no PHP | Aumente os limites no php.ini e reinicie o serviço | Ajustando parâmetros de performance e cache em EspoCRM e Sui |
| Logs ocupando muito espaço em disco | Rotina de rotação ou limpeza automática ausente ou mal configurada | Ajuste maxFiles e maxFileSize ou cron jobs conforme exemplos | Ajustando parâmetros de performance e cache em EspoCRM e Sui |
| Erros 500 ao acessar SuiteCRM | memory_limit ou max_execution_time insuficientes no PHP | Aumente os valores em php.ini e reinicie o serviço | Ajustando PHP, MySQL/MariaDB e sistema operacional para Suit |
| Erros 502/503 no navegador | Limite baixo de MaxRequestWorkers ou worker_connections | Ajuste os parâmetros do Apache/Nginx conforme a RAM disponível | Ajustando PHP, MySQL/MariaDB e sistema operacional para Suit |
| Consultas lentas ou travadas | innodb_buffer_pool_size pequeno demais | Aumente o buffer pool no my.cnf e reinicie o banco | Ajustando PHP, MySQL/MariaDB e sistema operacional para Suit |
| Servidor consumindo toda a RAM e swap | Parâmetros muito altos para o hardware | Reduza limites de processos/conexões ou aumente a RAM | Ajustando PHP, MySQL/MariaDB e sistema operacional para Suit |
| Horários errados nos registros | Timezone do PHP ou do EspoCRM incorreto | Ajuste o date.timezone no php.ini e o timezone padrão no EspoCRM | Ajustes pós-instalação: performance, logs e timezone |
| Logs do EspoCRM vazios | Permissões erradas no data/logs ou nível de log mal configurado | Corrija permissões e revise o nível de log no config.php | Ajustes pós-instalação: performance, logs e timezone |
| Erro ao fazer upload de arquivos | Limites baixos em upload_max_filesize ou post_max_size | Aumente os valores no php.ini e reinicie o PHP | Ajustes pós-instalação: performance, logs e timezone |
| Erros de permissão ao salvar anexos | Diretórios data/, custom/ ou uploads/ sem permissão de escrita | Ajuste permissões com chmod 770 e chown para o usuário do webserver | Ajustes pós-instalação: performance, logs e timezone |
| Erro 401 Unauthorized ao autenticar | Usuário ou senha incorretos, ou API desabilitada | Verifique credenciais e se 'apiDisabled' está false | API REST: autenticação, exemplos e limites |
| Erro 403 Forbidden em endpoints da API | Permissões insuficientes do usuário | Ajuste o perfil do usuário no EspoCRM | API REST: autenticação, exemplos e limites |
| Erro 404 Not Found ao acessar /api/v1/Authentication | API não habilitada ou URL incorreta | Confirme configuração e caminho do endpoint | API REST: autenticação, exemplos e limites |
| O IP virtual não migra após falha do nó ativo. | Constraints de colocation ou ordem mal configuradas. | Revise as constraints com 'pcs constraint' e ajuste conforme necessário. | Asterisk em alta disponibilidade: clustering e failover |
| O serviço Asterisk não inicia no novo nó. | Arquivos de configuração desatualizados ou dependências ausentes. | Sincronize /etc/asterisk/ e verifique dependências com 'systemctl status asterisk'. | Asterisk em alta disponibilidade: clustering e failover |
| Endpoints não conseguem registrar após failover. | Firewall bloqueando portas SIP ou IP virtual não anunciado. | Verifique regras de firewall e se o IP virtual está ativo com 'ip a'. | Asterisk em alta disponibilidade: clustering e failover |
| Erro 500 após atualização | Permissões incorretas nos diretórios cache/ ou data/ | Ajuste permissões: chown -R www-data:www-data /var/www/espocrm | Atualizações seguras e extensões: como não quebrar tudo |
| Extensão não aparece após instalação | Faltou rodar o comando rebuild | Execute: php command.php rebuild | Atualizações seguras e extensões: como não quebrar tudo |
| Integração externa parou de funcionar | Extensão incompatível com nova versão | Remova a extensão e reporte ao desenvolvedor | Atualizações seguras e extensões: como não quebrar tudo |
| Erro 500 após upgrade | Incompatibilidade de dependências ou falha na migração de banco | Verifique logs, compare versões de PHP e extensões, restaure backup se necessário | Atualizações seguras e rollback: como não perder o sono |
| Dados ausentes após rollback | Backup incompleto ou restauração parcial | Refaça o backup/restauração, valide integridade dos arquivos e banco | Atualizações seguras e rollback: como não perder o sono |
| Container não sobe após atualização | Imagem corrompida ou variável de ambiente incompatível | Revise o docker-compose.yml e variáveis, tente baixar a imagem novamente | Atualizações seguras e rollback: como não perder o sono |
| Webhook não chega ao sistema externo | Erro de rede, endpoint incorreto ou bloqueio de firewall | Teste o endpoint manualmente com curl e ajuste regras de firewall | Automação externa: usando a REST API para orquestrar process |
| Token de acesso expira rapidamente | Configuração de expiração curta no OAuth2 | Ajuste o tempo de expiração conforme a documentação | Automação externa: usando a REST API para orquestrar process |
| Dados duplicados em sistemas externos | Repetição de eventos ou falta de controle de idempotência | Implemente registro de eventos processados | Automação externa: usando a REST API para orquestrar process |
| Pipeline falha na etapa de build | Erro no Dockerfile ou dependências faltando | Revise o Dockerfile e instale dependências ausentes | Automatizando deploys com pipelines CI/CD para CRMs |
| Testes automatizados falham | Mudança quebrou funcionalidade existente | Analise logs dos testes e corrija o código | Automatizando deploys com pipelines CI/CD para CRMs |
| Deploy não atualiza o pod | Tag da imagem não foi atualizada ou erro no comando kubectl | Verifique o valor da variável CI_COMMIT_SHA e a sintaxe do comando | Automatizando deploys com pipelines CI/CD para CRMs |
| Rollout do deployment trava | Health checks do pod falham após atualização | Revise readiness/liveness probes e logs do pod | Automatizando deploys com pipelines CI/CD para CRMs |
| E-mails não são enviados | Worker consumidor não está rodando ou falha de autenticação SMTP | Verifique logs do worker e credenciais de e-mail | Automatizando fluxos entre CRMs e ferramentas de colaboração |
| Fila do RabbitMQ crescendo sem parar | Worker lento ou parado | Reinicie o worker e otimize o processamento | Automatizando fluxos entre CRMs e ferramentas de colaboração |
| Alertas constantes no Prometheus | Configuração de thresholds muito baixa ou falhas reais | Ajuste thresholds e investigue falhas | Automatizando fluxos entre CRMs e ferramentas de colaboração |
| Tarefas não são criadas no CRM após chamada. | Webhook não está sendo chamado ou endpoint do CRM está incorreto. | Verifique logs do Asterisk e do servidor web do CRM; teste o endpoint manualmente com curl. | Automatizando tarefas no CRM a partir de eventos do Asterisk |
| Notificações não chegam ao responsável. | Workflow ou configuração de e-mail no CRM está incorreta. | Revise configuração de SMTP e regras de workflow; teste envio manual. | Automatizando tarefas no CRM a partir de eventos do Asterisk |
| Dados inconsistentes (número ou status errado). | Variáveis do dialplan ou payload do webhook mal definidos. | Revise variáveis usadas no script e no dialplan; confira payload recebido pelo CRM. | Automatizando tarefas no CRM a partir de eventos do Asterisk |
| Backup SQL corrompido ou incompleto | Banco estava em uso durante o dump | Pare o servidor web antes do backup e tente novamente | Backup, atualização e versionamento: mantendo SuiteCRM confi |
| SuiteCRM não inicia após atualização | Customizações incompatíveis com nova versão | Restaure backup, revise customizações e consulte notas de versão | Backup, atualização e versionamento: mantendo SuiteCRM confi |
| Arquivos de upload ausentes após restauração | Backup de arquivos incompleto | Inclua toda a pasta de uploads no rsync | Backup, atualização e versionamento: mantendo SuiteCRM confi |
| Backup do banco falha com erro de permissão | Usuário do mysqldump não tem privilégio suficiente | Garanta que o usuário tem permissão de SELECT e LOCK TABLES no banco | Backups automáticos e restore sem downtime |
| Backup ocupa muito espaço rapidamente | Política de retenção não implementada | Adicione find para remover backups antigos automaticamente | Backups automáticos e restore sem downtime |
| Restore do CRM não mostra anexos | Backup dos arquivos de anexos não foi incluído | Confirme o caminho dos anexos na documentação do CRM e inclua no tar | Backups automáticos e restore sem downtime |
| Usuários sendo deslogados aleatoriamente | Sessões PHP não centralizadas ou Redis indisponível | Verifique configuração do session.save_handler e a saúde do Redis | Balanceamento de carga e alta disponibilidade |
| Erro 502 Bad Gateway no acesso ao EspoCRM | Um ou mais servidores web estão fora do ar ou não respondendo ao HAProxy | Cheque status dos servidores web e configuração do backend no HAProxy | Balanceamento de carga e alta disponibilidade |
| Dados recentes não aparecem em todos os servidores | Replicação do banco de dados atrasada ou quebrada | Verifique o lag de replicação e o status dos slaves no MariaDB | Balanceamento de carga e alta disponibilidade |
| Não consigo conectar ao AMI do IP do CRM | IP não está listado em permit ou está bloqueado por denied | Revise as linhas permit e denied no manager.conf | Blindando AMI e SIP: autenticação, ACL e criptografia |
| Ramais SIP não registram | IP do telefone não está em permit ou senha incorreta | Ajuste permit/deny e redefina a senha do ramal | Blindando AMI e SIP: autenticação, ACL e criptografia |
| Tráfego SIP não está criptografado | TLS não está ativado ou certificado inválido | Verifique enabletls e caminhos dos certificados | Blindando AMI e SIP: autenticação, ACL e criptografia |
| Página em branco ao acessar módulo customizado | Erro de sintaxe em arquivo PHP do módulo ou permissão incorreta | Verifique permissões de arquivos e execute 'php -l' para checar sintaxe | Como o SuiteCRM funciona: módulos, banco de dados e fluxo de |
| Lentidão ao listar registros | Falta de índices ou configuração inadequada do PHP-FPM | Otimize índices SQL e ajuste parâmetros de pool no PHP-FPM | Como o SuiteCRM funciona: módulos, banco de dados e fluxo de |
| Erro de conexão com banco | Credenciais incorretas ou banco inacessível | Revise config.php e teste conexão manualmente com o cliente MariaDB | Como o SuiteCRM funciona: módulos, banco de dados e fluxo de |
| Erro 500 ao acessar o EspoCRM | Versão do PHP incompatível ou extensão ausente | Atualize o PHP e habilite as extensões obrigatórias | Componentes do EspoCRM: PHP, MariaDB e REST |
| Não conecta ao banco de dados | Usuário ou senha incorretos, ou MariaDB fora do ar | Revise <code>data/config.php</code> e teste a conexão manualmente | Componentes do EspoCRM: PHP, MariaDB e REST |
| API REST retorna 401 Unauthorized | Token de autenticação ausente ou inválido | Gere um novo token e use no cabeçalho Authorization | Componentes do EspoCRM: PHP, MariaDB e REST |
| Authentication failed ao tentar login | Usuário, senha ou IP incorretos no manager.conf | Verifique se o IP do CRM está listado em 'permit' e se a senha está correta. | Configurando AMI e permissões: abrindo o canal de eventos |
| Consegue conectar mas não recebe eventos | Permissões de 'read' insuficientes | Inclua os privilégios necessários em 'read' para o usuário. | Configurando AMI e permissões: abrindo o canal de eventos |
| Acesso negado para todos os IPs | Ordem dos parâmetros 'deny' e 'permit' invertida | Coloque 'deny' antes de 'permit' no manager.conf. | Configurando AMI e permissões: abrindo o canal de eventos |
| Erro 500 ao acessar o CRM | Permissões incorretas nos arquivos ou extensões PHP ausentes | Revise o Dockerfile para garantir permissões e dependências corretas | Containerizando EspoCRM e SuiteCRM: Dockerfiles e boas práti |
| Variáveis de ambiente não reconhecidas pelo CRM | Variáveis não passadas corretamente no comando docker run ou docker-compose.yml | Confirme o nome e valor das variáveis e revise a configuração | Containerizando EspoCRM e SuiteCRM: Dockerfiles e boas práti |
| Imagem muito grande | Pacotes desnecessários instalados ou ausência de limpeza no build | Remova ferramentas extras e use comandos de limpeza no Dockerfile | Containerizando EspoCRM e SuiteCRM: Dockerfiles e boas práti |
| Alterações não aparecem na tabela de auditoria | Campo não está com auditoria ativada ou permissão de banco insuficiente | Ative 'Audit' no campo via Studio e verifique permissões do usuário no MariaDB | Controle de acesso e auditoria: rastreando quem fez o quê |
| Logs do SuiteCRM não são enviados ao syslog | Configuração incorreta do rsyslog ou caminho do arquivo errado | Revise o arquivo de configuração e reinicie o serviço rsyslog | Controle de acesso e auditoria: rastreando quem fez o quê |
| Arquivo suitecrm.log cresce rapidamente | Nível de log muito alto (DEBUG ou INFO) em ambiente de produção | Reduza o nível de log para ERROR e implemente rotação com logrotate | Controle de acesso e auditoria: rastreando quem fez o quê |
| API retorna 401 | Token ou credenciais inválidas | Reveja autenticação e gere novo token | Corrigindo falhas de integração e automação |
| Workflow não dispara | Scheduler desativado ou condição incorreta | Ative cron.php e revise condições do workflow | Corrigindo falhas de integração e automação |
| Erro 500 em webhook | Exceção não tratada no logic hook | Insira tratamento de exceções e revise logs | Corrigindo falhas de integração e automação |
| Timeout em integração | max_execution_time baixo | Aumente o valor no php.ini | Corrigindo falhas de integração e automação |
| Payload muito grande | Limite de post_max_size ou upload_max_filesize | Ajuste limites no php.ini | Corrigindo falhas de integração e automação |
| Usuário não consegue acessar determinado módulo | Permissão insuficiente no papel ou não pertence à equipe com acesso | Revise o papel e a associação do usuário à equipe | Criando usuários, equipes e papéis de acesso |
| Usuário visualiza registros de outros setores | Permissão excessiva (por exemplo, 'Público' em vez de 'Equipe' ou 'Próprio') | Ajuste as permissões do papel para restringir o acesso | Criando usuários, equipes e papéis de acesso |
| Alterações não aparecem na auditoria | Módulo de auditoria desativado ou permissões de auditoria insuficientes | Ative o módulo de auditoria e revise permissões administrativas | Criando usuários, equipes e papéis de acesso |
| Não consigo encontrar o histórico de um cliente | Dados estão dispersos em vários arquivos | Centralize as informações em um único sistema. | CRM na prática: por que processos comerciais falham sem cont |
| Relatórios apresentam números diferentes para o mesmo período | Planilhas não são atualizadas por todos | Implemente controle centralizado e defina responsáveis. | CRM na prática: por que processos comerciais falham sem cont |
| Clientes reclamam de abordagens repetidas | Falta de visão unificada | Registre todas as interações em um CRM. | CRM na prática: por que processos comerciais falham sem cont |
| Dados de clientes aparecem duplicados | Importação ou registro manual sem validação | Ative validação de duplicidade nas configurações do EspoCRM | CRM: o que é, para que serve e por que não é só cadastro |
| Funil de vendas não reflete o processo real | Estágios padrão não foram adaptados | Personalize os estágios do funil conforme o ciclo da empresa | CRM: o que é, para que serve e por que não é só cadastro |
| Equipe não registra interações | Falta de treinamento ou excesso de campos obrigatórios | Simplifique o formulário e treine o time sobre a importância do registro | CRM: o que é, para que serve e por que não é só cadastro |
| Métricas do CRM não aparecem no Prometheus | Endpoint de métricas não exposto ou scrape_config incorreto | Verifique se o endpoint HTTP está acessível e revise o job_name no Prometheus | CRMs livres e nuvem privada: para onde evolui o estado da ar |
| Pods não conseguem se comunicar | NetworkPolicy bloqueando tráfego necessário | Ajuste as regras de ingress/egress para liberar apenas o necessário | CRMs livres e nuvem privada: para onde evolui o estado da ar |
| Eventos não são consumidos | Broker de mensagens não configurado ou consumidor offline | Confirme conexão do CRM ao broker e que consumidores estão rodando | CRMs livres e nuvem privada: para onde evolui o estado da ar |
| Campo não aparece na tela de edição | Campo não foi adicionado ao layout de edição | Vá ao Studio > Módulo > Layouts > Editar Visualização e adicione o campo. | Customizando módulos, layouts e campos sem programar |
| Campo não salva valor | Nome interno incorreto ou conflito de tipos | Verifique o nome do campo e o tipo escolhido; evite nomes reservados. | Customizando módulos, layouts e campos sem programar |
| Usuário não vê campo novo | Permissão ou visibilidade não configurada | Ajuste a visibilidade do campo para o perfil do usuário no Studio. | Customizando módulos, layouts e campos sem programar |
| Dashboard não mostra dados | Consulta Prometheus incorreta ou exporter não configurado | Revise a consulta e verifique se o endpoint de métricas está acessível | Dashboards e alertas no Grafana: visão operacional em tempo |
| Alertas não disparam | Regra de alerta mal configurada ou sem destinatário | Ajuste a expressão e associe um ponto de contato válido | Dashboards e alertas no Grafana: visão operacional em tempo |
| Notificações não chegam ao Slack | Webhook inválido ou bloqueio de rede | Teste o webhook manualmente e revise regras de firewall | Dashboards e alertas no Grafana: visão operacional em tempo |
| E-mails de alerta não chegam | Configuração SMTP errada ou bloqueio do servidor | Verifique logs do Grafana e ajuste as credenciais SMTP | Dashboards e alertas no Grafana: visão operacional em tempo |
| Chamada não aparece no CRM | Evento AMI não disparado ou falha na API REST | Verifique verbose no Asterisk e teste a API manualmente | Debug ponta a ponta: do SIP ao registro no CRM |
| INVITE SIP não chega ao Asterisk | Firewall ou NAT bloqueando porta 5060 | Reveja regras de firewall e configuração de NAT | Debug ponta a ponta: do SIP ao registro no CRM |
| API do CRM retorna 401 | Autenticação incorreta | Revise credenciais e permissões do usuário na API | Debug ponta a ponta: do SIP ao registro no CRM |
| Evento AMI aparece, mas sem registro no CRM | Payload inválido ou endpoint incorreto | Valide o JSON enviado e o endpoint conforme documentação | Debug ponta a ponta: do SIP ao registro no CRM |
| Logs do Asterisk não mostram nada | Nível de log insuficiente | Ajuste logger.conf para incluir debug e verbose | Debug ponta a ponta: do SIP ao registro no CRM |
| CRM não inicia no pod | Erro de configuração ou variável de ambiente faltando | Verifique logs e ajuste variáveis no deployment | Debugando falhas em containers: logs, exec e tracing |
| Interface web inacessível | Porta não exposta ou falha no serviço | Use port-forward e cheque configuração de portas | Debugando falhas em containers: logs, exec e tracing |
| Requisições lentas | Gargalo em serviço externo ou banco de dados | Analise tracing e monitore dependências | Debugando falhas em containers: logs, exec e tracing |
| Logs não aparecem | Container crashou ou log driver mal configurado | Use --previous e revise configuração do pod | Debugando falhas em containers: logs, exec e tracing |
| Erro 500 ao acessar instalador web | Permissões de arquivos ou extensão PHP faltando | Revise permissões e instale as extensões PHP obrigatórias | Deploy de EspoCRM ou SuiteCRM: requisitos e primeiros acesso |
| API REST retorna 401 Unauthorized | Usuário ou senha incorretos, ou API não habilitada | Confirme credenciais e habilite a API nas configurações | Deploy de EspoCRM ou SuiteCRM: requisitos e primeiros acesso |
| Instalador trava em 'Verificando ambiente' | Extensões PHP ausentes ou diretórios sem permissão de escrita | Instale extensões e ajuste permissões dos diretórios | Deploy de EspoCRM ou SuiteCRM: requisitos e primeiros acesso |
| O CRM fica indisponível após falha de um nó | Provável falta de réplicas suficientes ou configuração incorreta do Service/Ingress | Aumente o número de réplicas e revise as labels dos recursos Kubernetes | Desenhando a arquitetura de EspoCRM e SuiteCRM para alta dis |
| Uploads de arquivos desaparecem após reiniciar pods | Uploads armazenados em volumes efêmeros do container | Monte storage compartilhado (NFS/CephFS) corretamente nos pods | Desenhando a arquitetura de EspoCRM e SuiteCRM para alta dis |
| Backup não pode ser restaurado | Backup corrompido ou incompleto | Automatize testes de restauração em ambiente separado | Desenhando a arquitetura de EspoCRM e SuiteCRM para alta dis |
| Página em branco | Erro fatal de PHP não exibido | Verifique o log do PHP-FPM no caminho correto para sua versão. | Diagnóstico rápido: identificando e isolando problemas |
| Erro 500 ao acessar o EspoCRM | Exceção não tratada ou permissão incorreta em arquivos | Consulte o log do EspoCRM e ajuste permissões. | Diagnóstico rápido: identificando e isolando problemas |
| Lentidão após atualização | Cache antigo ou queries lentas | Limpe o cache do EspoCRM e ative o slow query log no MariaDB. | Diagnóstico rápido: identificando e isolando problemas |
| Usuários não conseguem logar | Falha de autenticação ou banco indisponível | Cheque logs do EspoCRM e conectividade com MariaDB. | Diagnóstico rápido: identificando e isolando problemas |
| Lentidão nas buscas ou geração de relatórios | CPU ou memória insuficiente para o volume de dados e usuários | Aumente recursos conforme o crescimento ou otimize índices no banco de dados | Dimensionando recursos para CRMs: CPU, memória, storage e IO |
| Erros de gravação ou anexos corrompidos | Storage insuficiente ou falha de disco | Expanda o volume de storage e revise políticas de backup | Dimensionando recursos para CRMs: CPU, memória, storage e IO |
| Sessões de usuários caindo em ambiente escalado | Sessões não persistentes entre instâncias | Implemente armazenamento de sessão compartilhado (ex: Redis) | Dimensionando recursos para CRMs: CPU, memória, storage e IO |
| Documentação desatualizada | Falta de revisão periódica | Agendar revisões mensais e cobrar atualização após cada alteração | Documentação viva: como evitar dependência de heróis |
| Equipe não usa o template | Template complexo ou pouco divulgado | Simplificar o template e treinar a equipe | Documentação viva: como evitar dependência de heróis |
| Dificuldade em localizar registros antigos | Ferramenta de documentação inadequada | Migrar para ferramenta com busca eficiente, como DokuWiki ou BookStack | Documentação viva: como evitar dependência de heróis |
| Documentação desatualizada após atualização do CRM | Falta de integração entre fluxo de mudança e documentação | Inclua revisão de documentação como etapa obrigatória de atualização | Documentando ambientes e processos: o que realmente importa |
| Dificuldade em encontrar comandos de rotina | Estrutura de documentação inconsistente | Padronize seções e use índice ou sumário | Documentando ambientes e processos: o que realmente importa |
| Ambiente restaurado com falhas | Passos de restore incompletos ou genéricos | Revise e teste todos os comandos e scripts documentados | Documentando ambientes e processos: o que realmente importa |
| Campo obrigatório não está sendo validado | Campo não foi marcado como obrigatório na definição da entidade | Edite a entidade e marque o campo como obrigatório | Entidades, relacionamentos e campos: modelando sua operação |
| Relacionamento não aparece na interface | Relacionamento não foi adicionado ao layout da entidade | Acesse Administração > Layouts e inclua o relacionamento | Entidades, relacionamentos e campos: modelando sua operação |
| Erro ao salvar entidade customizada | Permissões de escrita insuficientes na pasta custom/ | Ajuste as permissões do diretório conforme a documentação | Entidades, relacionamentos e campos: modelando sua operação |
| Erro HTTP 500 ao acessar o EspoCRM | Permissões incorretas em arquivos ou pastas | Corrija permissões com chown e chmod conforme a documentação | Erros comuns de instalação e atualização: causas e soluções |
| Mensagem 'Cannot connect to database' | Configuração errada de usuário, senha ou nome do banco | Revise config.php e certifique-se de que o usuário tem privilégios | Erros comuns de instalação e atualização: causas e soluções |
| Upgrade trava ou retorna erro | Pulou versões ou não parou o servidor web | Restaure backup, siga a ordem de upgrade e pare o serviço antes | Erros comuns de instalação e atualização: causas e soluções |
| Erro 401 ao conectar ao AMI | Usuário ou senha incorretos, ou IP não permitido | Corrija as credenciais e o campo 'permit' no manager.conf | Erros comuns em AMI e APIs: sintomas e soluções |
| Timeout ao conectar ao AMI | Firewall bloqueando porta 5038 ou rede instável | Libere a porta no firewall e teste a estabilidade da rede | Erros comuns em AMI e APIs: sintomas e soluções |
| Chamadas não aparecem no CRM | Parsing de eventos AMI falhou | Ajuste o parser do CRM ou revise o dialplan do Asterisk | Erros comuns em AMI e APIs: sintomas e soluções |
| Desconexão frequente do AMI | Timeout ou keepalive insuficiente | Ajuste os parâmetros de reconexão e keepalive no CRM | Erros comuns em AMI e APIs: sintomas e soluções |
| Usuário não consegue logar mesmo com senha correta | Sessão PHP inválida ou diretório de sessões sem permissão | Corrija permissões do diretório de sessões e reinicie o servidor web | Erros de login, lentidão e travamentos: diagnóstico rápido |
| Sistema lento para todos os usuários | Consultas SQL demoradas ou falta de índices | Ative slow_query_log, identifique queries lentas e crie índices | Erros de login, lentidão e travamentos: diagnóstico rápido |
| Usuário é desconectado logo após login | Cookie de sessão mal configurado ou expiração prematura | Revise configuração de cookies no php.ini e ajuste tempo de expiração | Erros de login, lentidão e travamentos: diagnóstico rápido |
| Usuário perde sessão ao recarregar | Sessões PHP não estão centralizadas | Configure Redis ou Memcached para sessões compartilhadas | Escalando horizontalmente: múltiplos servidores e replicação |
| Uploads não aparecem em todos os servidores | Diretório upload/ não está sincronizado | Monte via NFS ou sincronize com rsync | Escalando horizontalmente: múltiplos servidores e replicação |
| Replicação MariaDB parou | Erro de permissão ou binlog corrompido | Verifique usuário de replicação e reinicie o slave | Escalando horizontalmente: múltiplos servidores e replicação |
| Consultas continuam lentas após particionamento | Query não está usando a coluna de particionamento ou índice. | Reescreva a query para filtrar pela coluna particionada e revise índices. | Escalando o CRM: particionamento e replicação |
| Slave não replica dados do master | Configuração de server-id ou log-bin incorreta. | Corrija o my.cnf e reinicie o serviço. | Escalando o CRM: particionamento e replicação |
| Cache não acelera consultas | Cache externo não ativado ou mal configurado. | Revise as configurações do cache e reinicie o CRM. | Escalando o CRM: particionamento e replicação |
| PVC não expande após patch | Driver de storage não suporta expansão online | Consulte a documentação do driver e avalie migrar para outro backend | Escalando storage e banco de dados: pitfalls e soluções |
| Lag de replicação alto | Rede lenta ou IOPS insuficiente | Aumente throughput do storage ou otimize queries | Escalando storage e banco de dados: pitfalls e soluções |
| Dados inconsistentes entre master e replica | Replicação assíncrona com lag ou falha de transação | Use replicação semissíncrona ou monitore mais agressivamente | Escalando storage e banco de dados: pitfalls e soluções |
| Upgrade falha e módulos customizados param de funcionar | Mudança de API interna ou incompatibilidade de versão | Revise logs, consulte a documentação do release e ajuste os módulos afetados. | Escolhendo entre EspoCRM e SuiteCRM: critérios técnicos e op |
| Consumo de RAM alto após migração | Configuração padrão inadequada para o volume de dados | Ajuste parâmetros de PHP e cache conforme a documentação. | Escolhendo entre EspoCRM e SuiteCRM: critérios técnicos e op |
| API REST retorna erro 401 | Credenciais ou permissões incorretas | Revise tokens e permissões de usuário na configuração do CRM. | Escolhendo entre EspoCRM e SuiteCRM: critérios técnicos e op |
| Campo calculado não exibe valor | Fórmula incorreta ou campos de origem vazios | Revise a fórmula e garanta que os campos usados tenham valores. | EspoCRM hoje: recursos avançados e novidades recentes |
| Kanban não mostra todos os pipelines | Permissões de visualização limitadas | Ajuste as permissões do perfil do usuário. | EspoCRM hoje: recursos avançados e novidades recentes |
| Integração IMAP falha | Credenciais ou porta incorretas | Verifique host, porta e usuário na configuração de e-mail. | EspoCRM hoje: recursos avançados e novidades recentes |
| Erro 'Could not connect to database' | Credenciais ou host do banco incorretos | Revise data/config.php e teste acesso manual ao MariaDB | EspoCRM: fundamentos, licença AGPL e comunidade |
| Permissões negadas ao salvar arquivos | Permissões de pasta incorretas | Execute 'chown -R www-data:www-data EspoCRM' | EspoCRM: fundamentos, licença AGPL e comunidade |
| Página em branco após login | Extensão PHP faltando (ex: mbstring) | Instale a extensão e reinicie o webserver | EspoCRM: fundamentos, licença AGPL e comunidade |
| Usuários são desconectados aleatoriamente | Sessões ainda estão em disco local ou configuração de sticky session ausente | Configure sessões em Redis/Memcached e ajuste o balanceador para sticky session | Estratégias para ambientes multiusuário e alta demanda |
| Relatórios travam o sistema em horário de pico | Execução síncrona de consultas pesadas | Agende relatórios para horários de menor uso ou otimize queries | Estratégias para ambientes multiusuário e alta demanda |
| Lentidão ao salvar registros | Concorrência de gravação em banco ou locks de sessão | Revise armazenamento de sessão e monitore locks no banco | Estratégias para ambientes multiusuário e alta demanda |
| Workflows não executam para todos os registros | Limite de execução do cron ou sobrecarga | Divida workflows em lotes menores e monitore logs | Estratégias para ambientes multiusuário e alta demanda |
| Prometheus mostra job DOWN | Porta ou endpoint incorreto, exporter não rodando | Verifique se o exporter está ativo e a porta está correta | Expondo métricas dos CRMs: exporters, endpoints e custom met |
| Métricas vazias no exporter customizado | Erro de autenticação na API do CRM | Revise token ou credenciais usadas pelo script | Expondo métricas dos CRMs: exporters, endpoints e custom met |
| Exporter retorna 403 Forbidden | Restrição de acesso no Apache ou PHP-FPM | Ajuste as regras de acesso para permitir localhost | Expondo métricas dos CRMs: exporters, endpoints e custom met |
| Métricas de jobs sempre zero | Consulta SQL errada ou tabela diferente | Verifique o nome da tabela e o status dos jobs | Expondo métricas dos CRMs: exporters, endpoints e custom met |
| Dados não aparecem após cadastro | Falha na query SQL ou erro de validação | Verifique logs do EspoCRM e do MariaDB para mensagens de erro | Fluxo de dados: do usuário ao banco e de volta |
| Lentidão ao acessar listas | Queries complexas ou falta de índices no banco | Ative o slow_query_log e otimize as queries identificadas | Fluxo de dados: do usuário ao banco e de volta |
| Notificações não são enviadas | Job de background não executado | Execute manualmente o comando cron e revise logs | Fluxo de dados: do usuário ao banco e de volta |
| Lead não aparece no CRM | Falha na comunicação entre middleware e CRM ou erro de autenticação. | Verifique logs do middleware, status da API do CRM e credenciais. | Fluxos de dados: do ramal SIP ao lead no CRM |
| Leads duplicados para a mesma chamada | Falta de deduplicação baseada no Uniqueid. | Implemente controle de Uniqueid no middleware. | Fluxos de dados: do ramal SIP ao lead no CRM |
| Eventos não capturados pelo middleware | Permissões insuficientes no AMI ou filtro de eventos incorreto. | Revise permissões do usuário AMI e lógica de captura de eventos. | Fluxos de dados: do ramal SIP ao lead no CRM |
| Taxas de conversão não batem com a realidade | Leads ou oportunidades não estão sendo atualizados corretamente | Treine a equipe para registrar cada avanço de estágio sem atrasos | Funil de vendas em ação: métricas que mudam decisões |
| Relatórios mostram valores zerados | Campos obrigatórios não estão preenchidos nas oportunidades | Configure campos obrigatórios e revise o preenchimento | Funil de vendas em ação: métricas que mudam decisões |
| A automação não dispara alertas para leads parados | Condição de tempo ou campo configurada incorretamente | Revise a lógica da automação e teste com dados de exemplo | Funil de vendas em ação: métricas que mudam decisões |
| Usuário não consegue acessar um módulo que deveria | Permissão insuficiente no papel ou não está associado ao papel correto | Revise as permissões do papel e a associação do usuário | Gerenciamento de usuários, equipes e permissões |
| Usuário consegue ver dados de outras equipes | Permissão do papel está como 'Todos' em vez de 'Equipe' ou 'Próprio' | Ajuste as permissões do papel para restringir o acesso | Gerenciamento de usuários, equipes e permissões |
| Senha fraca aceita pelo sistema | Política de senha não está configurada corretamente | Revise as configurações em Administração > Configurações de Senha | Gerenciamento de usuários, equipes e permissões |
| Alterações não aparecem no log | Auditoria não ativada para o módulo | Ative auditoria no módulo desejado em Administração > Configuração do Sistema > Auditoria | Gerenciamento de usuários, equipes e permissões |
| Scheduled Job não executa a exclusão | Sintaxe incorreta ou permissões insuficientes | Revise a configuração do job e permissões do usuário | Governança de dados: limpeza, revisão e ciclo de vida |
| Auditoria não registra alterações | Audit não habilitado para a entidade | Ative a opção 'Audit Enabled' na entidade desejada | Governança de dados: limpeza, revisão e ciclo de vida |
| Sistema lento após anos de uso | Acúmulo de dados antigos e logs desnecessários | Implemente políticas de retenção e revise jobs de limpeza | Governança de dados: limpeza, revisão e ciclo de vida |
| Gravações não estão sendo excluídas | Permissões de arquivo ou erro no cron | Verifique permissões e logs do cron (/var/log/cron). | Governança de dados: privacidade, LGPD e retenção |
| CDRs não estão anonimizados | Script awk não está rodando ou campo errado | Revise o comando e o formato do CSV. | Governança de dados: privacidade, LGPD e retenção |
| Logs de auditoria não são criados | logger.conf mal configurado ou falta de permissão | Ajuste logger.conf e permissões do diretório de logs. | Governança de dados: privacidade, LGPD e retenção |
| Usuário recebe erro 'forbidden' ao acessar o CRM | Role ou RoleBinding mal configurado | Revise as regras e namespaces nos manifests YAML | Hardening de containers e clusters: limites, RBAC e segredos |
| Secret aparece em texto claro no etcd | Criptografia em repouso não ativada | Configure encryption at rest conforme documentação do Kubernetes | Hardening de containers e clusters: limites, RBAC e segredos |
| Container consome toda a CPU do nó | Limites de recursos ausentes ou mal definidos | Adicione ou ajuste 'resources.limits' no spec do container | Hardening de containers e clusters: limites, RBAC e segredos |
| SuiteCRM não salva arquivos em upload | Permissões insuficientes nos diretórios 'upload' ou 'cache' | Ajuste permissões para 775 e usuário correto | Hardening: protegendo SuiteCRM, banco e servidor Linux |
| Erro 403 ao acessar a aplicação | Regra de bloqueio de arquivos aplicada de forma ampla | Revise <FilesMatch> ou 'location' para não bloquear arquivos públicos | Hardening: protegendo SuiteCRM, banco e servidor Linux |
| Banco de dados inacessível após hardening | bind-address restrito e aplicação tentando conectar via IP externo | Configure SuiteCRM para usar 'localhost' no banco | Hardening: protegendo SuiteCRM, banco e servidor Linux |
| Atualização do sistema quebra dependências do SuiteCRM | Atualização de PHP ou MariaDB sem checar compatibilidade | Consulte a documentação antes de atualizar componentes críticos | Hardening: protegendo SuiteCRM, banco e servidor Linux |
| O HPA não escala os pods mesmo sob carga. | Metrics Server ausente ou sem permissão, ou requests/limits não definidos. | Verifique se o Metrics Server está instalado e se os pods têm requests/limits configurados. | Horizontal Pod Autoscaling: limites e tuning para CRMs |
| Pods escalam, mas usuários perdem sessão ao trocar de pod. | Sessões armazenadas localmente em vez de store externo. | Configure session store externo como Redis ou Memcached. | Horizontal Pod Autoscaling: limites e tuning para CRMs |
| Pods sobem, mas não atendem requisições imediatamente. | Readiness probe mal configurada ou tempo de inicialização alto. | Ajuste a readiness probe e otimize o tempo de startup do CRM. | Horizontal Pod Autoscaling: limites e tuning para CRMs |
| Campos customizados não aparecem nos módulos | Cache do SuiteCRM não foi limpo após customização | Acesse Admin > Reparar > Reparar e Reconstruir | Implantação do SuiteCRM em equipe comercial de telecom |
| Workflows não disparam notificações | Condições do workflow estão incorretas ou cron não está ativo | Verifique as condições e o agendamento do cron em seu servidor | Implantação do SuiteCRM em equipe comercial de telecom |
| Integração com ERP falha | Endpoint ou payload incompatível | Valide o formato JSON e revise a documentação da API | Implantação do SuiteCRM em equipe comercial de telecom |
| API REST retorna erro 401 | Token de autenticação expirado ou inválido | Solicite novo token conforme documentação oficial | Implantação do SuiteCRM em equipe comercial de telecom |
| Usuários não acessam o CRM | Falta de treinamento ou resistência à mudança | Refaça sessões de treinamento e ajuste permissões para aumentar a confiança | Implantação em equipe comercial: desafios e soluções |
| Dados importados aparecem incompletos | Mapeamento incorreto de campos durante a importação | Revise o arquivo CSV e o mapeamento antes de importar novamente | Implantação em equipe comercial: desafios e soluções |
| Integração via API falha | Chave de API inválida ou endpoint incorreto | Verifique a documentação da API e gere uma nova chave se necessário | Implantação em equipe comercial: desafios e soluções |
| Buscas lentas mesmo após ajuste de índices | Query mal escrita ou falta de cache | Revise a query e implemente cache de resultados | Implantando CRMs em ambientes críticos: aprendizados e falha |
| Jobs agendados não executam | Cron desativado ou worker travado | Reinicie o serviço cron e monitore logs | Implantando CRMs em ambientes críticos: aprendizados e falha |
| Atualização do CRM quebra customizações | Extensões fora do padrão | Refatore para seguir os padrões da documentação | Implantando CRMs em ambientes críticos: aprendizados e falha |
| Pod reiniciando em loop | Falha na liveness probe ou volume não montado | Revise o path do volume e aumente initialDelaySeconds da probe | Implantando em Kubernetes: manifestos, volumes e readiness p |
| Dados do CRM sumiram após reinício | PVC não configurado ou storage efêmero | Garanta que o PVC está 'Bound' e montado no caminho correto | Implantando em Kubernetes: manifestos, volumes e readiness p |
| Probes falham logo após subir o pod | Tempo de inicialização do CRM subestimado | Ajuste initialDelaySeconds para maior valor | Implantando em Kubernetes: manifestos, volumes e readiness p |
| Chamadas caindo ou com áudio picotado | CPU saturada ou latência de rede alta | Aumente CPU/RAM ou otimize rede, reduza codecs pesados | Infraestrutura: sizing de servidores para Asterisk e CRM |
| Integração com CRM lenta | Falta de RAM ou disco lento no CRM | Aumente RAM, migre para SSD, otimize queries | Infraestrutura: sizing de servidores para Asterisk e CRM |
| Gravações corrompidas ou incompletas | Disco cheio ou IO saturado | Amplie armazenamento, use discos mais rápidos | Infraestrutura: sizing de servidores para Asterisk e CRM |
| Serviços caindo juntos | Falta de isolamento entre Asterisk e CRM | Separe ambientes, use VMs ou servidores distintos | Infraestrutura: sizing de servidores para Asterisk e CRM |
| Erro 500 ao acessar o instalador | Permissões incorretas ou módulo PHP faltando | Revise permissões e instale módulos PHP obrigatórios. | Instalação do EspoCRM: passo a passo em ambiente Linux |
| Instalador não conecta ao banco de dados | Usuário, senha ou host incorretos | Revise as credenciais e permissões do usuário MySQL/MariaDB. | Instalação do EspoCRM: passo a passo em ambiente Linux |
| Aviso de diretório não gravável | Permissões insuficientes no diretório data/ | Ajuste permissões com chown e chmod para o usuário do Apache. | Instalação do EspoCRM: passo a passo em ambiente Linux |
| Erro 500 ao acessar o instalador web | Permissões de arquivos incorretas ou módulos PHP ausentes. | Verifique permissões e instale todas as extensões PHP obrigatórias. | Instalação do SuiteCRM em Linux: passo a passo sem atalhos |
| Falha ao conectar ao banco de dados | Usuário, senha ou nome do banco errados; banco não criado. | Revise as credenciais e confirme a existência do banco e usuário no MariaDB. | Instalação do SuiteCRM em Linux: passo a passo sem atalhos |
| Instalador não aparece, página em branco | Erro de PHP oculto, logs não exibidos. | Cheque o log do Apache em /var/log/apache2/error.log e corrija os erros listados. | Instalação do SuiteCRM em Linux: passo a passo sem atalhos |
| Ramal SIP não registra | Usuário, senha ou IP incorretos; firewall bloqueando porta 5060 UDP. | Verifique credenciais, IP do servidor e libere porta no firewall. | Instalando Asterisk em Linux: do repositório ao primeiro ram |
| Chamada entre ramais não completa | Dialplan incorreto ou endpoint não registrado. | Revise o contexto no extensions.conf e o status dos endpoints. | Instalando Asterisk em Linux: do repositório ao primeiro ram |
| Sem áudio na chamada | Codecs incompatíveis ou NAT mal configurado. | Ajuste codecs permitidos e revise configuração de NAT. | Instalando Asterisk em Linux: do repositório ao primeiro ram |
| Prometheus não coleta métricas do SuiteCRM | Endpoint inacessível ou erro no script PHP | Verifique logs do Prometheus e acesse o endpoint manualmente para identificar erros | Integração com Prometheus e Grafana para visualização em tem |
| Valores das métricas não atualizam | Script PHP com cache excessivo ou queries estáticas | Ajuste o script para coletar dados dinâmicos a cada requisição | Integração com Prometheus e Grafana para visualização em tem |
| Grafana mostra erro de datasource | Configuração incorreta da fonte de dados Prometheus | Revise a URL da fonte de dados e teste a conexão no Grafana | Integração com Prometheus e Grafana para visualização em tem |
| Erro de autenticação IMAP/SMTP | Senha incorreta ou falta de senha de aplicativo | Gere senha de app no provedor e atualize no EspoCRM | Integração de e-mail: recebendo e enviando pelo CRM |
| E-mails não sincronizam | Intervalo de sincronização muito alto ou conexão bloqueada | Reduza o intervalo e verifique firewall/antivírus | Integração de e-mail: recebendo e enviando pelo CRM |
| E-mails não vinculam a entidades | E-mail do remetente/destinatário não cadastrado em nenhuma entidade | Cadastre o e-mail nas entidades correspondentes | Integração de e-mail: recebendo e enviando pelo CRM |
| Pop-up do CRM demora ou não aparece | Fila de eventos sobrecarregada ou script de integração lento | Otimize o script e aumente a capacidade da fila intermediária | Integração em call center de médio porte: desafios e soluçõe |
| Chamadas não registradas no CRM | Falha de autenticação na API ou perda de eventos no AMI | Revise permissões, tokens e monitore logs do Asterisk | Integração em call center de médio porte: desafios e soluçõe |
| Agente incorreto associado à chamada | Configuração errada do parâmetro membername na fila | Ajuste o membername para refletir o usuário correto | Integração em call center de médio porte: desafios e soluçõe |
| Eventos AMI não chegam ao CRM | Firewall bloqueando porta 5038 ou erro de autenticação | Verifique regras de firewall e credenciais no manager.conf | Integração em rede de fibra dedicada: aprendizados e ajustes |
| Latência alta mesmo em fibra | QoS não configurado ou congestionamento em switches | Ajuste DSCP e revise configuração dos switches | Integração em rede de fibra dedicada: aprendizados e ajustes |
| CRM trava ao receber muitos eventos | Processamento síncrono ou falta de fila/buffer | Implemente processamento assíncrono via fila (RabbitMQ, Redis) | Integração em rede de fibra dedicada: aprendizados e ajustes |
| Erro 401 ao autenticar | client_id ou client_secret incorretos, ou grant_type inválido | Revise as credenciais e o tipo de grant; use client_credentials. | Integração via REST API: exemplos práticos com PHP e cURL |
| Erro 422 ao criar contato | Payload com campo inválido ou relacionamento malformado | Use o relacionamento email_addresses corretamente, conforme exemplo. | Integração via REST API: exemplos práticos com PHP e cURL |
| Resposta vazia na listagem | Filtro muito restritivo ou token expirado | Altere o filtro ou renove o token. | Integração via REST API: exemplos práticos com PHP e cURL |
| Erro 404 ao acessar endpoint | URL incorreta ou módulo não habilitado | Verifique o nome do módulo e a rota. | Integração via REST API: exemplos práticos com PHP e cURL |
| Registro de chamada não aparece no CRM | API do CRM não configurada corretamente ou endpoint incorreto | Revise a URL e as credenciais da API na integração | Levantamento de requisitos: do atendimento ao registro autom |
| Áudio da ligação não está acessível | Permissões de arquivo ou caminho incorreto no Asterisk | Verifique permissões e paths nas configurações | Levantamento de requisitos: do atendimento ao registro autom |
| Dados sensíveis visíveis para todos | Perfis de acesso mal configurados no CRM | Ajuste as permissões de usuário conforme documentação do CRM | Levantamento de requisitos: do atendimento ao registro autom |
| Usuários acessam dados que não deveriam | Permissões mal configuradas | Revise roles e grupos no CRM | Levantando requisitos: do compliance ao desempenho real |
| Logs não registram consentimento | Nível de log insuficiente ou configuração ausente | Ajuste nível para DEBUG e revise scripts de consentimento | Levantando requisitos: do compliance ao desempenho real |
| APIs retornam erro 401 | Token inválido ou endpoint incorreto | Gere novo token e valide endpoint na documentação | Levantando requisitos: do compliance ao desempenho real |
| Eventos não aparecem no log | Script não está conectado ao AMI ou permissões incorretas | Revise manager.conf e teste conexão manualmente | Ligando Asterisk ao CRM: scripts de integração usando AMI e |
| Erro 401 ao enviar para o CRM | Token de autenticação expirado ou inválido | Renove o token e atualize o script | Ligando Asterisk ao CRM: scripts de integração usando AMI e |
| Chamadas duplicadas no CRM | Script processando o mesmo evento mais de uma vez | Implemente controle de idempotência no script | Ligando Asterisk ao CRM: scripts de integração usando AMI e |
| Log do EspoCRM não é atualizado | Permissões incorretas no diretório de logs | Ajuste permissões com chown e chmod para o usuário do servidor web | Logs, métricas e alertas: o que monitorar no EspoCRM |
| Alertas não são disparados | Configuração incorreta do agente de monitoramento | Revise o caminho dos logs e parâmetros do agente | Logs, métricas e alertas: o que monitorar no EspoCRM |
| Métricas de CPU/RAM não batem com o uso real | Ferramenta de monitoramento desatualizada ou incompatível | Atualize ou troque a ferramenta de coleta | Logs, métricas e alertas: o que monitorar no EspoCRM |
| Chamadas não registram no CRM após atualização | Mudança na API ou permissão insuficiente | Revise documentação da API e ajuste scripts de integração | Manutenção preventiva: atualizações e testes regulares |
| Asterisk não inicia após upgrade | Incompatibilidade de módulo ou configuração antiga | Restaure backup da configuração e revise módulos instalados | Manutenção preventiva: atualizações e testes regulares |
| Erros de autenticação em testes automatizados | Credenciais expiradas ou alteradas | Atualize credenciais nos scripts de teste | Manutenção preventiva: atualizações e testes regulares |
| Campo customizado não aparece no formulário | Layout EditView não foi atualizado | Acesse Studio > [Módulo] > Layouts > EditView e adicione o campo | Mapeamento de processos comerciais para módulos do SuiteCRM |
| Não é possível converter Lead em Oportunidade | Campos obrigatórios não preenchidos ou configuração de conversão incompleta | Revise os campos obrigatórios e as configurações de conversão no Studio | Mapeamento de processos comerciais para módulos do SuiteCRM |
| Campos customizados não aparecem nos relatórios | Campo não incluído no módulo de Relatórios | Inclua o campo no módulo de Relatórios via Studio | Mapeamento de processos comerciais para módulos do SuiteCRM |
| Leads ou oportunidades sem etapa definida | Campos obrigatórios não configurados ou usuários pulando etapas | Torne o campo 'etapa' obrigatório em Administração > Layout | Mapeando processos: funil de vendas, leads e oportunidades |
| Relatórios mostram dados inconsistentes | Critérios de passagem subjetivos ou campos não preenchidos | Reforce critérios e revise campos obrigatórios | Mapeando processos: funil de vendas, leads e oportunidades |
| Conversão de lead não cria oportunidade | Workflow de conversão não configurado corretamente | Revise as regras de conversão em Administração > Entidades > Lead | Mapeando processos: funil de vendas, leads e oportunidades |
| Eventos não aparecem no dashboard | Coletor não está conectado ao AMI ou permissões insuficientes | Revise as credenciais e logs do coletor; teste conexão manualmente. | Monitorando eventos AMI: métricas, alertas e dashboards |
| Alertas não disparam | Regra de alerta mal configurada ou métrica não está sendo coletada | Ajuste o limiar do alerta e revise o pipeline de métricas. | Monitorando eventos AMI: métricas, alertas e dashboards |
| Latência alta nos eventos | Sobrecarga no servidor ou rede lenta | Monitore recursos do servidor e otimize consultas do coletor. | Monitorando eventos AMI: métricas, alertas e dashboards |
| suitecrm.log não é atualizado | Permissões incorretas no arquivo ou diretório | Ajuste com chmod e chown para o usuário do webserver | Monitorando SuiteCRM: logs, métricas e alertas essenciais |
| Alertas de disco cheio não disparam | Script de alerta não está agendado ou falta utilitário mail | Verifique o cron e instale mailutils | Monitorando SuiteCRM: logs, métricas e alertas essenciais |
| Logs mostram muitos erros de conexão ao banco | Banco de dados sobrecarregado ou credenciais incorretas | Revise configurações e monitore o MariaDB | Monitorando SuiteCRM: logs, métricas e alertas essenciais |
| Erro 500 após atualização | Permissões de arquivos incorretas | Ajuste permissões conforme comandos recomendados | Novidades do SuiteCRM: recursos recentes e roadmap oficial |
| Módulo customizado não aparece | Incompatibilidade com nova versão | Revise o código do módulo e consulte a documentação de migração | Novidades do SuiteCRM: recursos recentes e roadmap oficial |
| Integração externa falha | API REST depreciada | Atualize scripts para usar endpoints e autenticação da API REST v8 | Novidades do SuiteCRM: recursos recentes e roadmap oficial |
| API REST do CRM retorna 401 Unauthorized | Token de autenticação inválido ou expirado | Renove o token e revise o fluxo de autenticação conforme documentação oficial | Novidades no Asterisk e CRMs livres: roadmap e comunidade |
| Asterisk não registra chamadas no CRM | Permissões insuficientes na AMI ou erro no endpoint REST | Revise permissões do usuário AMI e valide a chamada REST com curl | Novidades no Asterisk e CRMs livres: roadmap e comunidade |
| Alto tempo de resposta nas integrações | API do CRM lenta ou rede congestionada | Monitore latência, otimize queries e teste em rede dedicada | Novidades no Asterisk e CRMs livres: roadmap e comunidade |
| Dados desaparecem após reinício do container | Volumes persistentes não foram configurados corretamente | Revise o mapeamento de volumes no Docker Compose ou PersistentVolumeClaim no Kubernetes | Nuvem privada, containers e orquestração: o que muda no jogo |
| Upgrade corrompe o CRM | Imagem não compatível ou scripts de migração falharam | Faça rollback imediato e revise logs de migração | Nuvem privada, containers e orquestração: o que muda no jogo |
| Pods não iniciam | Recursos insuficientes ou erro de configuração no YAML | Verifique logs com 'kubectl logs' e ajuste requests/limits | Nuvem privada, containers e orquestração: o que muda no jogo |
| Dados não aparecem no EspoCRM após integração | Falha na autenticação ou mapeamento de campos | Revise tokens de acesso e o mapeamento entre sistemas | O futuro do CRM livre: interoperabilidade e IA |
| Erros 500 ao chamar API | Limite de memória do PHP ou configuração do MariaDB insuficiente | Ajuste memory_limit no php.ini e otimize parâmetros do MariaDB | O futuro do CRM livre: interoperabilidade e IA |
| Respostas lentas da API | Volume alto de dados ou queries não otimizadas | Implemente paginação e revise índices no banco | O futuro do CRM livre: interoperabilidade e IA |
| Pop-up não aparece no CRM | Falha na comunicação entre Asterisk e CRM ou número não cadastrado. | Verifique logs do AMI e se o número está correto e padronizado no CRM. | O que é integração de CRM com telefonia IP: cenários e limit |
| Chamada não é registrada no CRM | API do CRM não configurada corretamente ou evento não recebido. | Revise as configurações de webhook/API e autenticação. | O que é integração de CRM com telefonia IP: cenários e limit |
| Dados de operador incorretos | Ramais compartilhados ou falta de identificação no evento AMI. | Padronize ramais e revise scripts de integração. | O que é integração de CRM com telefonia IP: cenários e limit |
| Deploy não atualiza após merge | ArgoCD/Flux não está monitorando o branch correto ou perdeu permissão | Verifique configuração do repositório e permissões de acesso | Operando CRMs com GitOps e Infrastructure as Code |
| Erro de sintaxe em YAML bloqueia pipeline | Arquivo mal formatado | Valide YAML com 'yamllint' antes de commitar | Operando CRMs com GitOps e Infrastructure as Code |
| Terraform cria recursos duplicados | State file inconsistente ou perdido | Reimporte recursos com 'terraform import' e nunca edite state manualmente | Operando CRMs com GitOps e Infrastructure as Code |
| Não consigo acessar o CRM externamente | Ingress Controller ou firewall bloqueando tráfego | Revise as regras de firewall e a configuração do Ingress | Padrões de rede e segurança em nuvem privada para CRMs |
| Certificado TLS inválido | Secret do certificado ausente ou mal configurado | Recrie o secret com o certificado correto | Padrões de rede e segurança em nuvem privada para CRMs |
| Pods do CRM acessíveis de outros namespaces | Network Policy ausente ou permissiva demais | Aplique uma policy restritiva e teste o isolamento | Padrões de rede e segurança em nuvem privada para CRMs |
| Campo obrigatório não aparece no layout | Campo não incluído no layout de edição | Adicione o campo ao layout correto em Administração > Layouts | Personalizando entidades, campos e layouts |
| Mensagem de erro ao salvar registro | Validação mal configurada ou campo obrigatório não preenchido | Revise as regras de validação e os campos obrigatórios | Personalizando entidades, campos e layouts |
| Campo removido ainda aparece na tela | Layout não atualizado após remoção do campo | Atualize o layout removendo o campo manualmente | Personalizando entidades, campos e layouts |
| Webhook não dispara | Evento não configurado corretamente ou endpoint externo inacessível | Revise configuração do evento e teste conectividade do endpoint | Personalizando integrações: webhooks, APIs REST e autenticaç |
| API REST retorna 401 Unauthorized | Token OAuth2 inválido ou expirado | Regere o token e valide escopo e permissões | Personalizando integrações: webhooks, APIs REST e autenticaç |
| Dados sensíveis expostos na API | Permissões do usuário da integração estão amplas demais | Restringa permissões do usuário/client OAuth2 | Personalizando integrações: webhooks, APIs REST e autenticaç |
| Backup do banco falha com erro de permissão | Usuário do banco não tem permissão de leitura total | Conceda permissão adequada com GRANT ALL PRIVILEGES | Planejamento de backup e recuperação de desastres |
| Backup dos arquivos termina abruptamente | Espaço em disco insuficiente | Libere espaço ou direcione o backup para outro disco | Planejamento de backup e recuperação de desastres |
| Restore do banco apresenta erro de chave duplicada | Banco não estava vazio antes do restore | Apague e recrie o banco antes de restaurar | Planejamento de backup e recuperação de desastres |
| SuiteCRM lento em horários de pico | CPU ou RAM insuficientes para o número de acessos simultâneos. | Aumente os recursos do servidor ou distribua a carga. | Planejamento de recursos: sizing de hardware e software para |
| Erros de upload de arquivos | Espaço em disco insuficiente ou limites de upload do PHP. | Libere espaço ou ajuste as diretivas post_max_size e upload_max_filesize no php.ini. | Planejamento de recursos: sizing de hardware e software para |
| Consultas SQL demoradas | Banco de dados sobrecarregado ou disco lento. | Otimize índices, aumente RAM ou migre para SSD. | Planejamento de recursos: sizing de hardware e software para |
| O CRM fica lento em horários de pico | Requests e limits subdimensionados ou storage lento | Aumente os recursos dos pods e use storage mais rápido | Planejando para o futuro: como prever gargalos antes que ele |
| Alertas de uso de memória não disparam | Configuração incorreta das regras de alerta no Prometheus | Revise as regras e consulte a documentação oficial | Planejando para o futuro: como prever gargalos antes que ele |
| Banco de dados trava sob carga | IOPS insuficiente ou queries mal otimizadas | Otimize índices e migre para storage SSD | Planejando para o futuro: como prever gargalos antes que ele |
| Usuários solicitam acesso ao código modificado do EspoCRM | Obrigação da AGPLv3 ao expor o sistema via rede. | Disponibilize o código-fonte modificado conforme a licença. | Por que CRMs de código aberto? Licenças, riscos e oportunida |
| Erro ao aplicar patch de segurança | Divergência entre o core oficial e customizações locais. | Rebase suas alterações sobre a versão mais recente do repositório oficial. | Por que CRMs de código aberto? Licenças, riscos e oportunida |
| Dúvida sobre necessidade de publicação de customização SuiteCRM | Confusão entre AGPLv3 e GPLv3. | Consulte a documentação oficial da licença GPLv3 para confirmar a obrigação. | Por que CRMs de código aberto? Licenças, riscos e oportunida |
| Erro de certificado inválido ao acessar via HTTPS | Certificado expirado ou cadeia de confiança incompleta | Renove o certificado e confira o parâmetro SSLCertificateChainFile | Práticas recomendadas: HTTPS, senhas e logs de acesso |
| Usuários conseguem acessar via HTTP | Redirecionamento não configurado corretamente | Revise as regras de Rewrite no Apache ou server block no Nginx | Práticas recomendadas: HTTPS, senhas e logs de acesso |
| Senhas fracas ainda são aceitas | Política de senha não aplicada ou cache do navegador | Reaplique as configurações e limpe o cache | Práticas recomendadas: HTTPS, senhas e logs de acesso |
| Erro 401 Unauthorized ao acessar endpoint | Token inválido ou ausente | Gere um novo token e use no header Authorization | Preparando o CRM: endpoints, webhooks e autenticação |
| Webhook não dispara evento | Evento configurado incorretamente ou endpoint do Asterisk indisponível | Revise o evento e teste a URL do webhook | Preparando o CRM: endpoints, webhooks e autenticação |
| Campos obrigatórios ausentes na criação de chamada | Mapeamento incompleto entre Asterisk e CRM | Atualize o script de integração para enviar todos os campos requeridos | Preparando o CRM: endpoints, webhooks e autenticação |
| Erro 500 ao tentar login | Permissões incorretas ou falta de extensão PHP | Ajuste permissões e instale extensões obrigatórias conforme documentação | Primeiros acessos: validação pós-instalação e primeiros ajus |
| Usuário comum acessa área administrativa | Perfis e permissões mal configurados | Revise roles e security groups | Primeiros acessos: validação pós-instalação e primeiros ajus |
| Moeda não aparece como BRL | Configuração de moeda não aplicada corretamente | Edite ou adicione BRL em Administração > Moedas | Primeiros acessos: validação pós-instalação e primeiros ajus |
| Dashboard exibe campos em inglês | Pacote de idioma não instalado ou não ativado | Instale e ative o pacote de idioma português brasileiro | Primeiros acessos: validação pós-instalação e primeiros ajus |
| Requisições legítimas são bloqueadas | Limite configurado muito baixo para o uso real | Ajuste os parâmetros de rate limiting para acomodar o tráfego esperado | Protegendo APIs do CRM: rate limiting e logs |
| Logs não registram acessos à API | Nível de log insuficiente ou configuração incorreta do webserver | Aumente o nível de log e revise o LogFormat/CustomLog | Protegendo APIs do CRM: rate limiting e logs |
| Logs crescem rapidamente e ocupam todo o disco | Rotação de logs não configurada | Implemente logrotate e revise políticas de retenção | Protegendo APIs do CRM: rate limiting e logs |
| Usuário acessa campo sensível sem permissão | Permissões de campo não configuradas corretamente | Revise as permissões da função e ajuste para negar acesso ao campo | Protegendo dados sensíveis e conformidade LGPD |
| Consentimento não está sendo registrado | Campos personalizados não foram criados ou não são obrigatórios | Crie os campos e defina como obrigatórios no fluxo de cadastro | Protegendo dados sensíveis e conformidade LGPD |
| Logs de auditoria não mostram alterações | Auditoria não está ativada para a entidade ou campo | Ative a auditoria nas configurações e teste novamente | Protegendo dados sensíveis e conformidade LGPD |
| Erro ao iniciar o MySQL após ativar criptografia | Plugin de keyring não carregado corretamente ou caminho inválido. | Revise a configuração do keyring_file_data e permissões do diretório. | Protegendo dados sensíveis: criptografia em repouso e em trâ |
| Acesso ao CRM não redireciona para HTTPS | Configuração de VirtualHost incompleta ou módulo rewrite desativado. | Ative o mod_rewrite e revise as diretivas de redirecionamento. | Protegendo dados sensíveis: criptografia em repouso e em trâ |
| Backup criptografado não pode ser restaurado | Chave privada ou senha do GPG ausente. | Garanta que a chave correta está disponível no servidor de restore. | Protegendo dados sensíveis: criptografia em repouso e em trâ |
| Chamadas não completam | Erro de configuração SIP ou NAT | Verifique pjsip.conf/sip.conf e regras de firewall | Protocolos e padrões: SIP, AMI e APIs REST em CRMs livres |
| Middleware não recebe eventos | Permissões AMI insuficientes ou IP bloqueado | Revise manager.conf e logs do Asterisk | Protocolos e padrões: SIP, AMI e APIs REST em CRMs livres |
| CRM não atualiza após chamada | Erro de autenticação ou endpoint REST incorreto | Teste a API do CRM com curl e revise tokens | Protocolos e padrões: SIP, AMI e APIs REST em CRMs livres |
| Chamadas caindo ou com áudio cortado em horários de pico | Excesso de chamadas simultâneas para a capacidade da CPU ou banda | Reduza o número de chamadas simultâneas ou aumente recursos | Quantificando chamadas e registros: cálculo de carga |
| Consultas no CRM ficam lentas após alguns meses | Tabelas de chamadas muito grandes sem índices ou limpeza | Crie índices e implemente rotina de limpeza/arquivamento | Quantificando chamadas e registros: cálculo de carga |
| Gravações não são salvas ou corrompidas | Disco insuficiente ou banco de dados sobrecarregado | Monitore espaço em disco e mova gravações para storage externo | Quantificando chamadas e registros: cálculo de carga |
| Interface web não carrega após restore | Banco restaurado fora de sincronia com arquivos | Restaurar arquivos e banco do mesmo backup | Recuperando de incidentes: downtime, corrupção e resposta rá |
| Erros de permissão em uploads | Permissões de arquivos não restauradas corretamente | Ajustar permissões com chown/chmod dentro do pod | Recuperando de incidentes: downtime, corrupção e resposta rá |
| Dados recentes ausentes | Backup desatualizado | Avaliar periodicidade dos backups e restaurar backup mais recente disponível | Recuperando de incidentes: downtime, corrupção e resposta rá |
| Registro não aparece no CRM | Falha na autenticação da API ou payload inválido | Revise credenciais, endpoint e formato dos dados enviados | Registro automático de chamadas: do evento ao lead |
| Chamada aparece sem usuário associado | Ramais não mapeados corretamente para IDs de usuário | Atualize a tabela de correspondência e revise o script | Registro automático de chamadas: do evento ao lead |
| Script não captura eventos | Permissões insuficientes no AMI ou firewall bloqueando porta 5038 | Ajuste permissões e libere a porta no firewall | Registro automático de chamadas: do evento ao lead |
| Sistema lento ao salvar registros | Buffer pool do MariaDB pequeno | Aumente innodb_buffer_pool_size e reinicie o serviço | Requisitos mínimos e recomendados: hardware, PHP e banco |
| Erro de upload de arquivos grandes | Limite baixo em upload_max_filesize ou post_max_size | Ajuste os parâmetros no php.ini | Requisitos mínimos e recomendados: hardware, PHP e banco |
| Muitos erros 500 no EspoCRM | Falta de memória no PHP | Aumente memory_limit e monitore o consumo | Requisitos mínimos e recomendados: hardware, PHP e banco |
| Conexões ao banco esgotadas | max_connections baixo no MariaDB | Aumente max_connections no my.cnf | Requisitos mínimos e recomendados: hardware, PHP e banco |
| SuiteCRM continua lento após índice | Query envolve múltiplas tabelas ou campos não indexados | Analise o plano de execução (EXPLAIN) e crie índices adicionais conforme necessário | Resolvendo gargalos: lições aprendidas em projetos reais |
| Erro ao conectar ao Redis | Serviço Redis não iniciado ou configuração incorreta | Verifique status do Redis e revise host/porta no config.php | Resolvendo gargalos: lições aprendidas em projetos reais |
| Backup não restaura corretamente | Arquivo corrompido ou permissões insuficientes | Teste restauração regularmente e ajuste permissões do diretório de backup | Resolvendo gargalos: lições aprendidas em projetos reais |
| Relatório não chega por e-mail | Script falhou ou cron não está configurado | Revise logs do cron e do PHP, teste script manualmente | Resolvendo gargalos: lições aprendidas em projetos reais |
| Erro após deploy de customização | Mudança não homologada ou conflito de versões | Sempre teste em ambiente de homologação antes do deploy | Resolvendo gargalos: lições aprendidas em projetos reais |
| E-mails não chegam ao CRM | Falha de autenticação IMAP | Atualize usuário/senha ou gere App Password. | Resolvendo problemas de integração e e-mail |
| Erro 401 na API | Token expirado ou inválido | Gere novo token e atualize na integração. | Resolvendo problemas de integração e e-mail |
| Falha ao enviar e-mail | Porta SMTP bloqueada | Libere a porta 465 ou 587 no firewall. | Resolvendo problemas de integração e e-mail |
| Pods reiniciando frequentemente | Excesso de consumo de memória (OOMKilled) | Ajustar limites de memória ou investigar leaks | Resolvendo problemas de performance e disponibilidade em pro |
| Respostas HTTP 504 Gateway Timeout | CPU saturada ou queries lentas | Scale up e revisar queries SQL | Resolvendo problemas de performance e disponibilidade em pro |
| Latência alta após deploy | Código novo com leak ou job pesado | Rollback e análise de código | Resolvendo problemas de performance e disponibilidade em pro |
| Retorno HTTP 401 Unauthorized ao tentar acessar a API. | Token de acesso inválido, expirado ou ausente. | Solicite novo token e envie corretamente no header Authorization. | REST API e extensibilidade: abrindo o SuiteCRM para integraç |
| Endpoint customizado não aparece ou retorna 404. | Arquivo PHP com erro de sintaxe ou Quick Repair and Rebuild não executado. | Revise o código, corrija erros e execute Quick Repair and Rebuild. | REST API e extensibilidade: abrindo o SuiteCRM para integraç |
| Campos customizados não aparecem no retorno da API. | Campos não configurados para exposição via API ou cache desatualizado. | Verifique configuração dos campos e limpe o cache do SuiteCRM. | REST API e extensibilidade: abrindo o SuiteCRM para integraç |
| Chamadas não aparecem no CRM | Falha na autenticação da API ou endpoint incorreto. | Revise o token de acesso e o endpoint na documentação oficial. | Seleção de ferramentas: EspoCRM, SuiteCRM e alternativas liv |
| Registros duplicados de chamadas | Script de integração disparando múltiplas vezes para o mesmo evento. | Implemente controle de idempotência nos scripts externos. | Seleção de ferramentas: EspoCRM, SuiteCRM e alternativas liv |
| Lentidão ao registrar chamadas em lote | Banco de dados subdimensionado ou API sem otimização. | Ajuste índices no banco e revise limites de requisição da API. | Seleção de ferramentas: EspoCRM, SuiteCRM e alternativas liv |
| E-mails não aparecem no SuiteCRM | Configuração IMAP incorreta ou bloqueio de firewall | Revise servidor, porta e credenciais; teste conexão externa ao IMAP | Sincronização de e-mails e calendário: conectando SuiteCRM a |
| Não é possível enviar e-mails | SMTP bloqueado ou autenticação falhou | Verifique usuário, senha e porta; teste envio via telnet | Sincronização de e-mails e calendário: conectando SuiteCRM a |
| Eventos do Google Calendar não sincronizam | Credenciais OAuth inválidas ou escopo insuficiente | Regere as credenciais e revise permissões no Google Cloud | Sincronização de e-mails e calendário: conectando SuiteCRM a |
| Dados não aparecem no destino | Mapeamento incorreto ou falha na transformação | Revise o dicionário de mapeamento e logs do ETL | Sincronizando CRMs com sistemas legados: estratégias e armad |
| Registros duplicados | Falta de controle de incrementalidade ou chaves únicas | Implemente filtros por data e verifique unicidade dos identificadores | Sincronizando CRMs com sistemas legados: estratégias e armad |
| Timeouts frequentes | Carga excessiva ou endpoints instáveis | Reduza a frequência dos jobs e monitore a saúde dos sistemas | Sincronizando CRMs com sistemas legados: estratégias e armad |
| Dados truncados ou corrompidos | Conversão de tipos ou encoding incompatível | Padronize formatos e valide encoding (UTF-8 recomendado) | Sincronizando CRMs com sistemas legados: estratégias e armad |
| SuiteCRM não conecta ao banco de dados | Variáveis de ambiente incorretas ou serviço do banco não iniciado | Revise SUITECRM_DB_HOST, SUITECRM_DB_USER e verifique logs do container db | SuiteCRM em nuvem, containers e DevOps: o que já é realidade |
| Uploads desaparecem após reinício | Volumes persistentes não configurados corretamente | Ajuste o mapeamento de volumes no docker-compose.yml | SuiteCRM em nuvem, containers e DevOps: o que já é realidade |
| Erro 500 ao acessar a aplicação | Permissões de arquivos ou extensões PHP ausentes | Verifique permissões dos volumes e extensões obrigatórias no Dockerfile | SuiteCRM em nuvem, containers e DevOps: o que já é realidade |
| Tarefas agendadas não executam | Cron não configurado corretamente ou permissões erradas | Verifique o comando no crontab e permissões do usuário www-data | SuiteCRM: fundamentos, licenciamento e ecossistema |
| Customização não aparece | Cache não limpo ou rebuild não realizado | Acesse Admin > Repair > Quick Repair and Rebuild | SuiteCRM: fundamentos, licenciamento e ecossistema |
| Erro de permissão ao acessar arquivos | Permissões de arquivos e pastas incorretas | Ajuste permissões com chown e chmod conforme documentação | SuiteCRM: fundamentos, licenciamento e ecossistema |
| Integração via API falha | Token inválido ou endpoint incorreto | Verifique documentação da API REST e gere novo token | SuiteCRM: fundamentos, licenciamento e ecossistema |
| Scheduled Jobs não executam | Cron não está configurado ou está no usuário errado | Revise o usuário do crontab e o caminho do EspoCRM | Tarefas agendadas e notificações automáticas |
| Notificações por e-mail não chegam | Configuração de SMTP incorreta ou bloqueio externo | Teste envio de e-mail em Administração > Configuração de E-mail | Tarefas agendadas e notificações automáticas |
| Sistema lento após ativar automações | Jobs rodando com frequência excessiva ou lógica ineficiente | Reduza a frequência dos jobs e revise os workflows | Tarefas agendadas e notificações automáticas |
| Teste de carga não aumenta uso de CPU | Script de teste não está simulando ações reais ou está limitado a páginas estáticas | Ajuste o script para incluir login e operações CRUD | Testes de carga e limites práticos do SuiteCRM |
| Banco de dados trava durante teste | Configuração insuficiente de conexões ou buffer pool | Aumente max_connections e innodb_buffer_pool_size no MariaDB | Testes de carga e limites práticos do SuiteCRM |
| SuiteCRM retorna erro 500 | Limite de memória do PHP atingido | Aumente memory_limit no php.ini e reinicie o servidor web | Testes de carga e limites práticos do SuiteCRM |
| Respostas muito lentas mesmo com poucos usuários | Disco lento ou queries não otimizadas | Verifique I/O com iostat e analise queries lentas no MariaDB | Testes de carga e limites práticos do SuiteCRM |
| Chamadas caindo ou com eco | Mistura de tráfego de voz e dados na mesma rede | Separe VLANs e priorize QoS para SIP/RTP | Topologias de integração: onde posicionar Asterisk e CRM |
| CRM não recebe eventos de chamada | Permissões ou firewall bloqueando acesso à AMI | Revise manager.conf e regras de firewall | Topologias de integração: onde posicionar Asterisk e CRM |
| Perda total de serviço ao reiniciar um servidor | Ausência de failover | Implemente redundância com keepalived ou cluster | Topologias de integração: onde posicionar Asterisk e CRM |
| Chamada WebRTC não conecta | Problemas de TLS, codecs incompatíveis ou NAT mal configurado | Revise certificados, codecs permitidos e configure ICE/STUN corretamente | WebRTC, softphones e integração omnichannel |
| Softphone não registra | Credenciais erradas ou endpoint mal configurado | Verifique usuário, senha e parâmetros do endpoint | WebRTC, softphones e integração omnichannel |
| Eventos de chamada não aparecem no CRM | Webhook/API do CRM não configurado ou falha de autenticação | Teste integração com logs e revise tokens de acesso | WebRTC, softphones e integração omnichannel |
| Workflow não executa | Scheduler do SuiteCRM não está rodando | Verifique cron do sistema e agendamento do Scheduler | Workflows e Logic Hooks: automatizando processos sem e com c |
| Logic Hook não dispara | Hook não registrado corretamente ou erro de sintaxe em PHP | Revise o arquivo logic_hooks.php e o código PHP, consulte os logs | Workflows e Logic Hooks: automatizando processos sem e com c |
| Sistema lento após ativar Logic Hook | Código do hook executando operações pesadas | Otimize o código, evite loops desnecessários e consultas externas síncronas | Workflows e Logic Hooks: automatizando processos sem e com c |
| Tarefas de follow-up não são criadas | Workflow do CRM não está ativado ou evento não está chegando | Verifique logs do CRM e integração do Asterisk | Workflows encadeados: do atendimento à pós-venda automatizad |
| Alertas de escalonamento não disparam | Condições do workflow estão incorretas ou e-mail não configurado | Revise condições e teste envio de e-mail no CRM | Workflows encadeados: do atendimento à pós-venda automatizad |
| Eventos de chamada duplicados | Asterisk enviando múltiplos eventos por chamada | Ajuste script AGI/AMI para filtrar duplicidades | Workflows encadeados: do atendimento à pós-venda automatizad |
| Workflow não dispara | Condições do gatilho não foram atendidas | Revise as condições e teste com dados que realmente as satisfaçam | Workflows: criando automações sem código |
| Ação não executa | Permissões insuficientes ou configuração incorreta da ação | Verifique permissões do usuário e revise a configuração da ação | Workflows: criando automações sem código |
| Workflow dispara múltiplas vezes | Condições permitem execuções repetidas | Adicione condição para evitar repetição ou marque campo após execução | Workflows: criando automações sem código |
