Requisitos de servidor#
Esta página é a referência de arquitetura: o que roda no servidor, o que cada peça faz e o que quebra quando ela cai. Para o dimensionamento — quanta CPU, memória e disco — veja Requisitos de instalação.
As peças#
| Peça | O que faz | O que para sem ela |
|---|---|---|
| Node.js | Executa o sistema | Tudo |
| MongoDB | Guarda conversas, cadastros, fluxos, configurações | Tudo |
| Redis | Sessões, cache e coordenação entre processos | Login e distribuição |
| Nginx | Recebe as requisições e serve o painel | O acesso pelo navegador |
| PM2 | Mantém os processos de pé e os reinicia | A recuperação automática |
| FFmpeg | Processa áudio | Áudio e transcrição |
| Asterisk | Central telefônica | Telefonia — opcional |
| Kokoro | Voz natural | A voz sintetizada boa — opcional |
Versões mínimas: Node 18, MongoDB 6, Redis 6, Asterisk 18.
O sistema roda em cluster#
Há mais de um processo, tipicamente um por núcleo. Isso tem uma consequência que aparece no diagnóstico: estado de disponibilidade não pode viver na memória de um processo, porque quem distribui pode ser outro e o recarregamento da página do atendente cai em qualquer um.
É por isso que a pausa vive no banco, e não na memória — veja Pausas.
O que precisa alcançar a internet#
De fora para dentro — os webhooks dos canais:
/webhook/meta,/webhook/telegram,/webhook/twilio,/webhook/360dialog
Se eles não forem alcançáveis, as mensagens dos clientes não chegam, e não há erro na tela do atendente. Veja Webhooks.
De dentro para fora:
- O provedor de IA, se houver.
- O ERP integrado.
- O servidor de licenças — sem ele, a validação e a recuperação de senha param.
- Os destinos de backup externos.
Firewall apertado sem essas exceções derruba coisas que parecem não ter relação com rede. Veja Firewall e redes permitidas.
Portas#
A conexão com a central telefônica usa por padrão a porta 5038 (AMI), em localhost. Ela dá acesso completo à central: não a exponha à internet, e use credencial própria.
CONFERIR: portas internas usadas pelo sistema, MongoDB e Redis nesta instalação, e a porta HTTPS publicada
Máquina virtual#
Duas decisões mudam o comportamento e não aparecem em log:
Balloon ligado faz o hipervisor retomar memória quando o host aperta, e o sistema passa a ser reciclado sem erro que explique. Desligue o balloon ou reserve a memória.
Soquetes virtuais fazem o sistema decidir posicionamento de memória com base numa topologia que não existe. Prefira 1 soquete com N núcleos.
As duas estão detalhadas em Requisitos de instalação.
Certificado#
Os provedores de canal exigem HTTPS com certificado válido e reconhecido. Autoassinado é recusado. Veja Certificado SSL.
Se algo der errado#
Uma peça caiu e você não sabe o que ela derruba. A Sala de máquinas diz isso — veja Diagnóstico.
O sistema sobe e cai sozinho. Memória. Em VM, suspeite do balloon.
Mensagens param de chegar depois de uma mudança de rede. Os webhooks deixaram de ser alcançáveis.
A validação de licença parou depois de apertar o firewall. Falta a saída para o servidor de licenças.