> ## Documentation Index
> Fetch the complete documentation index at: https://wavecnct.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce

> Sincroniza los contactos de Wave en Salesforce como Leads o Contactos

<Info>
  Disponible en los planes **Pro**, **Teams** y **Enterprise**.
</Info>

La integración con Salesforce sincroniza los contactos de Wave en Salesforce como Leads o Contactos, a tu elección durante la configuración. Wave utiliza un campo de ID externo personalizado para hacer upserts de registros, evitando duplicados incluso si ya existe un registro. Se admiten tanto entornos de producción como sandbox de Salesforce.

## Cómo conectar

<Steps>
  <Step title="Abre la integración">
    Ve a **Integraciones → Salesforce**.
  </Step>

  <Step title="Elige un tipo de registro">
    Elige si sincronizar los contactos como **Leads** o **Contactos**.
  </Step>

  <Step title="Activa la sincronización automática (opcional)">
    Activa la **Sincronización automática** para importar todos los contactos existentes de Wave de inmediato.
  </Step>

  <Step title="Conectar Salesforce">
    Haz clic en **Conectar** e inicia sesión en tu cuenta de Salesforce.
  </Step>
</Steps>

Wave solicita acceso sin conexión (para mantener la conexión activa sin inicios de sesión repetidos) y acceso de lectura/escritura para crear y actualizar registros en Salesforce.

## Qué se sincroniza

| Campo de Wave                | Campo de Salesforce                           |       Leads      | Contactos |
| ---------------------------- | --------------------------------------------- | :--------------: | :-------: |
| Nombre                       | `FirstName`                                   |        Sí        |     Sí    |
| Apellido                     | `LastName`                                    |        Sí        |     Sí    |
| Correo electrónico principal | `Email`                                       |        Sí        |     Sí    |
| Teléfono principal           | `Phone`                                       |        Sí        |     Sí    |
| Cargo                        | `Title`                                       |        Sí        |     Sí    |
| Empresa                      | `Company`                                     | Sí (obligatorio) |     -     |
| Nota del contacto            | `Description`                                 |        Sí        |     Sí    |
| Origen del lead              | `LeadSource` = "Wave Connect"                 |        Sí        |     -     |
| Miembro del equipo asignado  | `OwnerId` (emparejado por correo electrónico) |        Sí        |     Sí    |

**Dirección de sincronización**: Wave → Salesforce (solo saliente)

**Cuándo sincroniza**: en tiempo real al crear, actualizar o eliminar un contacto

## Funcionalidades

* **Leads o Contactos**: elige el tipo de registro de Salesforce que se adapte a tu flujo de trabajo.
* **Compatibilidad con sandbox**: conéctate a un entorno sandbox de Salesforce para pruebas.
* **Sincronización automática al conectar**: importa todos los contactos existentes de Wave en la primera conexión.
* **Deduplicación**: un campo de ID externo personalizado (`WaveConnectId__c`) se crea automáticamente y se usa para upserts, por lo que la resincronización nunca crea duplicados.
* **Asignación de propietario**: los contactos se asignan al usuario de Salesforce cuyo correo electrónico coincide con el miembro del equipo de Wave.

## Agregar manualmente el campo de ID externo

Wave normalmente crea el campo de ID externo `WaveConnectId__c` automáticamente al conectar. Solo necesitas este paso si te conectas **sin una cuenta de administrador de Salesforce**, ya que crear un campo personalizado requiere permisos de administrador. En ese caso, pide a tu administrador de Salesforce que agregue el campo manualmente como respaldo.

<Steps>
  <Step title="Abre el objeto Lead">
    En **Configuración** de Salesforce, abre el **Administrador de objetos** y selecciona el objeto **Lead**.
  </Step>

  <Step title="Verifica si el campo existe">
    En **Campos y relaciones**, comprueba si `WaveConnectId__c` ya existe.
  </Step>

  <Step title="Crea el campo">
    Si no existe, haz clic en **Nuevo**, selecciona **Texto** como tipo de campo y asígnale un nombre para que el nombre de API sea `WaveConnectId__c`.
  </Step>

  <Step title="Configura la seguridad a nivel de campo">
    Confirma que **Usuario estándar** tenga acceso de lectura/escritura al campo.
  </Step>

  <Step title="Agrega a los diseños de página y guarda">
    Agrega el campo a los diseños de página relevantes y guarda.
  </Step>
</Steps>

<Note>
  Si el campo ya existe, ábrelo y selecciona **Establecer seguridad a nivel de campo** para confirmar que **Usuario estándar** tiene acceso de lectura/escritura. Para más detalles, consulta la [guía de configuración de Salesforce](https://support.wavecnct.com/en/articles/10492839-salesforce).
</Note>

## Limitaciones y requisitos

* El campo personalizado `WaveConnectId__c` se crea automáticamente en tu cuenta de Salesforce. No lo elimines ni cambies su nombre. Se utiliza para la deduplicación.
* Para los Leads, el campo `Company` es obligatorio en Salesforce. Si un contacto de Wave no tiene empresa, el valor predeterminado es `N/A`.
* Si Salesforce detecta un duplicado mediante sus reglas de duplicados, Wave anula la regla y guarda el registro.
* La coincidencia de propietario se hace por correo electrónico. Si no se encuentra ningún usuario de Salesforce coincidente, el contacto se guarda sin propietario.

## Desconectar

Ve a **Integraciones → Salesforce** y haz clic en **Desconectar**. Esto elimina la integración y revoca el acceso de Wave. Los registros ya sincronizados en Salesforce no se eliminan.