Skip to content

Automação de Tradução no Chat (Workers AI & D1)

Tradução Simultânea & Persistência de Mensagens

Section titled “Tradução Simultânea & Persistência de Mensagens”

O Prime Crown oferece tradução simultânea bidirecional de mensagens no chat entre clientes e funcionárias, garantindo comunicação sem barreiras de idioma (ex: Inglês ↔ Português).


🌐 1. Fluxo da Tradução Automática com Cache no D1

Section titled “🌐 1. Fluxo da Tradução Automática com Cache no D1”
sequenceDiagram
    autonumber
    actor Staff as Funcionária (App em Português)
    participant UI as ServiceChatMessage (React)
    participant API as /api/channels/:id/translate
    participant AI as Cloudflare Workers AI (Llama 3.2 1B)
    participant D1 as Cloudflare D1 (translations_json)

    Staff->>UI: Abre o Chat com mensagem em Inglês do cliente
    UI->>UI: Verifica se já existe tradução em 'pt-BR' na mensagem
    alt Tradução já existe no objeto da mensagem (D1 Cache)
        UI-->>Staff: Exibe texto em Português direto do D1 (Selo "Traduzido")
    else Primeira vez que a mensagem é visualizada no idioma
        UI->>AI: Solicita tradução para 'pt-BR'
        AI-->>UI: Retorna texto traduzido
        UI->>API: POST /api/channels/:id/translate (salva no banco)
        API->>D1: UPDATE chat_messages (set translations_json)
        UI-->>Staff: Exibe texto traduzido + botão "(Ver original)"
    end

    Note over Staff, UI: Alternância Visual
    Staff->>UI: Clica em "(Ver original)"
    UI-->>Staff: Exibe texto original em Inglês + botão "(Ver tradução)"

🔒 2. Garantias de Performance e Custo Zero

Section titled “🔒 2. Garantias de Performance e Custo Zero”
  1. Zero Chamadas Duplicadas: A primeira pessoa que visualizar a mensagem no idioma aciona a IA. A partir desse momento, a tradução é salva permanentemente no D1 em formato JSON (translations_json: {"pt-BR": "...", "en-GB": "..."}).
  2. Workers AI (Llama 3.2 1B): As traduções utilizam o modelo ultra-rápido do Cloudflare Workers AI (10.000 requisições diárias gratuitas).
  3. Alternância Instantânea: A troca entre o texto traduzido e o texto original é feira em tempo real no estado local do React, sem recarregar a página.