Quais campos do CRM você pode confiar à IA
O que eu faria se depois de cada ligação a IA preenchesse automaticamente vinte campos do CRM. Eu deixaria um rascunho: resumo da conversa, próximo passo e uma citação. Stage, valor e forecast continuam confirmados pelo manager.
O erro que eu eliminaria primeiro: A falha mais chata: várias integrações escrevem no mesmo campo e depois ninguém sabe o valor original. O CRM parece organizado por fora enquanto o histórico de decisões some.
O que preparar e que resultado esperar
- Resultado: O card fica mais claro, o histórico de mudanças é preservado e campos manuais não são sobrescritos por várias integrações.
- Nas configurações do CRM abra Properties/Fields e adicione ai_summary_draft, ai_next_action, ai_confidence, source_event_id e review_status.
- Mantenha dados de origem e direitos de acesso separados do resultado para auditar o que a camada de IA no CRM realmente fez.
- Reproduza o mesmo event_id e confira o histórico do card: deve haver uma única execução de processamento, e a nota original deve permanecer.
Adicione IA ao CRM sem quebrar o histórico
- Separe o rascunho da fonte da verdade
No construtor de Workflow escolha record updated, adicione AI: extract from note/email e armazene o texto original em um campo separado. A IA só escreve em campos ai_*.
Проверьте: Stage manual, valor, responsável e consent não mudam.
Если не сработало: Desative escritas da IA e deixe só o modo rascunho.
- Restrinja valores permitidos
Para stage, priority e review_status defina uma lista de valores. Se a IA retornar um valor fora da lista — não preencha em automático; envie para review_required.
Проверьте: Uma resposta inválida não continua no workflow.
Если не сработало: Adicione uma etapa de validação separada antes de Update record.
- Torne as execuções idempotentes
Antes de processar, busque source_event_id. Se já existir no histórico — pare; se não — escreva com data e nome da fonte.
Проверьте: Um webhook repetido não duplica notas e tarefas.
Если не сработало: Verifique se o id é criado no lado do evento, não regenerado dentro da etapa de IA.
- Deixe o manager aceitar a proposta
Na notificação mostre o valor antigo, a proposta da IA e o texto original. Um botão ou o campo review_status deve registrar de forma explícita approve ou reject.
Проверьте: O histórico mostra quem aceitou a decisão e por quê.
Если не сработало: Mantenha mudanças manuais no CRM obrigatórias e a IA só como dica.
Campos que eu adicionaria ao CRM
Crie ai_summary_draft, ai_next_action, ai_confidence, source_event_id e review_status. Os dois primeiros são para o manager; source_event_id bloqueia duplicatas; review_status cuida de approve/reject. Mantenha stage, amount, owner e consent manuais ou sob regras do CRM.
No workflow, antes de Update record adicione uma checagem: confidence abaixo de 0.75 ou valor enum desconhecido → status review_required. Não corrija em automático texto livre onde o CRM espera um de cinco valores permitidos.
- Mantenha a nota original ao lado do resumo da IA.
- Um webhook repetido com o mesmo source_event_id deve parar.
Como é uma notificação útil
Mostre o valor antigo, a proposta da IA, uma citação da nota e dois botões: approve e reject. O log deve guardar actor, timestamp, source_event_id e valor final. Um mês depois você depura não só erros do modelo, mas também das regras.
Onde criar campos no HubSpot
Abra `Settings → Data Management → Properties → Create property`. Crie `AI summary` e `AI evidence` como multi-line text, `AI suggested stage` e `AI review status` como enumeration, `AI suggested amount` como number, `Next step due` como date, `Last AI run ID` como single-line text.
Statuses: `draft_update → needs_review → approved/rejected → applied/error`. Antes de `Update record` confira se stage está no enum, se confidence está acima do limiar e se `Last AI run ID` ainda não foi processado.
{
"summary": "",
"next_step": "",
"suggested_stage": null,
"suggested_amount": null,
"evidence_quotes": [],
"requires_review": true
}A aprovação deve mostrar o antigo e o novo
Na notificação imprima o valor antigo, a proposta da IA, uma citação da transcrição e links para o deal e a fonte. Approve deve escrever `approved_by`, `approved_at` e `execution_id`; reject — `rejection_reason`. Se o webhook tentar de novo, a segunda execução para em `transcript_id + deal_id`.
Onde deixar uma proposta vs uma decisão
| Critério | Pergunta | Bom sinal |
|---|---|---|
| Input | O que entra exatamente na camada de IA do CRM? | Nas configurações do CRM abra Properties/Fields e adicione ai_summary_draft, ai_next_action, ai_confidence, source_event_id e review_status. |
| Ação | O que o sistema tem permissão de fazer sozinho? | Somente ações pré-listadas, sem acesso a toda a conta |
| Verificação | Como saber que o resultado é aceitável? | Reproduza o mesmo event_id e confira o histórico do card: deve haver uma única execução de processamento, e a nota original deve permanecer. |
| Falha | Para onde vai um caso pouco claro? | Pare o workflow, deixe o card inalterado e envie ao manager um link para a nota original e o erro da integração. |
O que deve mudar depois da configuração
O card fica mais claro, o histórico de mudanças é preservado e campos manuais não são sobrescritos por várias integrações.
Por que o CRM vira rápido um lixão de campos de IA
Várias integrações escrevendo no mesmo campo ao mesmo tempo.
Manter só o resumo da IA e apagar a nota original.
Confiar em texto livre onde o CRM espera um enum.
Não tornar o processamento do webhook idempotente.
Quando a integração é melhor desenhada à parte
Chame um especialista quando o CRM estiver ligado a várias fontes, precisar de acesso por papéis ou o histórico completo de mudanças importar.
O que esclarecer antes de conectar IA ao CRM
Quais campos não devem mudar automaticamente?
Valor, responsável, stage do deal, consentimentos, status jurídicos e tudo que dispare dinheiro ou obrigações.
Como escolher a fonte da verdade?
Atribua um sistema como dono de cada campo e declare explicitamente a direção da sincronização.
É preciso um resumo de IA?
Só se reduzir o tempo de leitura e um link para a nota original ficar ao lado.
Como testar uma execução repetida?
Envie o mesmo event_id duas vezes e confira se o card mudou só uma vez.
