O Robô preenche e corrige dados do Contato e da Empresa na conversa

Visão geral

Durante um atendimento a pessoa costuma corrigir e completar os próprios dados: "na verdade meu e-mail é outro", "anota meu CNPJ para a nota fiscal", "mudei para Niterói". Antes, o Robô conseguia ler o perfil inteiro e não podia corrigir nada — alguém precisava reler a conversa depois e redigitar no cadastro.

Agora o Robô escreve esses dados enquanto conversa. São seis capacidades: três para o Contato e três para a Empresa.

Três garantias sustentam isso: o Robô só registra o que a pessoa acabou de informar, o contato é sempre o desta conversa (ele não consegue escrever no cadastro de outra pessoa), e toda escrita bem-sucedida deixa uma nota de auditoria na conversa.

Pré-requisitos

• Maestro habilitado e um Robô configurado no inbox.
• Nível de autonomia definido no Robô — ele decide se a escrita executa direto ou fica aguardando aprovação (veja "Configurações & opções").
• As três capacidades de Contato são internas: já vêm ligadas em todo Robô e por isso não aparecem na lista de ferramentas para marcar.
• As três de Empresa são ferramentas normais e precisam estar marcadas na configuração do Robô: crm_org_update, crm_org_set_fiscal e crm_org_set_address.
• Marque também crm_list_organizations: é por ela que o Robô descobre qual empresa atualizar. Sem essa consulta, ele não tem como identificar o registro e não escreve nada.
• O módulo Empresas precisa estar disponível na conta.

Passo a passo

1. Abra a configuração do Robô e confirme o modo de autonomia.
2. Na lista de ferramentas, marque as de Empresa (crm_org_update, crm_org_set_fiscal, crm_org_set_address) e a consulta crm_list_organizations. As de Contato já estão ativas.
3. Salve e atenda normalmente. Quando a pessoa informar um dado — "pode anotar meu CPF:…" —, o Robô registra no cadastro.
4. No modo Híbrido (Exigir aprovação), a escrita fica parada e vira um cartão de aprovação no painel do Maestro, com uma nota privada mencionando o responsável. Abra e escolha Aprovar ou Rejeitar. No Piloto automático, ela executa direto.
5. Confira o resultado no perfil do contato (ou na ficha da empresa) e a nota de auditoria registrada na conversa.

Configurações & opções

Campos do Contato

O Robô escolhe entre endereço principal e endereço de cobrança conforme o contexto da conversa. Se a pessoa disser explicitamente que é o endereço da nota fiscal, diga isso na conversa — é o que orienta a escolha.

Campos da Empresa

Autonomia: não existe chave nova

As seis capacidades entram como ações sensíveis — exatamente o mesmo tratamento das escritas de CRM, Agenda e Pagamentos. Ou seja:

Não há um interruptor separado só para dados de contato: quem governa é o nível de autonomia do Robô.

Casos de uso

• Emitir nota fiscal: o cliente passa o CNPJ e o endereço no meio da conversa; o cadastro já sai pronto para o faturamento.
• Fechar contrato: razão social e CNPJ da empresa registrados na hora, sem alguém redigitar do histórico depois.
• Cobrança: e-mail e telefone corrigidos no momento em que a pessoa avisa que mudaram — o link de pagamento passa a chegar no lugar certo.
• Entrega: endereço de cobrança separado do endereço principal.
• Qualificação B2B: setor, porte e estágio comercial da empresa preenchidos a partir do que o contato conta, alimentando segmentos e relatórios.

Dicas, limites e boas práticas

• Documento já salvo volta mascarado — e o Robô se recusa a regravá-lo. Um CPF/CNPJ armazenado é devolvido na leitura como ***. Se o Robô tentasse "confirmar" esse valor mascarado, ele sobrescreveria o documento real por uma máscara. Por isso ele recusa e pede que a pessoa informe o documento. O Robô só grava documento que acabou de ouvir na conversa.
• Endereço parcial é mesclado, nunca substituído. Se a pessoa disser só a cidade, o CEP e a rua que já estavam salvos continuam lá. O mesmo vale para qualquer campo: o que não foi dito mantém o valor guardado. Uma resposta incompleta não apaga cadastro.
• O contato é sempre o desta conversa. O Robô não aceita apontar para o cadastro de outra pessoa — é assim que o documento de um cliente deixaria de cair na ficha de outro.
• A empresa, sim, é identificada por busca. Se a conta tiver duas empresas de nome parecido, peça ao contato o nome completo ou o CNPJ antes de mandar atualizar — a escrita é feita no registro que o Robô encontrou.
• A nota de auditoria só aparece quando a ação deu certo. Se a escrita falhou, não existe nota afirmando que foi feita.
• Comece no Híbrido. Dado de identidade é sensível: revise algumas aprovações antes de migrar para o Piloto automático.

Solução de problemas

• "O Robô disse que anotou, mas o campo não mudou": o modo é Híbrido e a ação está parqueada. Abra o painel do Maestro na conversa e aprove.
• "O documento não foi gravado": o valor enviado estava mascarado (foi lido do cadastro, não informado pela pessoa). Peça o documento na conversa e registre de novo.
• "O Robô não atualiza a empresa": as ferramentas de Empresa não estão marcadas na configuração do Robô, ou falta a consulta crm_list_organizations para localizar o registro.
• "O endereço ficou incompleto": o Robô grava só o que foi dito. Peça as partes que faltam — elas serão somadas ao que já existe, sem apagar nada.
• "Atualizou a empresa errada": havia mais de um registro com nome parecido. Corrija na ficha da empresa e, da próxima vez, confirme o nome completo ou o CNPJ antes.
• "Quero que ele pare de mexer no cadastro": use Copiloto (nada sai sem você) ou desmarque as ferramentas de Empresa. As de Contato seguem o nível de autonomia do Robô.

Veja também

• Modos de autonomia do Robô e aprovação humana (HITL)
• Ferramentas do Maestro por módulo
• Verificação do que o Robô afirma antes de enviar
• Dados fiscais e endereço do contato (CPF/CNPJ, cobrança)
• Empresas (companies) e vínculo com contatos