NAiOSOmni

omnichatv0.8.1

Liga o WhatsApp e o Telegram ao NAiOS. Painel com KPIs e gráficos, caixa de entrada unificada, resposta automática com IA e ferramentas, agentes verticais, modo de simulação para demonstrações e multi-tenant.

Só para utilizadores MAXComunicaciónwhatsapptelegrammessaginginboxaichannelsomnichannelbaileyscloud-apibotauto-replytoolsagentsvertical-botlead-capturecrmai-wizardNAiOS Team

Funções

Versão

0.8.1

Licença

MIT

Serviços

—

Descrição

O OmniChat transforma qualquer canal de mensagens numa interface para o NAiOS. Liga o WhatsApp Pessoal (Baileys, por QR), a WhatsApp Business Platform oficial (Meta Cloud API) ou um Bot do Telegram. Inclui um painel com KPIs calculados automaticamente e gráficos (linhas, donut, heatmap), caixa de entrada unificada em tempo real (SSE), resposta automática com IA e chamada de ferramentas, 14 ferramentas (gerar/editar imagens, transcrever áudio, enviar email, consultar a KB, criar apresentações/landing pages/formulários, guardar encomendas estruturadas...), 5 modos de canal (fechado, whitelist, blacklist, cliente, gateway de aquisição), modo SIMULAÇÃO para demonstrações em que o cliente escolhe que agente testar, comandos no chat contigo mesmo (/on, /off, /pause, /ai), autoligação via /claim para que os teus clientes registados usem o seu próprio contexto NAiOS, onboarding por gateway com início de sessão por magic-link, AGENTES VERTICAIS: bots especializados (encomendas ao domicílio, leads imobiliários, reservas de restaurante, etc.) com prompt + variáveis do negócio + esquema JSON de captura, gerados por um assistente de IA, com CRM integrado, recuperação automática do worker após perda de sessão e reconexão sem voltar a vincular quando as credenciais continuam válidas.

Funcionalidades (26)

WhatsApp Pessoal (Baileys)

Vincula o teu número como dispositivo por QR ou código. Suporta grupos. Worker process isolado.

WhatsApp Business Platform

Ligação oficial à Meta Cloud API. Risco zero de bloqueio, modelos, webhooks com HMAC verificado.

Bot do Telegram

Bot oficial via Bot API. Token do @BotFather, sem riscos, gratuito. Suporta grupos e multimédia.

Caixa de entrada unificada em tempo real

Lista de conversas + conversa + compositor. Envio por SSE, multimédia visual (imagens, áudios, vídeos).

Resposta automática com IA e ferramentas

Ciclo de chamada de ferramentas: 12 ferramentas prontas (gerar/editar imagens, áudios, KB, email, apresentações...).

Comportamento humano

Indicador de escrita proporcional ao comprimento, variação aleatória, pausa após resposta manual do proprietário.

5 modos de canal

Fechado, whitelist, blacklist, cliente, gateway. Configurável visualmente.

Gateway: onboarding no NAiOS via WhatsApp

Transforma o teu canal num funil: qualquer desconhecido convidado a criar uma conta NAiOS gratuita com magic-link.

Multi-tenant + autoligação /claim

Os utilizadores registados podem vincular o seu WhatsApp com /claim email + /code. O bot usa O SEU prompt e OS SEUS tokens.

Regras por contacto

Substituição por par: forçar ligado/desligado, prompt personalizado, pausa, tudo a partir da interface.

Horário laboral + férias

Editor visual por dia com intervalos horários, modo de ausência com mensagem personalizada.

Anti-spam e limites de envio

Quotas por mensagem/minuto/hora/dia, deteção automática de rajadas, protege contra bloqueios.

Comandos pelo WhatsApp

/on /off /pause /status /test /prompt /ai /help a partir do teu próprio chat comigo mesmo.

Modelos verticais

6 modelos: restaurante, suporte, imobiliária, salão, vendas B2B, assistente pessoal.

Métricas para superadmin

Endpoint com totais e estatísticas por canal, erros, mensagens/dia, sessões ativas.

Agentes verticais com assistente de IA

