Como migrar para CRM WhatsApp sem perder vendas — playbook com checklist e scripts

Migrar para CRM é um processo que precisa unir TI, comercial e operações para evitar perdas de vendas: este playbook dá passos claros para preservar histórico, treinar vendedores e manter SLAs durante a transição.

Decisão e preparo: quem participa, custos e regras do piloto

Stakeholders e responsabilidades

Defina os responsáveis antes do piloto. Exemplo mínimo:

• TI: integração, exportação/importação, testes E2E e rollback técnico.
• Líder comercial: seleção dos vendedores pilotos, acompanhamento de KPIs, scripts e reajustes.
• Operações/Suporte: gestão de HSM, comunicação externa e atendimento a casos críticos.
• PM: cronograma, checkpoints go/no-go e comunicação entre times.

Cálculo rápido de custo vs benefício (fórmula)

Use uma fórmula simples para justificar o piloto:

• custo_mensal = assinatura + (conversas × custo_por_conversa) + (custo_por_usuário × nº_usuários) + fees_BSP.

Coloque estimativas no documento de aprovação do piloto para comparar com ganhos previstos (redução de tempo médio de atendimento, aumento de taxa de contato em 24h, redução de churn).

Checklist pré-avaliação do fornecedor

Verifique antes de assinar:

• API vs App (API obrigatória para re-hydration e webhooks confiáveis).
• suporte a HSM/templates e aprovação de mensagens.
• limites de API, quotas e fees do BSP.
• rehosting de mídia e políticas de mídia.
• deduplicação e idempotência (message_id como chave).
• webhooks e retries.
• playbook de rollback do fornecedor e SLAs de suporte.

Escopo do piloto (recomendado)

• % de tráfego: 5–10%.
• número de vendedores: 2–5 (inclua 1–2 seniors).
• duração: 7–14 dias, com parallel run 48–72h no cutover.
• KPIs de aceitação: tempo médio de resposta, taxa de entrega HSM, erros webhook.

Checklist de dados e re-hydration do histórico

Para preservar contexto comercial, exporte e importe campos técnicos e comerciais padronizados. Recomendado usar CSV para tabelas e JSON para payloads de mensagens.

Campos técnicos mínimos (CSV/JSON)

• phone_number
• phone_id / wa_id
• conversation_id (original)
• original_message_id
• crm_conversation_id (vazio antes do re-hydration)
• crm_message_id
• message_timestamp (unix)
• delivery_status
• read_timestamp
• direction (in/out)
• message_text
• message_type (text/media/template)

Campos comerciais mínimos

• lead_owner
• lead_status (novo/qualificado/proposta/negociação/fechado)
• pipeline_stage
• origem_lead
• tags
• product_interest
• last_offer_sent
• pending_quote_id
• order_id
• total_value
• currency
• address
• preferred_payment
• notes
• last_interaction_by
• last_interaction_at

Tabela de mapeamento obrigatória

Mantenha uma tabela de mapping que relacione IDs originais com IDs do CRM destino:

• original_conversation_id, original_message_id, crm_conversation_id, crm_message_id, migrated_at, migrated_by.

Mídia e re-hosting

Para cada arquivo inclua: media_id_original, media_url_original, media_rehost_url, mime_type, filename, size_bytes, checksum_sha256. Faça o re-hosting em bucket/CDN antes de apontar links no CRM e armazene metadados.

Regras de deduplicação e idempotência

• Chave primária sugerida: phone_number + original_message_id.
• Fallback: phone_number + primeiros_30_chars_da_mensagem + timestamp_bucket (5 min).
• Exponha message_id como chave em webhooks e documente retries para garantir idempotência.

Formatos e amostras

• Use CSV para leads e metadata de conversas; JSON para payloads e mídia. Inclua amostras de 10 linhas no pacote de migração para homologação.

Cronograma de cutover e janela de parallel run (48–72h) com critérios go/no-go

Pré-cutover (-14 a -1 dias)

• Backups completos: DB dump e snapshot de mídia.
• Validação de HSM/templates.
• Aprovação das mensagens de aviso aos clientes.
• Teste E2E com 10 conversas reais instrumentadas.
• Treinamento rápido dos sellers pilotos.

Day 0 (cutover inicial)

• Último snapshot + export incremental.
• Ativar integração com CRM em modo leitura/escrita paralelo.
• Enviar HSM de aviso a base segmentada (clientes em contato ativo).

Parallel run (48–72h)

• Operar ambos sistemas em paralelo com webhooks duplicados para ambos.
• Monitorar idempotência e centralizar triagem de leads quentes em um canal único.

Checklist diário durante parallel run:

• saúde dos webhooks (<1% erros);
• correspondência de mensagens migradas (meta 95% match);
• SLA de resposta do time (>=90% meta inicial);
• taxa de entrega HSM e open rate.

Critérios go/no-go

Avance se:

