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

# Salesforce

> Opera ventas, servicio, campañas y actividad comercial de Salesforce desde tus flujos en Brain Studio.

**Salesforce** es un CRM enterprise diseñado para organizaciones con procesos complejos de ventas, servicio y marketing. A diferencia de CRMs más ligeros como Pipedrive o HubSpot, Salesforce opera sobre un modelo de datos altamente configurable con SOQL, SOSL, objetos personalizados, Knowledge Base y automatización nativa.

En **Brain Studio**, la integración expone **46 tools** que permiten crear y actualizar registros, abrir casos, mover oportunidades, registrar actividad y consultar el CRM directamente desde la conversación. El pipeline, los casos de soporte y la actividad comercial reflejan lo que realmente pasó en el canal, sin reingreso manual.

## Qué habilita Salesforce

Al conectar **Salesforce**, puedes:

* **Operar el núcleo comercial** sobre cuentas, contactos, clientes potenciales y oportunidades
* **Gestionar campañas** y la membresía de contactos y leads
* **Abrir y seguir casos** de soporte con comentarios y lecturas asociadas
* **Registrar actividad y colaboración**: tareas, eventos, notas, correo, plantillas y Chatter
* **Consultar y explorar datos** con búsquedas, SOQL y SOSL
* **Trabajar objetos de forma genérica** o en **lote** cuando el volumen o la flexibilidad lo exijan
* **Apoyar conocimiento y administración**: artículos, categorías, usuarios, BLOB y metadatos de campos

***

## Instalación

### Requisitos previos

1. Una **organización de Salesforce** con los objetos y permisos que vayas a usar (ventas, servicio, campañas, etc.).
2. Capacidad para **autorizar una aplicación conectada** (OAuth), según las políticas de tu administrador.
3. Una edición de Salesforce con **API Access** habilitado (Compatibilidad con ediciones **Enterprise**, **Unlimited**, **Developer** y **Performance**).
4. Claridad sobre si vas a conectar una **Production Instance** o una **Sandbox Instance**, ya que el modal de instalación te pedirá elegir una de las dos.

### Cómo conectarla

La forma más directa es usar [**Jelou Agent**](/guides/getting-started/jelou-agent): describe lo que necesitas y el agente conecta **Salesforce** automáticamente dentro del flujo.

Si prefieres instalar manualmente, sigue estos pasos en el **Marketplace**. La conexión usa **OAuth de Salesforce** — eliges instancia de producción o sandbox e inicias sesión; no necesitas copiar credenciales.

<Steps>
  <Step title="Abrir el Marketplace">
    En Brain Studio, abre **Marketplace** desde el menú lateral.
  </Step>

  <Step title="Buscar Salesforce">
    Encuentra la integración y haz clic en **Conectar**.
  </Step>

  <Step title="Elegir el tipo de instancia">
    En el modal de instalación, selecciona si vas a conectar una **Production Instance** o una **Sandbox Instance**.
  </Step>

  <Step title="Autorizar con Salesforce">
    Completa el flujo OAuth con tu cuenta de Salesforce.
  </Step>

  <Step title="Confirmar instalación">
    La integración aparecerá como **conectada**.

    <Check>
      Puedes usarla en **Canvas** o agregarla como herramienta en **AI Agent**.
    </Check>
  </Step>
</Steps>

***

## Tools disponibles

La integración expone **46 tools**. Las agrupamos por **función** en Salesforce; los nombres coinciden con los que verás en Brain Studio.

