> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/es/solucion-de-problemas/crm-integration/crm-lead-field-sync.md).

# Cómo se sincronizan los campos de leads con tu CRM

Cuando la sincronización con el CRM está habilitada y configurada, Patagon AI envía automáticamente los datos guardados del lead mientras el agente procesa la conversación. Los campos de identidad estándar se envían automáticamente, mientras que los demás atributos requieren un mapeo de campo del CRM o una plantilla de solicitud personalizada. La sincronización no se limita a leads calificados ni a cambios de estado.

## Cuándo ocurre la sincronización

Patagon AI inicia una sincronización después de procesar correctamente nuevos datos de la conversación. El envío se realiza en segundo plano, por lo que puede tardar un poco, y los fallos temporales se vuelven a intentar automáticamente.

No es necesario que un lead se califique ni que cambie de estado para que ocurra una sincronización.

## Qué se sincroniza

| Categoría                              | Qué se envía                                                        | Condición                                                                          |
| -------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Identidad estándar                     | Nombre, apellido, email y teléfono                                  | Se envían automáticamente. Las conexiones de ApiDeck requieren los cuatro valores. |
| Atributos personalizados y del sistema | El valor guardado del atributo                                      | El atributo tiene un valor y un mapeo en **Campo del CRM**.                        |
| Atributos de valor fijo                | El valor fijo configurado                                           | El atributo tiene un mapeo en **Campo del CRM**.                                   |
| Campos HTTP personalizados             | Cualquier atributo disponible al que se haga referencia por su slug | La plantilla de solicitud configurada determina qué campos se envían.              |

Los valores de selección múltiple se envían como texto separado por comas. Los números y los valores de sí/no también se envían como texto cuando se usan en campos personalizados del CRM. Los valores vacíos se omiten.

## Cómo mapear un atributo a un campo del CRM

1. Ve a **Agente > Atributos**.
2. Edita el atributo que quieres sincronizar.
3. Abre **Más opciones**.
4. Selecciona el destino en **Campo del CRM**.
5. Guarda el atributo.

Los atributos de valor fijo mapeados se sincronizan igual que los demás atributos mapeados. Cambiar un mapeo no actualiza de inmediato los registros existentes del CRM; el nuevo mapeo se aplica en la próxima sincronización que corresponda. Contacta a soporte si necesitas completar o repetir la sincronización de datos históricos.

## Crear o actualizar

En la primera sincronización correcta, Patagon AI crea o encuentra el lead o contacto en tu CRM y guarda el ID de su registro en el CRM. Las sincronizaciones posteriores usan ese ID para actualizar el mismo registro en lugar de crear un duplicado.

## Qué no se sincroniza y por qué

Es posible que algunos campos o leads no se sincronicen cuando:

* Un atributo no tiene un mapeo en **Campo del CRM**.
* El valor está vacío o todavía no se ha capturado.
* La sincronización está desactivada, no hay un destino activo o la conexión, las credenciales o la configuración no son válidas.
* A una conexión de ApiDeck le falta un dato de identidad obligatorio: nombre, apellido, email o teléfono.
* Cambiaste un mapeo, pero desde entonces no se ha procesado ninguna conversación que pueda activar la sincronización.
* El destino automático configurado no es una entidad de contacto o lead compatible.

La puntuación de calificación, la asignación y todas las columnas que aparecen en el panel de Patagon AI no son campos predeterminados universales. Solo se envían cuando la conexión, el mapeo de atributos o la plantilla de solicitud personalizada incluyen los datos correspondientes.

## Ejemplo

Supongamos que mapeas el atributo **Presupuesto** de Patagon AI al campo `annual_budget` del CRM. Cuando la conversación capture un presupuesto, la próxima sincronización enviará ese valor. Si todavía no hay un presupuesto, Patagon AI no enviará ese campo.

## Si falta un campo

1. Confirma que la sincronización con el CRM esté habilitada y que el destino esté activo.
2. Comprueba que el lead tenga todos los campos de identidad que requiere tu conexión.
3. Abre el atributo y confirma su mapeo en **Campo del CRM**.
4. Confirma que el atributo tenga un valor guardado.
5. Si cambiaste el mapeo recientemente, espera a la próxima actualización de conversación que pueda activar la sincronización.
6. Para una conexión HTTP personalizada, comprueba que la plantilla de solicitud haga referencia al slug del atributo.

Si el campo sigue sin aparecer, contacta a <support@patagon.ai>. Incluye el nombre del CRM, un lead de ejemplo y el atributo de Patagon AI y el campo del CRM que faltan. Nunca envíes contraseñas, claves de API ni otros secretos.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/es/solucion-de-problemas/crm-integration/crm-lead-field-sync.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
