# Envía leads a Salesforce

> Un lead del chat se convierte en un registro del objeto de Salesforce que elijas.

Source: https://welcomeai.dev/es/docs/salesforce
Category: Destinos
Updated: 2026-09-11

---
Salesforce es la única conexión de aquí con cuatro valores en vez de uno, y todos se crean una vez en
Salesforce. No hay botón de iniciar sesión: una connected app emite un refresh token, y esta ruta
cambia ese token por un token de vida corta de una hora en cada llamada.

## Qué necesitas

Una **connected app**, en Setup de Salesforce, con OAuth activado y dos permisos:

- `api` -- leer los objetos y sus campos, y crear el registro.
- `refresh_token` -- seguir funcionando sin que alguien vuelva a iniciar sesión cada hora.

De ella salen tres cosas: el **consumer key**, el **consumer secret** (los dos en *Manage consumer
details*) y un **refresh token**, que emite el flujo OAuth de la app la primera vez que alguien la
autoriza.

## Producción o sandbox

El cuarto valor. Un sandbox no inicia sesión en `login.salesforce.com`, sino en
`test.salesforce.com`, y un refresh token de sandbox presentado al host de producción se rechaza con
el mismo mensaje que uno revocado. Elige el correcto en la pantalla de conexión y toda esa clase de
confusión desaparece.

No hace falta que nos des una URL de instancia. Salesforce la devuelve junto al token de vida corta y
cada llamada se construye con lo que devolvió, que es también por lo que una conexión que funciona
hoy sigue funcionando si migran tu organización.

## Conecta y crea la ruta

1. En **Destinos**, conecta Salesforce con los cuatro valores.
2. Elige el **objeto**. Lead, Contacto, Cuenta, Oportunidad y Caso van primero; todo lo demás que
   exponga tu organización está bajo *Otros objetos* y *Objetos propios*.
3. Crea una **ruta**: qué leads toma y en qué objeto se convierten.
4. **Mapea los campos.** Se leen del describe de tu propia organización, así que lo que ves es lo que
   creó tu administrador, con los valores de lista que de verdad permite.

## Qué se envía

Solo campos que Salesforce marca como creables, y por eso un id, una fórmula o un rollup nunca
aparecen en el mapeador: fallarían en todos los leads.

Los valores toman la forma de cada tipo. Una lista tiene que coincidir con uno de sus propios valores
-- uno parecido se omite en vez de enviarse, porque un valor rechazado tumba el registro entero. Una
lista de selección múltiple se une con punto y coma, que es como lo guarda Salesforce. Una casilla
entiende sí, no, true, false, 1 y 0. Una fecha se convierte en `YYYY-MM-DD`.

**Un Lead necesita apellido y empresa.** Salesforce rechaza uno sin ellos, y el rechazo nombra el
campo de API, no la etiqueta que alguien mapeó. Los dos se rellenan con lo que traiga el lead cuando
el mapeo los deja fuera, así que una ruta nunca está a un campo de perder todos los leads.

## Qué no hace

Crea. No actualiza un registro existente y no ejecuta tus reglas de duplicados por ti: las reglas de
tu organización se aplican a esta inserción igual que a cualquier otra. Enganchar con un registro
existente exige decidir qué campo es la identidad, y eso preferimos preguntarlo antes que adivinarlo.