Cria bots especializados (encomendas, leads, reservas) descrevendo-os em linguagem natural — a IA gera o prompt, os campos e o email.

Captura estruturada (registos de CRM)

As encomendas são guardadas na BD com JSON Schema. Vista de CRM com filtros, estados, edição, notas, exportação para CSV.

Notificações ao proprietário

Aviso por email + WhatsApp para o telefone vinculado quando chega uma encomenda nova. Confirmação automática ao cliente.

Webhooks de saída (HMAC)

Cada novo registo dispara um POST assinado com HMAC-SHA256 para o teu URL externo (Zapier, Make, n8n, CRM). Retry exponencial + registo de entregas.

Vista Kanban com arrastar e largar

4 colunas (novo / contactado / concluído / arquivado) com arrastar e largar entre estados. Alternância tabela/Kanban memorizada.

Visualizador do fluxo do agente (D3 + IA)

Diagrama interativo gerado por IA a partir do prompt — mostra turnos, decisões, ferramentas e campos capturados. Zoom/deslocamento + exportação SVG.

Painel do agente

Separador principal com KPIs, gráficos (Chart.js: linhas/donut/barras + heatmap D3), atividade recente unificada e verificação de estado com ações.

Painel global do plugin

Página inicial com KPIs calculados automaticamente (mensagens, encomendas, conversão, tokens) + gráfico de linhas dos últimos 30 dias de entradas/saídas + donut de estados + heatmap hora×dia + principais canais/agentes + alertas de saúde.

Modo de simulação (demo)

Coloca um canal em modo demo: o cliente escolhe entre os agentes que habilitares. 5 textos editáveis, comandos /exit /cambiar /menu /help, registos marcados com a flag is_simulation.

Recuperação automática sem voltar a vincular

Após perda de sessão do WhatsApp Web (fecho do lado do servidor, limite de 4 dispositivos, reinício do servidor), o worker volta a arrancar sozinho reutilizando o auth_blob guardado. Botão 'Reconectar' explícito se a recuperação automática falhar.

Nova conversa a partir da Caixa ou da Inbox

Seletor de contactos integrado: agenda sincronizada (wa-personal) ou pares já vistos. Na Caixa escolhes primeiro o canal e depois o contacto; abres a conversa vazia pronta para escrever.

Changelog

v0.8.12026-09-14

Pontos de integração para outros módulos (contrato com Campanhas): listChannelsFor(userId) devolve os canais do utilizador (próprios + partilhados com permissão de resposta) com kind/label/phone/connected; sendFor(userId, { channelId, to, text?, template?, meta? }) envia por um canal do utilizador normalizando o destino para o par de cada driver (telefone → JID em wa-personal, dígitos em wa-cloud, chat_id@telegram) e devolve { ok, messageId, channelKind } ou { ok:false, error: bad_args|no_channel|not_connected|forbidden|needs_template|transport }. Nunca lançam exceções.
wa-cloud: o erro 131047 (fora da janela de 24 h) é reportado como needs_template; com template { name, language, params[] } envia-se o modelo da Meta.
O envio manual da caixa e sendFor partilham o mesmo caminho interno (_dispatchOutgoing + _attributeOutgoing): registo na conversa e atribuição sent_by_user_id idênticos; sendFor acrescenta ainda uma entrada no registo do canal (categoria send) com o módulo de origem.
Novo teste tests/omnichat/test-send-seam.js (driver simulado).

v0.8.02026-05-04