<AccordionGroup>
  <Accordion title="CRM comercial">
    Cubre el **ciclo comercial** sobre cuentas, personas, clientes potenciales y oportunidades, más **adjuntos** ligados al registro.

    **Tools incluidas**

    * Crear Cuenta
    * Actualizar cuenta
    * Crear contacto
    * Actualizar Contacto
    * Crear cliente potencial
    * Crear Oportunidad
    * Actualizar Oportunidad
    * Eliminar Oportunidad
    * Crear adjunto

    **Cuándo usar esta categoría**

    * Cuando el chat debe **reflejar** altas o cambios en el **pipeline** y en el **maestro** de clientes
    * Cuando necesitas **documentar** la relación con **adjuntos** sobre el registro adecuado
    * Cuando el flujo **cierra o descarta** una oportunidad de forma explícita
  </Accordion>

  <Accordion title="Campañas">
    Vincula **contactos** y **leads** a **campañas** y permite **crear** campañas nuevas.

    **Tools incluidas**

    * Agregar contacto a la campaña
    * Agregar Lead a la Campaña
    * Crear campaña

    **Cuándo usar esta categoría**

    * Cuando el origen o la respuesta en conversación debe **atribuirse** a una campaña de marketing o ventas
    * Cuando necesitas **incorporar** a un contacto o lead ya existente en una **campaña activa**
    * Cuando el proceso debe **dar de alta** la campaña antes de asociar miembros
  </Accordion>

  <Accordion title="Casos y soporte">
    Opera el **servicio** sobre **casos**: creación, lectura y **comentarios** para seguimiento.

    **Tools incluidas**

    * Crear Caso
    * Obtener Caso
    * Crear comentario de caso
    * Listar comentarios del caso

    **Cuándo usar esta categoría**

    * Cuando el usuario **reporta** un incidente o solicitud y debe quedar **caso** en Salesforce
    * Cuando necesitas **recuperar** el caso o su **hilo de comentarios** antes de responder
    * Cuando el flujo debe **añadir** una actualización visible en el caso
  </Accordion>

  <Accordion title="Actividad y colaboración">
    Deja **constancia** de trabajo comercial y **comunicación**: timeline, correo, plantillas y **Chatter**.

    **Tools incluidas**

    * Crear Evento
    * Crear Nota
    * Crear Nota de Contenido
    * Crear Tarea
    * Publicar un mensaje en el feed de Chatter
    * Listar Mensajes de Correo Electrónico
    * Listar Plantillas de Correo Electrónico
    * Actualizar plantilla de correo electrónico
    * Enviar correo electrónico

    **Cuándo usar esta categoría**

    * Cuando quieres que Salesforce refleje **reuniones, tareas o notas** tras la conversación
    * Cuando necesitas **consultar o ajustar plantillas** y **enviar** correo desde el flujo
    * Cuando el equipo usa **Chatter** para visibilidad rápida del avance
  </Accordion>

  <Accordion title="Consultas y búsqueda">
    **Explora** el CRM con búsquedas y lenguajes de consulta nativos.

    **Tools incluidas**

    * Buscar registros
    * Buscar Registros de Objetos
    * Consulta SOQL
    * Búsqueda SOSL

    **Cuándo usar esta categoría**

    * Cuando necesitas **filtrar** u **obtener conjuntos** de registros con criterios precisos
    * Cuando el agente o el flujo debe **validar** si existe un registro antes de crear otro
    * Cuando la lógica depende de **consultas** alineadas con reportes o reglas de negocio en Salesforce
  </Accordion>

  <Accordion title="Operaciones genéricas sobre objetos">
    Trabaja **cualquier objeto** soportado por la tool cuando no basta una acción específica, más utilidades de **integración**.

    **Tools incluidas**

    * Crear Registro
    * Obtener registro por ID
    * Actualizar registro
    * Eliminar registro
    * Crear o actualizar registro
    * Convertir un objeto XML de SOAP a JSON

    **Cuándo usar esta categoría**

    * Cuando el objeto o los campos **no tienen** una tool dedicada en la lista anterior
    * Cuando necesitas **upsert** u operaciones **CRUD** genéricas con el modelo estándar de la integración
    * Cuando conviertes **respuestas SOAP** para seguir el flujo en JSON
  </Accordion>

  <Accordion title="Bulk / operaciones masivas">
    Acelera **altas y cambios** de **cuentas** y **oportunidades** en volumen.

    **Tools incluidas**

    * Crear cuentas (por lotes)
    * Actualizar Cuentas (Por Lotes)
    * Crear Oportunidades (Por Lotes)
    * Actualización de Oportunidades (Lote)

    **Cuándo usar esta categoría**

    * Cuando sincronizas **muchos** registros desde otro sistema o desde una importación conversacional estructurada
    * Cuando el caso **no** justifica llamadas una a una por rendimiento o coste de API
    * Cuando tu proceso ya agrupa filas listas para **procesamiento masivo**
  </Accordion>

  <Accordion title="Knowledge y administración">
    Soporta **base de conocimiento**, **usuarios**, **BLOB** y **metadatos** de objetos.

    **Tools incluidas**

    * Obtener Artículos de Conocimiento
    * Obtener Grupos de Categorías de Datos de Conocimiento
    * Listar Artículos de la Base de Conocimiento
    * Obtener usuario
    * Crear usuario
    * Insertar datos BLOB
    * Listar campos del objeto

    **Cuándo usar esta categoría**

    * Cuando el flujo debe **mostrar o enrutar** con artículos de conocimiento
    * Cuando necesitas **consultar o crear usuarios** en el marco de tu proceso
    * Cuando trabajas **contenido binario** o necesitas **introspección** de campos del objeto en el editor
  </Accordion>
