## Visión general

Durante una atención la persona suele corregir y completar sus propios datos: *"en realidad mi correo
es otro"*, *"anota mi documento para la factura"*, *"me mudé de ciudad"*. Antes, el **Robot** podía
**leer** el perfil entero y no corregir **nada** — alguien tenía que releer la conversación después y
volver a escribirlo en el registro.

Ahora el Robot **escribe** esos datos mientras conversa. Son **seis capacidades**: tres para el
**Contacto** y tres para la **Empresa**.

| Lo que el Robot completa | Dónde |
|---|---|
| Nombre, correo, teléfono, identificador externo y país | Contacto |
| Documento fiscal (CPF/CNPJ) y tipo de persona | Contacto |
| Dirección principal **o** dirección de facturación | Contacto |
| Razón social, sitio, dominio, sector, tamaño, etapa comercial, correo, teléfono, zona horaria y descripción | Empresa |
| Documento fiscal (CNPJ) y razón social | Empresa |
| Dirección de la empresa | Empresa |

Tres garantías lo sostienen: el Robot solo registra lo que la persona **acaba de informar**, el
contacto es siempre el **de esta conversación** (no puede escribir en el registro de otra persona), y
toda escritura exitosa deja una **nota de auditoría** en la conversación.

## Requisitos previos

- **Maestro habilitado** y un Robot configurado en la bandeja.
- **Nivel de autonomía definido** en el Robot — él decide si la escritura se ejecuta directamente o
  queda esperando aprobación (ver "Configuración y opciones").
- Las tres capacidades de **Contacto** son **internas**: ya vienen activas en todo Robot y por eso
  **no aparecen** en la lista de herramientas para marcar.
- Las tres de **Empresa** son herramientas normales y **deben estar marcadas** en la configuración del
  Robot: `crm_org_update`, `crm_org_set_fiscal` y `crm_org_set_address`.
- Marca también `crm_list_organizations`: es por ahí que el Robot descubre **cuál** empresa
  actualizar. Sin esa consulta no puede identificar el registro y no escribe nada.
- El módulo **Empresas** debe estar disponible en la cuenta.

## Paso a paso

1. Abre la configuración del **Robot** y confirma el **modo de autonomía**.
2. En la lista de herramientas, marca las de Empresa (`crm_org_update`, `crm_org_set_fiscal`,
   `crm_org_set_address`) y la consulta `crm_list_organizations`. Las de Contacto ya están activas.
3. **Guarda** y atiende normalmente. Cuando la persona informe un dato — *"anota mi documento:…"* —,
   el Robot lo registra en el registro.
4. En el modo **Híbrido (Exigir aprobación)** la escritura queda **detenida** y se convierte en una
   **tarjeta de aprobación** en el panel del Maestro, con una nota privada que menciona al
   responsable. Ábrela y elige **Aprobar** o **Rechazar**. En **Piloto automático** se ejecuta
   directamente.
5. Verifica el resultado en el **perfil del contacto** (o en la **ficha de la empresa**) y la **nota
   de auditoría** registrada en la conversación.

## Configuración y opciones

### Campos del Contacto

| Campo | Formato esperado |
|---|---|
| Nombre | Texto |
| Correo | Dirección de correo electrónico |
| Teléfono | E.164, con código de país (ej.: `+5521999999999`) |
| Identificador | El id externo de esa persona en tu sistema |
| País | ISO-3166 alfa-2 (ej.: `BR`) |
| Documento fiscal | Los dígitos tal como los dio la persona; el tipo (`cpf`/`cnpj`) puede deducirse |
| Tipo de persona | Física o jurídica |
| Dirección | Calle, número, complemento, barrio, ciudad, provincia/estado, código postal y país |
| Dirección de facturación | Los mismos campos, guardados aparte de la dirección principal |

El Robot elige entre la **dirección principal** y la **dirección de facturación** según el contexto de
la conversación. Si la persona dice explícitamente que es la dirección de la factura, que quede dicho
en la conversación — eso es lo que guía la elección.

### Campos de la Empresa

| Campo | Observación |
|---|---|
| Nombre comercial | Nombre de marca |
| Razón social | Nombre registrado |
| Dominio / Sitio | `acme.com` / URL completa |
| Sector | Segmento de actividad |
| Tamaño | Rango de empleados (ej.: `11-50`) |
| Etapa comercial | Ej.: lead, cliente |
| Correo y teléfono | Teléfono en E.164 |
| Zona horaria | Estándar IANA (ej.: `America/Sao_Paulo`) |
| Descripción | Texto corto sobre la empresa |
| Documento fiscal y razón social | Identidad fiscal, para facturarla o ponerla en un contrato |
| Dirección | Calle, número, complemento, barrio, ciudad, provincia/estado, código postal y país |