MODO SIMULAÇÃO — interruptor por canal com seleção múltipla de agentes permitidos, 5 textos editáveis (menu/introdução/confirmação/inválido/saída), comandos /exit /cambiar /menu /help, estado por par (chosen_agent_id + phase + session_started_at), histórico limitado por session_started_at para evitar contaminação da persona ao mudar de agente
Nova tabela omnichat_simulation_state + colunas em omnichat_channel_settings + flag is_simulation em omnichat_agent_records
PAINEL global do plugin substitui a página inicial /plugins/omnichat/ — KPIs calculados automaticamente (mensagens com variação face ao período anterior, encomendas novas + paradas há 24 h, conversão, tokens consumidos), gráfico de linhas dos últimos 30 dias de entradas/saídas, donut de estados, heatmap hora×dia, principais canais e principais agentes, feed de encomendas recentes, alertas calculados (canais em baixo, encomendas por contactar, falhas de webhook na última hora)
Endpoint /api/dashboard?range=24h|7d|30d com todas as agregações SQL num único pedido, atualização a cada 30 s
Reestruturação da barra lateral: Painel como primeiro item, lista de canais movida para /channels, removidas as mini-estatísticas redundantes com o painel
Recuperação automática — restoreAll() passa também a reativar canais desvinculados com auth_blob+identifier válidos ao arrancar o plugin (cobre fecho do lado do servidor do WhatsApp Web, limite de 4 dispositivos, reinício do servidor)
Botão Reconectar (ícone de atualizar) no cartão de canais desvinculados com sessão válida — reutiliza o auth_blob sem ler o QR
Correção no worker — a verificação wasPaired consulta agora a BD (identifier IS NOT NULL) em vez de sock.authState.creds.registered em memória, que o Baileys passa a false em fechos do lado do servidor
status_detail amigável nos cartões: 'unpaired_close: connectionClosed' oculto para canais desvinculados (o botão Vincular já comunica), 'loggedOut: ...' → 'Sessão encerrada no WhatsApp', etc.
Remodelação do detalhe do agente — sub-separadores verticais (Identidade / Comportamento / Captura / Integrações) substituem o scroll plano de 9 cartões
Barra de guardar fixa com indicador 'Alterações por guardar' (animação pulsante) + aviso ao sair da página
Ferramentas agrupadas por categoria (🖼 Multimédia / 📚 Conhecimento / 📦 Captura / 📤 Saídas) com cartões visuais: ícone semântico, título amigável, nome técnico discreto, interruptor estilo iOS, contorno verde quando ativo, distintivos 'Obrigatório' / 'Plugin não instalado'
Coleções da KB como subpainel aninhado sob lookup_kb (não como cartão irmão) — cartões com ícone+cor da coleção, chip com número de documentos, seleção automática se houver apenas uma, aviso se lookup_kb estiver ativo mas sem nenhuma marcada, estado vazio com CTA para /plugins/knowledge-base
O endpoint /api/agents/tools-catalog passa a devolver available + missing[] por ferramenta, consultando o carregador de plugins
Botão de atalho 'Editar agente' nas definições do canal quando existe um agent_id ativo — ligação direta a /plugins/omnichat/agents/<id>
Seletor de Nova conversa na Caixa (separador Conversas) — modal de 2 passos canal+contacto, ligação direta à inbox com ?openPeer=<id>
Inbox: leitura de ?openPeer=<id>&peerName&peerType ao carregar — abre a conversa automaticamente (existente ou sintética) e limpa o URL com replaceState
Filtro 'Só reais / Todos / Só simulação' no separador Encomendas + distintivo 🧪 sim nos cartões/linhas
Correção de erro — getRecentMessages comparava timestamps SQLite ('YYYY-MM-DD HH:MM:SS') com sinceTs ISO ('YYYY-MM-DDTHH:MM:SSZ') por string ASCII, e ' ' < 'T' partia o filtro sempre. Agora usa datetime() nos dois lados
Correção de erro — o endpoint /api/agents/kb-collections usava this.pluginLoader, que nunca era atribuído; agora resolve-se com this.app.get('pluginLoader') em tempo de pedido
Correção de erro — o JS de records.ejs falhava em modo embed por addEventListener sobre null em hub-conv-q; adicionado optional chaining
Correção de erro — outerHTML em renderDetail do painel deslizante apagava o id do span do estado ao re-renderizar, e a segunda mudança de estado falhava com 'Cannot read properties of null'; substituído por className+textContent
Correção de erro — problema de especificidade CSS body.oc-shell-body (1,1,1) > .oc-shell-body (1,1,0) fazia com que a grelha móvel continuasse a reservar 240 px para a barra lateral oculta, e o conteúdo principal só recebia a largura viewport-240px
Responsividade móvel — meta viewport nas 7 vistas com <head>, grelha de KPIs em 2 colunas no telemóvel (minmax 200px → 150px), densidade das etiquetas do heatmap adaptada à largura, padding-left para o botão do menu no painel do agente, margem inferior na barra lateral para que o rodapé 'Início NAiOS' não fique sob a interface do browser
Interruptor do cartão de canal com etiqueta 'Bot' explícita + tooltip — evita confusão com a ligação
Middleware CSRF: removidos console.log de depuração que saturavam o registo em cada mudança de conversa
Reconciliação condicional — _reconcileOrphanFiles só é chamado quando a conversa carregada tem mensagens com marca de geração sem file_url (antes era chamado em cada mudança, sem parar)