</AccordionGroup>

***

## Cómo usar en Brain

### En AI Agent

Úsalo cuando la conversación sea **abierta**: el usuario puede mezclar intenciones (consultar con SOQL, crear cliente potencial, abrir caso). El agente elige la tool dentro del subconjunto que habilites.

<Steps>
  <Step title="Abre el nodo AI Agent">
    En el Canvas, selecciona o añade el nodo **AI Agent**.
  </Step>

  <Step title="Abre Herramientas">
    En el panel derecho, entra a la pestaña **Herramientas**.
  </Step>

  <Step title="Agrega Salesforce">
    Usa **Agregar tool**, busca **Salesforce** y actívala.
  </Step>

  <Step title="Configura las tools">
    Limita las acciones a lo que el agente debe poder hacer (por ejemplo solo casos y consultas en un canal de soporte).

    <Check>
      **Salesforce** aparece en la lista de herramientas del agente; ajusta permisos desde el icono de ajustes de la integración.
    </Check>
  </Step>
</Steps>

### En Canvas

Úsalo cuando el proceso sea **determinista**: pasos fijos (validar → crear registro → enviar correo → notificar), con ramas según memoria o respuestas del usuario.

<Steps>
  <Step title="Arrastra Salesforce al Canvas">
    En el panel lateral, abre **Marketplace** y arrastra **Salesforce** al flujo.
  </Step>

  <Step title="Selecciona la tool">
    Con el nodo seleccionado, en **Tools** elige la acción (por ejemplo **Crear cliente potencial** o **Consulta SOQL**).
  </Step>

  <Step title="Configura el cuerpo y la memoria">
    Completa el JSON en el editor del nodo y, si aplica, **Guardar respuesta** en variables de memoria para los nodos siguientes.
  </Step>

  <Step title="Conecta el flujo">
    Enlaza **Finalizó la tarea** y **Hubo un error** con la lógica comercial o de soporte que definas.

    <Check>
      Cada nodo ejecuta una sola tool; el orden del Canvas es tu proceso.
    </Check>
  </Step>
</Steps>

El editor muestra la forma esperada del cuerpo según la tool. El ejemplo siguiente es **orientativo** para **Crear cliente potencial**; ajústalo a los campos obligatorios de tu org y a tus variables de memoria.

