Salesforce

Översikt

Anslut dina AI-agenter från ElevenLabs till Salesforce CRM för att komma åt kunddata, hantera leads och skapa affärsmöjligheter. Integrationen gör det möjligt för dina agenter att hämta befintliga kundposter, skapa nya leads och kontakter samt fråga Salesforce-objekt under konversationer.

Funktioner

Konfiguration

Den här integrationen använder Salesforce OAuth 2.0 Client Credentials för autentisering. Du behöver skapa en External Client App i Salesforce.

Demovideo

Så fungerar det

Verktygskonfigurationer

Tre webhook-verktyg är tillgängliga: salesforce_search_records, salesforce_get_record och salesforce_create_record. Konfigurera auktorisering för vart och ett med en Workplace Auth Connection.

Auktorisering – Workplace OAuth2-anslutning

{
  "grant_type": "client_credentials"
}

Konfigurationer för webhook-verktyg

Lägg till en Workplace Auth Connection (OAuth2) till varje verktyg i avsnittet Authentication. Använd flikarna nedan för att granska konfigurationen för varje verktyg.

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

Vanliga Salesforce-objekt

Vanliga SOQL-frågor

Använd dessa SOQL-frågor som utgångspunkt när du anpassar agentens systemprompt. Alla frågor returnerar lättläst information i stället för tekniska ID:n:

Sök efter kontakter via e-post

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

Sök efter leads via e-post eller telefon

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

Sök efter konton via namn

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

Sök efter senaste affärsmöjligheter

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

Sök efter affärsmöjligheter via konto

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

Testa integrationen

När du har konfigurerat din External Client App och anslutit integrationen bör du testa den innan du driftsätter i produktion:

1. Sökfunktion: Be agenten söka efter befintliga kontakter.
2. Skapa poster: Låt agenten skapa ett nytt lead eller en ny kontakt.
3. Hämta data: Kontrollera att agenten kan hämta detaljerad kundinformation.

Utlösare för ärendekommentarer: e-postsvar för Email-to-Case

Om du har aktiverat utlösaren Salesforce Case Comment (automatiskt agentsvar på Service Cloud Cases) skickas svar på Cases med minst ett inkommande e-postmeddelande tillbaka till kunden som ett riktigt e-postmeddelande i samma tråd — inte bara som en intern Case Comment. Detta baseras på om Case har ett inkommande e-postmeddelande, inte på Casets picklist-värde Origin, så det fungerar fortfarande korrekt om din organisation använder ett anpassat Origin-värde som “Email - Returns” i stället för det exakta “Email”. Cases utan inkommande e-postmeddelanden publiceras fortfarande som en offentlig Case Comment, utan ändringar. Alla adresser som har CC:ats i kundens ursprungliga e-postmeddelande CC:as också automatiskt i svaret, precis som en mänsklig agents “Reply All” skulle fungera — förutom din organisations Email-to-Case-routningsadress(er), som medvetet undantas från CC så att svaret inte tas in på nytt av Email-to-Case och utlöser agenten för dess eget meddelande.

Att skicka e-postsvar kräver ytterligare konfiguration utöver den som behövs enbart för Case Comments:

• Användarens profil eller Permission Set i Run As måste ha systembehörigheten Send Email aktiverad (Setup > Users > Profiles, under System Permissions), utöver behörigheten API Enabled som redan krävs för integrationen.
• Organisationens inställning för Email Deliverability (Setup > Email > Deliverability) måste tillåta extern e-post — Sandboxes har som standard en begränsad inställning som tyst blockerar utgående e-post.
• Om du vill att svar ska skickas från ett supportalias i stället för Run As-användarens egen inkorg anger du fältet Org-Wide Email Address Id på utlösaren till Id för en Organization-Wide Email Address (Setup > Organization-Wide Addresses > klicka på adressen > kopiera Id från URL:en). Lämna det tomt för att skicka från Run As-användarens egen adress.
• Ange fältet Email-to-Case Routing Address(es) på utlösaren till organisationens Email-to-Case-adress(er) (kommaseparerade om det finns fler än en, Setup > Email-to-Case). Utan detta försöker integrationen gissa routningsadressen utifrån kundens e-postmeddelande (dess To-adress), vilket missar fall där routningsadressen endast var CC:ad och inte primär mottagare — att CC:a tillbaka den i ett svar i den situationen skulle utlösa agenten för dess eget meddelande.

Om en kunds organisation inte har detta konfigurerat återgår ett misslyckat e-postutskick till att publicera en offentlig Case Comment, så ett svar aldrig tyst tappas — men kunden får det inte via e-post förrän ovanstående har konfigurerats.

Säkerhetsaspekter

• Använd HTTPS-slutpunkter för alla API-anrop.
• Se till att korrekt säkerhet på fältnivå är konfigurerad i Salesforce.
• Behörigheterna för användaren i Run As avgör vilka data integrationen kan komma åt — begränsa dem på lämpligt sätt.
• Granska regelbundet API-åtkomst och användning.

Användbara länkar

• Salesforce REST API-dokumentation
• Referens för SOQL-frågespråket
• External Client Apps och OAuth 2.0
• Bästa praxis för Salesforce-säkerhet