• erro de webhook <1% por 1 hora;
• discrepância de histórico <2% em amostra de validação;
• SLA de resposta do time mantido >=90% nas primeiras 6 horas.

Se qualquer limite for ultrapassado, acione rollback imediato.

Playbook para o time de vendas: treinamento, scripts de transição e role-play

Currículo de adoção (mínimo)

• Day 0: acesso, credenciais e quick-start (60 min).
• Day 1: scripts principais e role-play (2h); primeiras conversas reais supervisionadas.
• Day 7: revisão de performance e ajustes de script.
• Day 30: avançado — automações, uso de IA e fallback.

KPIs mínimos durante adoção:

• tempo até 1ª resposta: 15 min para leads quentes; 60 min para leads mornos;
• taxa de fechamento por vendedor: queda alvo <10% no período de 30 dias;
• volume de escalonamentos manuais monitorado.

Scripts práticos (copie e use)

• Mensagem de aviso ao cliente (HSM):

"Olá, aqui é [Empresa]. A partir de hoje vamos responder pelo novo sistema para agilizar atendimento. Se você já está em contato, não precisa fazer nada — continuaremos sua conversa normalmente. Obrigado!"

• Handoff vendedor:

"Oi [Nome], sou [Seu nome], vou te acompanhar até finalizarmos o pedido. Posso confirmar os detalhes que tenho?"

• Conversa interrompida por mudança:

"Notamos que sua conversa foi movida para outro sistema — me chamo [Nome]. Se ainda tiver interesse, responda 'OK' e eu retomo seu pedido em 2 minutos."

Role-play e checagem

Treine pares com cenários reais: pedido em andamento, negociação com objeção e cliente sem resposta há 48h. Use script de 5 passos: saudação; confirmação do histórico; resumo da oferta; proposta de fechamento; CTA claro (pagar/agenda/confirmar).

Procedimento de escalonamento: se SLA violado (>15 min em lead quente), gerar alerta automático para supervisor e reassign imediato para senior.

SLA operacional e dashboard de monitoramento (métricas 0–30–60 dias)

SLAs recomendados:

• 1ª resposta leads quentes = 15 minutos;
• leads mornos = 60 minutos;
• leads frios = 24 horas;
• solicitações críticas (pagamento/atraso) = 1 hora.

Meta de cumprimento inicial: >=90%.

Alertas automáticos mínimos:

• SLA violado -> notificação no Slack/CRM + reassign;
• aumento de erros webhook >1% em 30 min -> notificação TI;
• queda de conversão por etapa >15% vs baseline em 24h -> reunião de crise.

Dashboard mínimo (0–30–60 dias):

• tempo médio de primeira resposta;
• taxa de fechamento por etapa do funil;
• taxa de abertura HSM;
• volume de mensagens falhadas;
• número de leads sem interação >48h;
• taxa de duplicidade/rollback detectada.

Checkpoints:

• 0–7 dias: estabilidade técnica e cumprimento de SLAs;
• 8–30 dias: performance comercial e conversão por etapa;
• 31–60 dias: otimização de scripts e automações com IA.

Contingência, rollback e próximos passos práticos

Rollback técnico rápido

T0: mantenha DB dump e snapshot. Se necessário reverter: restaurar snapshot, reativar integração antiga e re-hydrate mensagens recebidas no paralelo usando a tabela de mapping incremental.

Ações comerciais de contingência

• Exporte CSV com leads quentes (interagiram nas últimas 72h e lead_score >=X) e atribua a 3 seniors para follow-up imediato por telefone/WhatsApp Web antigo.

Scripts de comunicação para rollback:

• Aviso de reversão (HSM):

"Estamos temporariamente revertendo para o sistema anterior para garantir continuidade. Se você recebeu mensagens duplicadas, pedimos desculpas. Seu vendedor retomará contato em até 2 horas."

• Reengajamento para conversas interrompidas:

"Percebemos que houve uma mudança técnica. Quer que eu retome seu pedido agora? Responda 1 para sim."

Mitigações sem rollback: priorize manualmente conversas de maior valor (order_id com valor alto, propostas em aberto), faça chamadas telefônicas e envie HSMs para restabelecer confiança enquanto TI corrige a integração.

Testes de aceitação e próximos passos imediatos

Realize E2E de restauração, valide que mensagens do período paralelo aparecem no CRM antigo e cheque consistência de pedidos para evitar duplicidade de faturamento.

Três ações práticas para começar hoje:

• Exporte um lote de amostra de 7 dias (10–50 conversas) com todos os campos e faça re-hydration em homologação;
• Agende um piloto de 48–72h com 2 vendedores seniors e ative webhooks em paralelo;
• Prepare e submeta para aprovação as 3 mensagens HSM: aviso de migração, handoff e retomada de conversa.

Este playbook concentra decisões técnicas e operacionais que você e seu time podem seguir para migrar para CRM WhatsApp sem cair nas conversões. Siga os checkpoints, valide os mappings e priorize leads quentes em qualquer sinal de instabilidade.