```json theme={null}
{
  "FirstName": "{{$memory.nombre}}",
  "LastName": "{{$memory.apellido}}",
  "Email": "{{$memory.correo}}",
  "Company": "{{$memory.empresa}}",
  "LeadSource": "WhatsApp"
}
```

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Captación y calificación de leads desde canales conversacionales">
    El contacto entra por **WhatsApp**, webchat o un canal interno; el flujo lo convierte en un **lead utilizable** dentro de Salesforce, con contexto suficiente para que ventas continúe sin reingresar información.

    **Flujo típico:**

    * El usuario inicia la conversación y entrega sus datos o interés comercial
    * El flujo crea el **cliente potencial** y, si corresponde, lo asocia a una **campaña**
    * Si ya existe un registro relacionado, en vez de duplicarlo, lo actualiza o continúa sobre el objeto correcto
    * El equipo comercial recibe el lead ya estructurado en Salesforce

    **Impacto:**

    * Menos leads perdidos entre canal y CRM
    * Mejor trazabilidad del origen comercial
    * Menos carga operativa para SDRs, ejecutivos o revenue ops

    **Ideal para:**
    Equipos comerciales que captan demanda desde canales conversacionales y usan Salesforce como sistema central de seguimiento.
  </Accordion>

  <Accordion title="Avance del pipeline comercial sin salir del canal">
    Cada hito relevante de la conversación puede reflejarse en **oportunidades, tareas, notas o actividad**, haciendo que el pipeline muestre el estado real de la negociación y no una foto atrasada.

    **Flujo típico:**

    * El prospecto confirma interés, acepta avanzar o entrega información clave
    * El flujo crea o actualiza la **oportunidad**
    * Añade una **nota**, una **tarea** o un **evento** para dejar trazabilidad del siguiente paso
    * El equipo ve el avance directamente en Salesforce, sin depender de actualización manual posterior

    **Impacto:**

    * Pipeline más confiable para forecast y gestión comercial
    * Menos desfase entre lo conversado y lo registrado
    * Mejor visibilidad para managers y líderes de ventas

    **Ideal para:**
    Equipos enterprise con procesos comerciales más estructurados, varias etapas y necesidad de disciplina operativa.
  </Accordion>

  <Accordion title="Apertura y seguimiento de casos de soporte desde el mismo flujo">
    Cuando el cliente reporta un problema o una solicitud, el flujo puede **abrir el caso**, enriquecerlo con comentarios y recuperar su historial para continuar el soporte sin romper contexto.

    **Flujo típico:**

    * El usuario describe el problema en la conversación
    * El flujo crea el **caso** en Salesforce
    * Añade **comentarios** o consulta los comentarios ya existentes si el ticket continúa
    * El equipo de soporte trabaja sobre un caso ya documentado y el cliente mantiene continuidad en el canal

    **Impacto:**

    * Menos casos perdidos o mal documentados
    * Mejor continuidad entre conversación y Service Cloud
    * Menos fricción para soporte y customer success

    **Ideal para:**
    Organizaciones que ya operan soporte en Salesforce y quieren llevar ese mismo nivel de control a canales conversacionales.
  </Accordion>

  <Accordion title="Consulta interna del CRM por chat para equipos comerciales o de soporte">
    Ejecutivos, managers o agentes internos pueden consultar por chat el estado de **cuentas, contactos, oportunidades, casos o campañas** sin entrar primero a la consola de Salesforce.

    **Flujo típico:**

    * Un usuario interno pregunta por una cuenta, oportunidad o caso
    * El flujo usa **búsquedas**, **SOQL**, **SOSL** o consultas por ID según el nivel de precisión requerido
    * Devuelve el estado actual, contexto relevante o el registro exacto para tomar acción
    * Si hace falta, el mismo flujo continúa con una actualización, nota, tarea o correo

    **Impacto:**

    * Acceso más rápido a información crítica del CRM
    * Menos cambio de contexto para el equipo
    * Salesforce se vuelve más útil como fuente de verdad operativa, no solo como sistema de registro

    **Ideal para:**
    Equipos de ventas, soporte o liderazgo que toman decisiones rápidas desde canales internos o móviles.
  </Accordion>
</AccordionGroup>

***

## Integraciones que combinan bien con Salesforce

<AccordionGroup>
  <Accordion title="Gmail">
    Después de crear un lead, mover una oportunidad o abrir un caso en Salesforce, el flujo puede enviar automáticamente un correo de seguimiento o confirmación desde la cuenta conectada de Gmail.

    **Flujo combinado:** caso abierto en Salesforce → correo de confirmación al cliente con número de caso y próximos pasos.

    [Documentación de Gmail](/guides/integraciones/productividad/gmail)
  </Accordion>

  <Accordion title="Calendly">
    Cuando el flujo comercial necesita mover una oportunidad y cerrar una reunión al mismo tiempo, Salesforce conserva el contexto del pipeline y Calendly resuelve la reserva con disponibilidad real.

    **Flujo combinado:** lead calificado en Salesforce → enlace de Calendly para discovery call → registro de actividad en Salesforce al confirmarse la cita.

    [Documentación de Calendly](/guides/integraciones/agendamiento/calendly)
  </Accordion>

  <Accordion title="Slack">
    Brain puede actualizar Salesforce y, en el mismo flujo, notificar al equipo por Slack. Cada lead enterprise, caso urgente o cambio crítico en una oportunidad se convierte en una alerta inmediata.

    **Flujo combinado:** oportunidad movida a "Negociación" en Salesforce → alerta a #ventas-enterprise en Slack con monto y cuenta.

    [Documentación de Slack](/guides/integraciones/productividad/slack)
  </Accordion>

  <Accordion title="Google Sheets">
    Para comités, QA o forecast, el flujo puede exportar extractos del pipeline o de casos a una hoja compartida sin dar acceso directo a Salesforce.

    **Flujo combinado:** consulta SOQL de oportunidades en Salesforce → actualizar hoja de forecast semanal en Sheets.

    [Documentación de Google Sheets](/guides/integraciones/productividad/google-sheets)
  </Accordion>
</AccordionGroup>

***

## Artículos relacionados

<CardGroup cols={2}>
  <Card title="Integraciones" href="/guides/integraciones/integraciones" icon="grid">
    Catálogo de integraciones disponibles en el Marketplace.
  </Card>

  <Card title="Cómo usar integraciones en Brain" href="/guides/integraciones/como-usar-integraciones-en-brain" icon="book-open">
    Flujo general para instalar y usar integraciones en Brain Studio.
  </Card>
</CardGroup>