v0.7.112026-05-03

Compositor com anexos: 📎 seletor de múltiplos ficheiros + sobreposição de arrastar e largar + Ctrl+V para colar
Endpoint backend multer até 5 ficheiros × 50 MB com deteção automática de MIME → image/video/audio/document
Legenda inteligente: a 1.ª imagem/vídeo leva o texto como legenda, os restantes seguem sem ela
Worker wa-personal alargado: tratamento nativo de áudio (ptt) e vídeo com legenda
Conversas unificadas na Caixa: o separador 'Conversas' agrega os chats de TODOS os canais
Filtro por canal com chips clicáveis + contadores por canal no cabeçalho
Endpoint /api/inbox/conversations com fusão entre canais + pesquisa global
Painel deslizante de conversa com compositor integrado (responde sem sair do Hub)
Avatares na lista do Hub + cabeçalho da conversa consistente com a inbox individual
Telemóvel: a lista recolhe para a conversa ao selecionar uma

v0.7.102026-05-03

Correção de erro: as imagens enviadas pelo bot deixam de se perder por condição de corrida com o eco do Baileys (deduplicação BOT_SENT_IDS)
Avatares de perfil: obtidos a partir do Baileys via sock.profilePictureUrl, transferidos e guardados em cache local
Worker IPC: fetchAvatar (individual) + bulkFetchAvatars (com limitação de ~5/s)
BD: omnichat_synced_contacts.avatar_local_path + avatar_fetched_at + helpers upsertAvatar/getAvatar
Endpoint GET /api/channels/:id/avatar/:peerId com cache ETag e atualização automática após 7 dias
Endpoint POST /refresh-avatars para atualização em massa manual
Helper ocAvatar() reutilizável com recurso ao ícone Phosphor se não houver foto
Integração: lista de conversas (36 px) + cabeçalho da conversa (40 px) + combobox de contactos (28 px)
Botão 📸 Avatares junto a 📲 Agenda no seletor de contactos (apenas wa-personal)

v0.7.92026-05-03

Cartão de canal remodelado: pílula de estado uniforme com ícone+etiqueta (sem mais 'error'/'unlinked' em bruto)
Interruptor ON/OFF inline no cartão (bot_enabled direto, sem entrar nas Definições)
Menu ⋮ contextual com Definições / Ver registo / Voltar a vincular / Eliminar
Ação principal contextual ao estado (Inbox / Vincular / Reconectar)
Novo separador 📜 Registo com tabela em tempo real, filtros (tempo/nível/categoria/pesquisa), acompanhamento ao vivo por SSE, exportação para CSV, limpeza
Serviço LogService que escreve na BD + emite por SSE + fallback para a consola
Instrumentação: ciclo de vida da ligação, decisões de resposta automática, chamadas de ferramentas, entregas de webhooks, alertas de limite de rajadas
Retenção automática de 30 dias + endpoints GET/DELETE /api/channels/:id/logs
Cartão oc-card-bot-off com opacidade reduzida + sufixo '(bot off)' no título

v0.7.82026-05-03

Combobox de contactos reutilizável (ocPeerCombobox) — lista pendente com pesquisa, entrada manual de reserva, lista de exclusão
Separador Contactos reescrito: o combobox substitui o campo peer_id, preenche o nome automaticamente
Substituições existentes apresentadas como cartões com avatar + chip de política + contorno semântico
Clicar em 'editar' no cartão → formulário inline pré-preenchido com os valores atuais (já não é preciso apagar e recriar)
Cache partilhada do conjunto de pares entre Acesso (whitelist/blacklist) e Contactos (substituições)
O combobox exclui automaticamente os pares que já têm substituição (evita duplicados)

