Salesforce

Visão geral

Conecte seus agentes de IA da ElevenLabs ao Salesforce CRM para acessar dados de clientes, gerenciar leads e criar oportunidades. Essa integração permite que seus agentes recuperem registros de clientes existentes, criem novos leads e contatos e consultem objetos do Salesforce durante conversas.

Recursos

Configuração

Esta integração usa Credenciais de Cliente OAuth 2.0 do Salesforce para autenticação. Você precisará criar um App de Cliente Externo no Salesforce.

Vídeo de demonstração

Como funciona

Configurações das ferramentas

Há três ferramentas de webhook disponíveis: salesforce_search_records, salesforce_get_record e salesforce_create_record. Configure a autorização de cada uma usando uma Workplace Auth Connection.

Autorização - conexão OAuth2 do Workplace

{
  "grant_type": "client_credentials"
}

Configurações das ferramentas de webhook

Adicione uma Workplace Auth Connection (OAuth2) a cada ferramenta na seção Authentication. Use as abas abaixo para analisar a configuração de cada ferramenta.

{
  "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 comuns do Salesforce

Consultas SOQL comuns

Use estas consultas SOQL como ponto de partida ao personalizar o prompt de sistema do seu agente. Todas as consultas retornam informações legíveis para humanos, em vez de IDs técnicos:

Buscar contatos por e-mail

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

Buscar leads por e-mail ou telefone

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

Buscar contas por nome

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

Buscar oportunidades recentes

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

Buscar oportunidades por conta

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

Teste da integração

Depois de configurar seu External Client App e conectar a integração, teste-a antes de implantá-la em produção:

1. Funcionalidade de busca: peça ao seu agente para buscar contatos existentes.
2. Criação de registros: peça ao seu agente para criar um novo lead ou contato.
3. Recuperação de dados: verifique se seu agente consegue recuperar informações detalhadas dos clientes.

Acionador de comentários de caso: respostas por e-mail para Email-to-Case

Se você ativou o acionador Salesforce Case Comment (resposta automática do agente para Cases do Service Cloud), as respostas a Cases com pelo menos um e-mail recebido são enviadas de volta ao cliente como um e-mail real, encadeado — não apenas como um comentário interno no Case. Isso se baseia em o Case ter um e-mail recebido, e não no valor da lista de seleção Origin do Case; portanto, continua funcionando corretamente se sua organização usar um valor personalizado de Origin, como “Email - Returns”, em vez do valor literal “Email”. Cases sem e-mail recebido continuam sendo publicados como um comentário público no Case, sem alterações. Quaisquer endereços em CC no e-mail original do cliente também são automaticamente incluídos em CC na resposta, assim como aconteceria com o “Responder a todos” de um agente humano — exceto pelos endereços de roteamento de Email-to-Case da sua organização, que são deliberadamente excluídos do CC para que a resposta não seja reprocessada pelo Email-to-Case e não acione novamente o agente em sua própria mensagem.

O envio de respostas por e-mail exige algumas configurações adicionais além das necessárias apenas para comentários de Case:

• O Perfil ou Conjunto de permissões do usuário Run As precisa ter a permissão de sistema Send Email ativada (Setup > Users > Profiles, em System Permissions), além da permissão API Enabled já exigida para a integração.
• A configuração Email Deliverability da sua organização (Setup > Email > Deliverability) deve permitir e-mails externos — os Sandboxes usam por padrão uma configuração restrita, que bloqueia silenciosamente e-mails enviados.
• Se quiser que as respostas sejam enviadas de um alias de suporte em vez da própria caixa de correio do usuário Run As, defina o campo Org-Wide Email Address Id no acionador com o Id de um Organization-Wide Email Address (Setup > Organization-Wide Addresses > clique no endereço > copie o Id da URL). Deixe em branco para enviar do próprio endereço do usuário Run As.
• Defina o campo Email-to-Case Routing Address(es) no acionador com os endereços de Email-to-Case da sua organização (separados por vírgula, caso haja mais de um, Setup > Email-to-Case). Sem isso, a integração tentará adivinhar o endereço de roteamento a partir do e-mail do cliente (seu endereço To), o que não abrange casos em que seu endereço de roteamento estava apenas em CC, e não como destinatário principal — incluí-lo novamente em CC em uma resposta nessa situação acionaria novamente o agente em sua própria mensagem.

Se a organização de um cliente não tiver essas configurações, uma falha no envio do e-mail fará com que um comentário público no Case seja publicado como alternativa, para que uma resposta nunca seja descartada silenciosamente — mas o cliente não a receberá por e-mail até que as configurações acima sejam concluídas.

Considerações de segurança

• Use endpoints HTTPS para todas as chamadas de API.
• Garanta que a segurança adequada em nível de campo esteja configurada no Salesforce.
• As permissões do usuário Run As determinam quais dados a integração pode acessar — defina o escopo delas adequadamente.
• Audite regularmente o acesso e o uso da API.

Links úteis

• Documentação da API REST do Salesforce
• Referência da linguagem de consulta SOQL
• External Client Apps e OAuth 2.0
• Práticas recomendadas de segurança do Salesforce