Modo Offline & Fila-e-Sincronização — Engajamento do Cliente Ininterrupto

A conectividade com a Internet não é consistente. Clientes móveis perdem sinal. O Wi-Fi cai. Ocorrências de falhas de rede acontecem. Seu agente de IA não deve desaparecer quando as conexões falham. Nosso modo offline mantém as conversas fluindo, enfileirando mensagens localmente e sincronizando automaticamente quando a conectividade é restaurada.

Por que a resiliência offline é importante

Clientes em trens, metrôs ou aviões experimentam conectividade intermitente. Sites de varejo em porões ou áreas rurais têm cobertura irregular. Usuários empresariais atrás de firewalls corporativos enfrentam condições de rede imprevisíveis. Sem suporte offline, cada falha de rede interrompe conversas, frustra clientes e os afasta.

Arquitetura de mensagens de fila-e-sincronização

Quando os clientes enviam mensagens enquanto estão offline:

1. As mensagens são imediatamente armazenadas em uma fila IndexedDB local com timestamps, números de sequência e contadores de tentativas
2. A interface do usuário mostra mensagens como "pendentes" com um ícone de relógio e o status "Offline — enfileirando mensagens"
3. Os clientes podem continuar digitando — a fila cresce sem bloqueios
4. Quando a conectividade retorna, o evento online do navegador aciona um flush que despacha mensagens enfileiradas em ordem de sequência
5. Cada mensagem transita por "Entregando" enquanto está em trânsito
6. Os clientes veem continuidade sem interrupções — como se a rede nunca tivesse falhado

Cache de Service Worker para carregamento instantâneo offline

Todos os recursos críticos são armazenados em cache usando uma estratégia de cache-primeiro:

• Pacote JavaScript e folhas de estilo CSS
• Arquivos de fonte e imagens/ícones estáticos
• Arquivos de localização
• Estrutura HTML inicial

Novos carregamentos de página não requerem viagens de rede — tudo é renderizado imediatamente do cache.

Banner offline

Assim que o navegador fica offline, um banner persistente aparece acima da área de entrada:

> Você está offline — as mensagens serão enfileiradas
> As mensagens são armazenadas localmente e serão enviadas quando a conexão for restaurada.

O banner desaparece automaticamente assim que a conectividade retorna.

Indicadores de status da mensagem

Cada mensagem pendente mostra seu estado de entrega atual logo abaixo do balão:

• "Offline — enfileirando mensagens" (ícone de relógio) — a mensagem está na fila local, ainda não tentada
• "Entregando" (ícone giratório) — a entrega está sendo tentada (1-2 tentativas)
• "Falha ao enviar" + botão Repetir — após 3 tentativas falhadas, os clientes podem reativar manualmente a entrega

Flush automático ao reconectar

Quando o navegador recupera a conectividade, o widget escuta o evento online e imediatamente faz o flush da fila IndexedDB em ordem de sequência. O service worker também pode solicitar um flush via uma mensagem FLUSH_QUEUE, permitindo tentativas de entrega em segundo plano enquanto a aba está aberta.