v0.7.72026-05-03

Sincronização opcional da lista de contactos do WhatsApp (Baileys): lê sock.contacts + subscreve contacts.upsert para as atualizações incrementais
Tabela omnichat_synced_contacts + bulkUpsert com transação + ON CONFLICT que preserva os nomes não vazios
Worker IPC syncContacts + handler assíncrono + emit contacts.snapshot
Novo método driver.requestContactsSync() simétrico a sendMessage
POST /api/channels/:id/sync-contacts (acionamento manual) e GET /synced-contacts
UI do seletor de contactos: botão 📲 Agenda visível apenas para wa-personal, modal de consentimento com foco na privacidade na 1.ª vez
Fusão inteligente de pares vistos + contactos sincronizados (sem duplicados por peer_id), etiquetas visuais 'agenda'/'manual'
Ordenação: pares com mensagens primeiro por recência, depois os sincronizados por ordem alfabética
Telegram + Cloud API: botão oculto (não expõem agenda)
Correção de erro: o JOIN entre BDs de utilizadores → omnichat falhava; agora o email do utilizador NAiOS é hidratado em 2 passos

v0.7.62026-05-03

Seletor visual de contactos para whitelist/blacklist — substitui a caixa de texto com peer_ids
Painel dividido Na lista | Disponíveis, pesquisa em tempo real, clicar para mover
Cor semântica verde para whitelist, vermelha para blacklist (evita erros)
Endpoint /api/channels/:id/seen-peers com pré-visualização da última mensagem e atividade relativa
Modal 'Adicionar manualmente' com pré-visualização do formato (@s.whatsapp.net automático se forem apenas dígitos)
Compatível com o armazenamento legado separado por linhas

v0.7.52026-05-03

Âmbito da KB com foco na privacidade por agente: cada agente pode ser limitado a coleções específicas
A ferramenta lookup_kb lê agent.kb_collections; se estiver vazio, não consulta nada (evita expor informação confidencial)
Pesquisa paralela nas coleções autorizadas + fusão dos top-K por semelhança
UI do detalhe do agente: subsecção 'Coleções da KB autorizadas' aparece ao ativar lookup_kb
Endpoint /api/agents/kb-collections como proxy para a knowledge-base com deteção de plugin não instalado
Novo método público KB.getCollectionsForUser({userId}) simétrico a searchAsUser/addDocAsUser

v0.7.42026-05-03

Painel do agente como separador por defeito (substitui Estatísticas)
Endpoint /api/agents/:id/dashboard com 6+ agregações num único pedido (cache de 60 s)
5 KPIs: total, hoje (vs ontem), 7 dias (vs período anterior), por atender, tempo médio de fecho
3 gráficos Chart.js (linhas por dia / donut por estado / barras do principal campo adaptativo)
Heatmap D3 de atividade hora × dia da semana
Feed de atividade unificado: registos + entregas de webhook ordenados cronologicamente
Verificação de estado com 5+ validações e ligação 'corrigir' para cada problema
Chart.js v4 carregado de forma preguiçosa a partir do CDN apenas neste separador

v0.7.32026-05-03

Visualizador do fluxo do agente: D3 + dagre renderiza o JSON gerado por IA a partir do prompt
GET /api/agents/:id/flow com cache por hash do prompt (se não mudou, serve a cache instantaneamente)
Novo separador 📊 Fluxo no detalhe do agente com zoom/deslocamento, exportação SVG, modo JSON de depuração
6 tipos de nó (start/message/input/decision/tool/end/error) com paleta coordenada com o tema slate/green
D3 v7 + dagre carregados de forma preguiçosa a partir do CDN apenas ao ativar o separador

v0.7.22026-05-03

Webhooks de saída por agente: URL + segredo HMAC-SHA256 + retry exponencial (1 s/5 s/30 s) + registo de entregas
POST /api/agents/:id/webhook/test (ping de teste sem retry) e /webhook/deliveries (auditoria)
Vista Kanban na Caixa com 4 colunas e arrastar e largar entre estados (Sortable.js, atualização otimista)
Alternância tabela/Kanban com preferência memorizada no localStorage
UI do detalhe do agente: cartão 'Webhook' com geração de segredo + ping de teste + tabela de entregas em direto
Tabela omnichat_webhook_deliveries para depuração

