> ## Documentation Index > Fetch the complete documentation index at: https://help.treble.ai/llms.txt > Use this file to discover all available pages before exploring further. # Guia de Migração > Migre suas queries do Data Warehouse legado (client_analytics) para o Analytics Warehouse. # Migrando do Data Warehouse legado O warehouse legado (`client_analytics`) está **descontinuado**. Ele continua funcionando, sem alterações, durante o período de migração — você migra no seu próprio ritmo atualizando duas coisas nas suas queries: o **nome do banco de dados** e, onde mudaram, os **nomes de tabelas e colunas**. Suas credenciais e o host de conexão também podem mudar; seu Account Manager confirmará. O banco de dados legado `client_analytics` será desativado após o período de migração. Todas as integrações novas devem ser construídas apenas contra `treble_client_analytics`. ## Mapeamento de tabelas | Legado (`client_analytics`) | Novo (`treble_client_analytics`) | Observações | | ------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | `fact_sessions` | `fact_treble_sessions` | Adiciona `trigger_keyword`, `last_node_id`; `inbound_outbound` → `direction` | | `fact_inbound_messages` | `fact_treble_sessions` filtrada por `direction = 'INBOUND'` | Absorvida — mesmos dados, uma só tabela | | `fact_deployment_status` | `fact_campaign_sends` | `timestamps_eta` → `scheduled_at`; `timestamp_*` → `*_at` | | `fact_deployment_daily` | `fact_campaign_daily` | Mesmas fórmulas, mesmas colunas | | `fact_conversations` | `fact_agent_conversations` | Histórico completo (o legado mantinha uma janela móvel de 3 meses); adiciona transfer\_count, campos de atribuição e mais | | `fact_agent_messages` | `fact_agent_conversation_messages` | | | `fact_redirections` | `fact_agent_conversation_transfers` | | | `fact_agent_status_changes` | `fact_agent_status_changes` | Mesmo nome | | `fact_agent_daily` | `fact_agent_daily` | Mesmo nome, mesmas fórmulas | | `fact_hsm_responses` | `fact_hsm_responses` | Mesmo nome | | `fact_target_events` | `fact_target_events` | Mesmo nome | | `fact_whatsapp_links` | `fact_whatsapp_link_events` | | | `dim_agents`, `dim_tags`, `dim_teams`, `dim_agent_tags` | Mesmos nomes | | | `dim_hsm` | `dim_hsms` | Pluralizada | | `session_variables` | `fact_treble_session_variables` | Agora disponível para todos | | — | `fact_treble_session_messages` | **Nova** — rastro completo da conversa | | — | `fact_treble_session_nodes` | **Nova** — percurso nó a nó | | — | `fact_ad_sessions` | **Nova** — atribuição Click-to-WhatsApp | | — | `dim_polls`, `dim_channels`, `dim_poll_nodes` | **Novas** dimensões | ## Renomeações de colunas para ficar de olho | Legado | Novo | Onde | | -------------------------------------------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------- | | `inbound_outbound` | `direction` | sessões | | `campaign_name` | `poll_name` | conversas de agentes (`poll_name` é o único nome usado em todo lugar agora) | | `timestamps_eta` | `scheduled_at` | envios de campanha | | `timestamp_delivered` / `_responded` / `_failure` / `_success` | `delivered_at` / `responded_at` / `failed_at` / `succeeded_at` | envios de campanha | | `answer_id` | `answer_option_id` | nós de fluxo (identifica a opção escolhida) | ## Diferenças de comportamento que você deve conhecer 1. **Histórico completo.** O warehouse legado limitava a maioria das tabelas a uma janela móvel de 3 meses. O novo warehouse serve tudo. Se suas queries dependiam dessa janela como filtro implícito, adicione filtros de data explícitos (bom também para a performance). 2. **"Hoje" mais atualizado, consolidação declarada.** Os dados chegam em minutos em vez de horas, e os números de um dia se consolidam completamente em até 48 horas (veja [o contrato de dados](/pt/docs/data-warehouse-v2/welcome#o-contrato-de-dados)). Durante uma comparação de migração, você pode ver o novo warehouse ligeiramente *à frente* do legado no dia mais recente — isso é atraso de atualização do legado, não uma discrepância. 3. **Mensagens de conversas apagadas são excluídas** de `fact_agent_conversation_messages` por design (a conversa à qual pertencem não existe mais). 4. **O enriquecimento de contato em conversas antigas congela.** `helpdesk_contact_id` e `contact_wa_id` em conversas de agentes com mais de 90 dias mantêm o valor que tinham — mudanças no CRM não se propagam mais retroativamente para elas. 5. **Dois refinamentos de fórmula documentados** em `fact_agent_daily`: o tempo de primeira resposta agora vem do cálculo da própria plataforma, e as médias de CSAT consideram apenas conversas com avaliação (`rating != 0`). Ambos são correções; a paridade histórica foi verificada antes do lançamento. 6. **Sem aliases.** Os nomes legados não são espelhados no novo banco de dados — o mapeamento acima é aplicado uma vez, nas suas queries, e os dois sistemas coexistem enquanto você faz isso. ## Caminho de migração sugerido 1. Aponte uma cópia do seu dashboard/relatório para `treble_client_analytics` usando o mapeamento acima. 2. Rode as duas versões lado a lado por alguns dias; espere correspondências exatas nos dias consolidados. 3. Faça a troca, mantendo filtros de data explícitos. 4. Avise seu Account Manager quando você não usar mais o `client_analytics` — isso nos ajuda a programar a desativação.