Salesforce

Omówienie

Połącz agentów AI ElevenLabs z Salesforce CRM, aby uzyskać dostęp do danych klientów, zarządzać leadami i tworzyć szanse sprzedażowe. Ta integracja pozwala agentom pobierać istniejące rekordy klientów, tworzyć nowe leady i kontakty oraz wysyłać zapytania do obiektów Salesforce podczas rozmów.

Możliwości

Konfiguracja

Ta integracja używa do uwierzytelniania Salesforce OAuth 2.0 Client Credentials. Musisz utworzyć w Salesforce External Client App.

Film demonstracyjny

Jak to działa

Konfiguracja narzędzi

Dostępne są trzy narzędzia webhook: salesforce_search_records, salesforce_get_record i salesforce_create_record. Skonfiguruj autoryzację każdego z nich za pomocą Workplace Auth Connection.

Autoryzacja — połączenie Workplace OAuth2

{
  "grant_type": "client_credentials"
}

Konfiguracje narzędzi webhook

Dodaj Workplace Auth Connection (OAuth2) do każdego narzędzia w sekcji Authentication. Skorzystaj z poniższych kart, aby sprawdzić konfigurację każdego narzędzia.

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

Popularne obiekty Salesforce

Typowe zapytania SOQL

Użyj tych zapytań SOQL jako punktu wyjścia przy dostosowywaniu promptu systemowego agenta. Wszystkie zapytania zwracają informacje czytelne dla człowieka, a nie techniczne identyfikatory:

Wyszukiwanie kontaktów po adresie e-mail

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

Wyszukiwanie leadów po adresie e-mail lub numerze telefonu

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

Wyszukiwanie kont po nazwie

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

Wyszukiwanie ostatnich szans sprzedaży

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

Wyszukiwanie szans sprzedaży według konta

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

Testowanie integracji

Po skonfigurowaniu External Client App i połączeniu integracji przetestuj ją przed wdrożeniem na produkcji:

1. Wyszukiwanie: Poproś agenta o wyszukanie istniejących kontaktów.
2. Tworzenie rekordów: Niech agent utworzy nowego leada lub kontakt.
3. Pobieranie danych: Sprawdź, czy agent może pobierać szczegółowe informacje o kliencie.

Wyzwalacz komentarza do sprawy: odpowiedzi e-mail dla Email-to-Case

Jeśli włączono wyzwalacz Salesforce Case Comment (automatyczną odpowiedź agenta na sprawy Service Cloud), odpowiedzi na sprawy z co najmniej jedną przychodzącą wiadomością e-mail są wysyłane do klienta jako prawdziwe wiadomości e-mail w tym samym wątku — a nie tylko jako wewnętrzny komentarz do sprawy. Zależy to od tego, czy sprawa ma przychodzącą wiadomość e-mail, a nie od wartości listy wyboru Origin sprawy. Dlatego działa poprawnie również wtedy, gdy organizacja używa własnej wartości Origin, takiej jak „Email - Returns”, zamiast dosłownego „Email”. Sprawy bez przychodzącej wiadomości e-mail nadal są publikowane jako publiczny komentarz do sprawy, bez zmian. Wszystkie adresy dodane do DW w oryginalnej wiadomości klienta są też automatycznie dodawane do DW odpowiedzi, tak jak przy opcji „Odpowiedz wszystkim” użytej przez ludzkiego agenta — z wyjątkiem adresów routingu Email-to-Case organizacji, które są celowo wykluczone z DW, aby odpowiedź nie została ponownie pobrana przez Email-to-Case i nie uruchomiła agenta na jego własnej wiadomości.

Wysyłanie odpowiedzi e-mail wymaga dodatkowej konfiguracji poza tą potrzebną tylko do komentarzy do spraw:

• Profil lub Permission Set użytkownika Run As musi mieć włączone uprawnienie systemowe Send Email (Setup > Users > Profiles, w sekcji System Permissions), oprócz uprawnienia API Enabled, które jest już wymagane przez integrację.
• Ustawienie Email Deliverability organizacji (Setup > Email > Deliverability) musi zezwalać na zewnętrzną pocztę e-mail — środowiska Sandbox mają domyślnie ograniczone ustawienie, które po cichu blokuje wychodzącą pocztę.
• Jeśli odpowiedzi mają być wysyłane z aliasu wsparcia zamiast z własnej skrzynki użytkownika Run As, ustaw w wyzwalaczu pole Org-Wide Email Address Id na Id Organization-Wide Email Address (Setup > Organization-Wide Addresses > kliknij adres > skopiuj Id z URL). Pozostaw je puste, aby wysyłać z własnego adresu użytkownika Run As.
• Ustaw w wyzwalaczu pole Email-to-Case Routing Address(es) na adresy Email-to-Case organizacji (oddzielone przecinkami, jeśli jest ich więcej niż jeden, Setup > Email-to-Case). Bez tego integracja próbuje odgadnąć adres routingu na podstawie wiadomości klienta (jej adresu To), co nie uwzględnia przypadków, w których adres routingu był dodany tylko do DW, a nie był głównym odbiorcą — dodanie go ponownie do DW w odpowiedzi w takiej sytuacji uruchomiłoby agenta na jego własnej wiadomości.

Jeśli organizacja klienta nie ma tego skonfigurowanego, błąd wysyłania e-maila powoduje publikację publicznego komentarza do sprawy, więc odpowiedź nigdy nie zniknie bez śladu — ale klient nie otrzyma jej e-mailem, dopóki powyższe ustawienia nie zostaną skonfigurowane.

Kwestie bezpieczeństwa

• Używaj endpointów HTTPS dla wszystkich wywołań API.
• Upewnij się, że w Salesforce skonfigurowano odpowiednie zabezpieczenia na poziomie pól.
• Uprawnienia użytkownika Run As określają, do jakich danych ma dostęp integracja — odpowiednio je ogranicz.
• Regularnie audytuj dostęp do API i jego użycie.

Przydatne linki

• Dokumentacja Salesforce REST API
• Dokumentacja języka zapytań SOQL
• External Client Apps i OAuth 2.0
• Najlepsze praktyki bezpieczeństwa Salesforce