### Autonomía: no hay un interruptor nuevo

Las seis capacidades entran como **acciones sensibles** — exactamente el mismo tratamiento que las
escrituras de CRM, Agenda y Pagos. Es decir:

| Modo del Robot | Qué pasa con la escritura |
|---|---|
| **Piloto automático** | Se ejecuta directamente. |
| **Híbrido (Exigir aprobación)** | Queda **detenida** esperando aprobación humana, en el panel de siempre. |
| **Copiloto** | Nada sale sin que tú lo revises. |

No hay un interruptor aparte solo para datos de contacto: quien gobierna es el **nivel de autonomía
del Robot**.

## Casos de uso

- **Emitir una factura**: el cliente pasa el documento y la dirección en plena conversación, y el
  registro queda listo para facturar.
- **Cerrar un contrato**: razón social y documento de la empresa registrados en el momento, sin que
  nadie los reescriba después desde el historial.
- **Cobranza**: correo y teléfono corregidos en cuanto la persona avisa que cambiaron — el enlace de
  pago empieza a llegar al lugar correcto.
- **Entrega**: dirección de facturación separada de la dirección principal.
- **Calificación B2B**: sector, tamaño y etapa comercial de la empresa completados a partir de lo que
  cuenta el contacto, alimentando segmentos e informes.

## Consejos, límites y buenas prácticas

- **Un documento ya guardado vuelve enmascarado — y el Robot se niega a reescribirlo.** Un documento
  almacenado se devuelve en la lectura como `***`. Si el Robot intentara "confirmar" ese valor
  enmascarado, sobrescribiría el documento real con una máscara. Por eso **se niega** y pide que la
  persona informe el documento. El Robot solo guarda un documento que acaba de oír en la conversación.
- **Una dirección parcial se fusiona, nunca se reemplaza.** Si la persona dice solo la ciudad, el
  código postal y la calle ya guardados **siguen ahí**. Lo mismo vale para cualquier campo: **lo que
  no se dijo mantiene su valor guardado**. Una respuesta incompleta no borra el registro.
- **El contacto es siempre el de esta conversación.** El Robot no admite apuntar al registro de otra
  persona — así es exactamente como el documento de un cliente terminaría en la ficha de otro.
- **La empresa, en cambio, se identifica por búsqueda.** Si la cuenta tiene dos empresas de nombre
  parecido, pide al contacto el nombre completo o el documento antes de mandar actualizar — la
  escritura cae en el registro que el Robot encontró.
- **La nota de auditoría solo aparece cuando la acción salió bien.** Si la escritura falló, no hay
  nota afirmando que se hizo.
- **Empieza en Híbrido.** El dato de identidad es sensible: revisa algunas aprobaciones antes de pasar
  a Piloto automático.

## Solución de problemas

- **"El Robot dijo que lo anotó, pero el campo no cambió"**: el modo es **Híbrido** y la acción está
  **detenida**. Abre el panel del Maestro en la conversación y **aprueba**.
- **"El documento no se guardó"**: el valor enviado estaba **enmascarado** (leído del registro, no
  informado por la persona). Pide el documento en la conversación y regístralo de nuevo.
- **"El Robot no actualiza la empresa"**: las herramientas de Empresa **no están marcadas** en la
  configuración del Robot, o falta la consulta `crm_list_organizations` para localizar el registro.
- **"La dirección quedó incompleta"**: el Robot guarda **solo lo que se dijo**. Pide las partes que
  faltan — se suman a lo que ya existe, sin borrar nada.
- **"Actualizó la empresa equivocada"**: había más de un registro con nombre parecido. Corrígelo en la
  ficha de la empresa y, la próxima vez, confirma el nombre completo o el documento antes.
- **"Quiero que deje de tocar el registro"**: usa **Copiloto** (nada sale sin ti) o desmarca las
  herramientas de Empresa. Las de Contacto siguen el nivel de autonomía del Robot.

## Ver también

- [Modos de autonomía del Robot y aprobación humana (HITL)](/hc/ajuda/articles/maestro-brain-autonomia-e-aprovacao-humana-es)
- [Herramientas de Maestro por módulo y cómo habilitarlas](/hc/ajuda/articles/maestro-brain-ferramentas-maestro-por-modulo-es)
- [Verificación de lo que afirma el Robot antes de enviar](/hc/ajuda/articles/maestro-brain-verificacao-do-que-o-robo-afirma-es)
- [Datos fiscales y dirección del contacto (documento, facturación)](/hc/ajuda/articles/contacts-crm-dados-fiscais-e-endereco-es)
- [Empresas y vínculo con contactos](/hc/ajuda/articles/contacts-crm-empresas-es)