## 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**.

| O que o Robô preenche | Onde |
|---|---|
| Nome, e-mail, telefone, identificador externo e país | Contato |
| CPF/CNPJ (identidade fiscal) e tipo de pessoa | Contato |
| Endereço principal **ou** endereço de cobrança | Contato |
| Razão social, site, domínio, setor, porte, estágio comercial, e-mail, telefone, fuso e descrição | Empresa |
| CNPJ e razão social (identidade fiscal) | Empresa |
| Endereço da empresa | 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

| Campo | Formato esperado |
|---|---|
| Nome | Texto |
| E-mail | Endereço de e-mail |
| Telefone | E.164, com código do país (ex.: `+5521999999999`) |
| Identificador | O id externo dessa pessoa no seu sistema |
| País | ISO-3166 alfa-2 (ex.: `BR`) |
| CPF/CNPJ | Os dígitos como a pessoa informou; o tipo (`cpf`/`cnpj`) pode ser deduzido |
| Tipo de pessoa | Física ou jurídica |
| Endereço | Rua, número, complemento, bairro, cidade, UF, CEP e país |
| Endereço de cobrança | Os mesmos campos, gravados separadamente do endereço principal |

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

| Campo | Observação |
|---|---|
| Nome fantasia | Nome comercial |
| Razão social | Nome registrado |
| Domínio / Site | `acme.com` / URL completa |
| Setor | Segmento de atuação |
| Porte | Faixa de funcionários (ex.: `11-50`) |
| Estágio comercial | Ex.: lead, cliente |
| E-mail e telefone | Telefone em E.164 |
| Fuso horário | Padrão IANA (ex.: `America/Sao_Paulo`) |
| Descrição | Texto curto sobre a empresa |
| CNPJ e razão social | Identidade fiscal, para faturar ou colocar em contrato |
| Endereço | Rua, número, complemento, bairro, cidade, UF, CEP e país |

### 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:

| Modo do Robô | O que acontece com a escrita |
|---|---|
| **Piloto automático** | Executa direto. |
| **Híbrido (Exigir aprovação)** | Fica **parada** aguardando aprovação humana, no mesmo painel de sempre. |
| **Copiloto** | Nada sai sem você revisar. |

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)](/hc/ajuda/articles/maestro-brain-autonomia-e-aprovacao-humana-pt-br)
- [Ferramentas do Maestro por módulo](/hc/ajuda/articles/maestro-brain-ferramentas-maestro-por-modulo-pt-br)
- [Verificação do que o Robô afirma antes de enviar](/hc/ajuda/articles/maestro-brain-verificacao-do-que-o-robo-afirma-pt-br)
- [Dados fiscais e endereço do contato (CPF/CNPJ, cobrança)](/hc/ajuda/articles/contacts-crm-dados-fiscais-e-endereco-pt-br)
- [Empresas (companies) e vínculo com contatos](/hc/ajuda/articles/contacts-crm-empresas-pt-br)