Salesforce

Overzicht

Koppel je ElevenLabs AI-agents aan Salesforce CRM om klantgegevens te raadplegen, leads te beheren en kansen te maken. Met deze integratie kunnen je agents bestaande klantrecords ophalen, nieuwe leads en contacten maken en Salesforce-objecten tijdens gesprekken opvragen.

Mogelijkheden

Instellen

Deze integratie gebruikt Salesforce OAuth 2.0 Client Credentials voor authenticatie. Je moet een External Client App maken in Salesforce.

Demovideo

Zo werkt het

Toolconfiguraties

Er zijn drie webhooktools beschikbaar: salesforce_search_records, salesforce_get_record en salesforce_create_record. Configureer voor elk de autorisatie met een Workplace Auth Connection.

Autorisatie - Workplace OAuth2-verbinding

{
  "grant_type": "client_credentials"
}

Webhooktoolconfiguraties

Voeg in de sectie Authentication een Workplace Auth Connection (OAuth2) toe aan elke tool. Gebruik de onderstaande tabbladen om de configuratie van elke tool te bekijken.

{
  "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": {}
  }
}

Veelvoorkomende Salesforce-objecten

Veelvoorkomende SOQL-query’s

Gebruik deze SOQL-query’s als uitgangspunt wanneer je de system prompt van je agent aanpast. Alle query’s geven leesbare informatie terug in plaats van technische ID’s:

Contacten zoeken op e-mailadres

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

Leads zoeken op e-mailadres of telefoonnummer

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

Accounts zoeken op naam

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

Recente opportunities zoeken

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

Opportunities zoeken op account

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

Integratie testen

Test de integratie nadat je je External Client App hebt ingesteld en de integratie hebt verbonden, voordat je deze in productie neemt:

1. Zoekfunctionaliteit: Laat je agent zoeken naar bestaande contacten.
2. Record maken: Laat je agent een nieuwe lead of contact maken.
3. Gegevens ophalen: Controleer of je agent gedetailleerde klantinformatie kan ophalen.

Trigger voor caseopmerkingen: e-mailantwoorden voor Email-to-Case

Als je de trigger Salesforce Case Comment hebt ingeschakeld (automatisch antwoord van de agent op Service Cloud Cases), worden antwoorden op Cases met minstens één inkomende e-mail als een echte e-mail in dezelfde thread teruggestuurd naar de klant — niet alleen als interne Case Comment. Dit is gebaseerd op de vraag of de Case een inkomende e-mail heeft, niet op de waarde van de keuzelijst Origin van de Case. Daarom werkt dit ook goed als je org een aangepaste Origin-waarde gebruikt, zoals “Email - Returns”, in plaats van de letterlijke waarde “Email”. Cases zonder inkomende e-mail worden ongewijzigd als openbare Case Comment geplaatst. Alle adressen die in de oorspronkelijke e-mail van de klant in de CC staan, worden ook automatisch in de CC van het antwoord gezet, net zoals bij “Reply All” van een menselijke agent — met uitzondering van de Email-to-Case-routeringsadressen van je org. Die worden bewust niet in de CC gezet, zodat het antwoord niet opnieuw door Email-to-Case wordt verwerkt en de agent niet op zijn eigen bericht reageert.

Voor het versturen van e-mailantwoorden is extra configuratie nodig boven op wat alleen voor Case Comments vereist is:

• Het Profile of de Permission Set van de gebruiker bij Run As moet de systeemtoestemming Send Email hebben ingeschakeld (Setup > Users > Profiles, onder System Permissions), naast de toestemming API Enabled die al vereist is voor de integratie.
• De instelling Email Deliverability van je org (Setup > Email > Deliverability) moet externe e-mail toestaan — Sandboxes gebruiken standaard een beperkte instelling, die uitgaande e-mail stilzwijgend blokkeert.
• Als je wilt dat antwoorden vanaf een supportalias komen in plaats van vanuit de eigen mailbox van de gebruiker bij Run As, stel je het veld Org-Wide Email Address Id op de trigger in op de Id van een Organization-Wide Email Address (Setup > Organization-Wide Addresses > klik op het adres > kopieer de Id uit de URL). Laat dit leeg om vanaf het eigen adres van de gebruiker bij Run As te verzenden.
• Stel het veld Email-to-Case Routing Address(es) op de trigger in op de Email-to-Case-adressen van je org (door komma’s gescheiden als er meer dan één is, Setup > Email-to-Case). Zonder dit probeert de integratie het routeringsadres af te leiden uit de e-mail van de klant (het To-adres). Daardoor worden gevallen gemist waarin je routeringsadres alleen in de CC stond in plaats van de primaire ontvanger te zijn — het terug in de CC zetten bij een antwoord zou de agent in die situatie opnieuw op zijn eigen bericht laten reageren.

Als de org van een klant dit niet heeft geconfigureerd, wordt bij een fout tijdens het versturen van een e-mail teruggevallen op het plaatsen van een openbare Case Comment. Zo gaat een antwoord nooit stilzwijgend verloren — maar de klant ontvangt het pas per e-mail nadat je het bovenstaande hebt ingesteld.

Veiligheidsoverwegingen

• Gebruik HTTPS-endpoints voor alle API-aanroepen.
• Zorg dat de juiste beveiliging op veldniveau is geconfigureerd in Salesforce.
• De rechten van de gebruiker bij Run As bepalen tot welke gegevens de integratie toegang heeft — beperk deze passend.
• Controleer API-toegang en -gebruik regelmatig.

Handige links

• Salesforce REST API-documentatie
• Referentie voor de SOQL-querytaal
• External Client Apps en OAuth 2.0
• Best practices voor Salesforce-beveiliging