v0.7.12026-05-03

Etiquetas dinâmicas por agente: record_label_singular/plural (Encomenda/Reserva/Ticket/Marcação/Lead/etc.)
O assistente de IA propõe as etiquetas automaticamente conforme o caso de uso
A UI usa a etiqueta do agente em cartões, cabeçalhos, confirmações e notificações (email + WhatsApp ao proprietário)
Navegação superior renomeada: 'Encomendas' → 'Caixa' (neutro, cobre todos os géneros)

v0.7.02026-05-03

Agentes verticais: bots especializados (gasóleo, restaurante, imobiliária…) com prompt + variáveis de negócio + JSON Schema de captura
Assistente de IA: descreve o teu bot em linguagem natural e a IA gera o agente completo (prompt, campos, modelo de email, ferramentas)
Ferramenta save_agent_record com validação contra data_schema e esquema dinâmico (o LLM vê os campos exatos a pedir)
Ferramenta send_confirmation_email com o modelo do agente + substituição de {{vars}}
Substituição de {{vars}} nos prompts (helper resolve template-vars)
Vista de CRM /records: tabela, filtros, detalhe em painel deslizante, edição, fluxo de estados, ações em massa, exportação CSV
Notificação ao proprietário por email + WhatsApp ao receber uma encomenda nova
Seletor de agente por canal + interface de agentes em grelha com ligar/desligar
Inbox responsiva para telemóvel + menu ⋮ por conversa com 4 ações
Barras de deslocamento temáticas slate/green
BD: omnichat_agents, omnichat_agent_records (+ active_agent_id em channel_settings)

v0.6.02026-05-03

Driver oficial do Bot do Telegram (Bot API)
5 ferramentas novas: generate_image_transparent, generate_music, create_presentation, create_landing, create_form
Endpoint de métricas para superadmin
UI de definições v2 com separadores modernos + editores visuais (business_hours, OOO, rate_limit)
Modelos de prompts (restaurante, suporte, imobiliária...)
Suíte de testes em Node nativo (29 testes)
Assistente de perfil para utilizadores gateway (alterar email/palavra-passe provisória)
Enriquecimento de identidade: distintivo NAiOS na inbox para pares vinculados

v0.5.02026-05-03

SSE na inbox (envio em tempo real vs polling)
Visualização multimédia na conversa (img/áudio/vídeo)
Reforço: limitador de pedidos, anti-spam por rajadas, horário laboral, ausência

v0.4.02026-05-02

Modo gateway real: onboarding no NAiOS via WhatsApp + início de sessão por magic-link
Autoligação /claim email + /code XXXXXX para utilizadores registados
Multi-tenant no contexto das ferramentas (identity.user_id usa o contexto do SEU workspace)
Interface de substituições por par (force_on/off, custom_prompt)
Bypass de token para admin/superadmin

v0.3.02026-05-02

Framework de ferramentas com audiência (admin/public) + requisitos de plugin
Ferramentas: generate_image, send_email, lookup_kb, edit_image, remove_bg, transcribe_audio, analyze_image
ctx.invokePlugin para chamadas entre plugins
Comando /ai para chat com IA e ferramentas a partir do chat comigo mesmo
Notificação prévia de tarefa ("🎨 A gerar imagem...")

v0.2.02026-05-02

Driver WhatsApp Cloud API (Meta oficial)
Refactor do Baileys para worker process (child_process.fork + IPC)
Resposta automática com IA + comandos /off /on /pause /status /test /prompt
Caixa de entrada unificada básica
Modos de canal (closed/whitelist/blacklist/customer/gateway)
Resolução de identidade com omnichat_known_peers
Bloqueio por par + filas de espera (correção de condição de corrida)

v0.1.02026-05-02

Scaffold inicial
Interface de adaptador de canal
Driver wa-personal Baileys (in-process)
Esquema de BD (8 tabelas)
Vinculação por QR + código
Vista base