Salesforce

Descripción general

Conecta tus agentes de IA de ElevenLabs con Salesforce CRM para acceder a datos de clientes, gestionar clientes potenciales y crear oportunidades. Esta integración permite a tus agentes recuperar registros de clientes existentes, crear nuevos clientes potenciales y contactos, y consultar objetos de Salesforce durante las conversaciones.

Funcionalidades

Configuración

Esta integración utiliza Salesforce OAuth 2.0 Client Credentials para la autenticación. Tendrás que crear una aplicación de cliente externa en Salesforce.

Vídeo de demostración

Cómo funciona

Configuraciones de herramientas

Hay disponibles tres herramientas webhook: salesforce_search_records, salesforce_get_record y salesforce_create_record. Configura la autorización de cada una mediante una conexión de autenticación de Workplace.

Autorización: conexión OAuth2 de Workplace

{
  "grant_type": "client_credentials"
}

Configuraciones de herramientas webhook

Añade una conexión de autenticación de Workplace (OAuth2) a cada herramienta en la sección Authentication. Usa las pestañas de abajo para revisar la configuración de cada herramienta.

{
  "type": "webhook",
  "name": "salesforce_search_records",
  "description": "Searches for existing records in Salesforce using SOQL queries. Always returns human-readable names and details, not just IDs.",
  "api_schema": {
    "url": "https://acme.my.salesforce.com/services/data/v58.0/query/",
    "method": "GET",
    "path_params_schema": [],
    "query_params_schema": [
      {
        "id": "q",
        "type": "string",
        "description": "SOQL query string to search for records. Always include Name fields and other human-readable information. Example: SELECT Id, Name, Email, Phone, Company FROM Contact WHERE Email = 'customer@example.com'. For Opportunities, include: SELECT Id, Name, StageName, Amount, CloseDate, Account.Name FROM Opportunity",
        "dynamic_variable": "",
        "constant_value": "",
        "required": true,
        "value_type": "llm_prompt"
      }
    ],
    "request_body_schema": null,
    "request_headers": [
      {
        "type": "value",
        "name": "Content-Type",
        "value": "application/json"
      }
    ]
  },
  "response_timeout_secs": 30,
  "dynamic_variables": {
    "dynamic_variable_placeholders": {}
  }
}

Objetos comunes de Salesforce

Consultas SOQL habituales

Usa estas consultas SOQL como punto de partida para personalizar el prompt del sistema de tu agente. Todas las consultas devuelven información legible para las personas en lugar de ID técnicos:

Buscar contactos por correo electrónico

SELECT Id, Name, Email, Phone, Title, Account.Name, Account.Type FROM Contact WHERE Email = 'customer@example.com'

Buscar leads por correo electrónico o teléfono

SELECT Id, Name, Email, Phone, Company, Industry, Status, LeadSource, Title FROM Lead WHERE Email = 'customer@example.com' OR Phone = '+1234567890'

Buscar cuentas por nombre

SELECT Id, Name, Type, Industry, Phone, BillingCity, BillingState, Website FROM Account WHERE Name LIKE '%Company Name%'

Buscar oportunidades recientes

SELECT Id, Name, StageName, Amount, CloseDate, Account.Name, Account.Type, Owner.Name, Description FROM Opportunity WHERE CreatedDate = THIS_MONTH

Buscar oportunidades por cuenta

SELECT Id, Name, StageName, Amount, CloseDate, Probability, NextStep, Owner.Name FROM Opportunity WHERE Account.Name LIKE '%Company Name%'

Pruebas de integración

Después de configurar tu aplicación de cliente externa y conectar la integración, pruébala antes de implementarla en producción:

1. Función de búsqueda: Pide a tu agente que busque contactos existentes.
2. Creación de registros: Haz que tu agente cree un nuevo lead o contacto.
3. Obtención de datos: Comprueba que tu agente puede recuperar información detallada de clientes.

Activador de comentarios de casos: respuestas por correo electrónico para Email-to-Case

Si has activado el desencadenante Salesforce Case Comment (respuesta automática del agente a casos de Service Cloud), las respuestas a casos con al menos un correo electrónico entrante se envían al cliente como un correo electrónico real con hilo, no solo como un comentario interno del caso. Esto depende de si el caso tiene un correo electrónico entrante, no del valor de la lista de selección Origin del caso, por lo que seguirá funcionando correctamente si tu organización usa un valor personalizado de Origin como “Email - Returns” en lugar de “Email” literalmente. Los casos sin correo electrónico entrante seguirán publicándose como comentarios de caso públicos, sin cambios. Las direcciones en CC en el correo electrónico original del cliente también se incluirán automáticamente en CC en la respuesta, igual que haría la opción «Responder a todos» de un agente humano, salvo las direcciones de enrutamiento de Email-to-Case de tu organización, que se excluyen deliberadamente de la CC para evitar que Email-to-Case vuelva a procesar la respuesta y active de nuevo al agente con su propio mensaje.

Enviar respuestas por correo electrónico requiere una configuración adicional a la necesaria solo para los comentarios de casos:

• El perfil o conjunto de permisos del usuario Run As debe tener activado el permiso de sistema Send Email (Setup > Users > Profiles, en System Permissions), además del permiso API Enabled que ya requiere la integración.
• La configuración Email Deliverability de tu organización (Setup > Email > Deliverability) debe permitir correo electrónico externo. Los sandboxes establecen de forma predeterminada una configuración restringida, que bloquea silenciosamente los correos salientes.
• Si quieres que las respuestas se envíen desde un alias de soporte en lugar del buzón del usuario Run As, establece el campo Org-Wide Email Address Id del desencadenante con el Id de una Organization-Wide Email Address (Setup > Organization-Wide Addresses > haz clic en la dirección > copia el Id de la URL). Déjalo en blanco para enviar desde la propia dirección del usuario Run As.
• Establece el campo Email-to-Case Routing Address(es) del desencadenante con las direcciones de Email-to-Case de tu organización (separadas por comas si hay más de una, Setup > Email-to-Case). Sin esto, la integración intenta deducir la dirección de enrutamiento a partir del correo electrónico del cliente (su dirección To), lo que falla cuando tu dirección de enrutamiento solo estaba en CC y no era la destinataria principal. Incluirla de nuevo en CC en una respuesta en esa situación activaría otra vez al agente con su propio mensaje.

Si la organización de un cliente no tiene esto configurado, un error al enviar el correo electrónico recurrirá a publicar un comentario de caso público, por lo que nunca se perderá una respuesta silenciosamente; sin embargo, el cliente no la recibirá por correo electrónico hasta que se configure lo anterior.

Consideraciones de seguridad

• Usa rutas HTTPS para todas las llamadas a la API.
• Asegúrate de que la seguridad adecuada a nivel de campo esté configurada en Salesforce.
• Los permisos del usuario Run As determinan a qué datos puede acceder la integración; delimítalos adecuadamente.
• Audita periódicamente el acceso y el uso de la API.

Enlaces útiles

• Documentación de la API REST de Salesforce
• Referencia del lenguaje de consultas SOQL
• Aplicaciones de cliente externas y OAuth 2.0
• Prácticas recomendadas de seguridad de Salesforce