Udostępnij za pośrednictwem


Wzbogać szczegóły rekordów CRM sprzedaży dzięki szczegółowym informacjom z aplikacji (wersja zapoznawcza)

Ważne

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Sprzedawcy mogą przeglądać szczegóły zapisanego kontaktu wraz z powiązanymi z nim rekordami, takimi jak konta i szanse sprzedaży. Możliwości szczegółów rekordów zarządzania relacjami z klientami (CRM), które zapewnia Copilot dla działów sprzedaży, można rozszerzyć o szczegółowe informacje z własnej aplikacji.

Opis modelu API

Do akcji należy dodać następujący opis interfejsu API. W ten sposób Copilot dla działów sprzedaży może zidentyfikować poprawny interfejs API, który musi zostać wywołany w celu wzbogacenia tej funkcji.

Ta akcja powoduje pobranie rekordów powiązanych z rekordem CRM. Akcja wzmacnia dotychczasowe funkcje Copilot dla działów sprzedaży.

Parametry wejściowe

Copilot dla działów sprzedaży został zaprojektowany w taki sposób, aby do interfejsów API dostarczał następujące parametry wejściowe.

Nazwa/nazwisko Typ danych / format Wymagania Details Opis, który należy dodać w akcji
recordType String Tak Typ encji lub obiektu w systemie CRM, dla którego są wymagane powiązane rekordy. Wartość zawiera niezależną od języka unikatową nazwę jednostki lub typu obiektu, a nie nazwę wyświetlaną, którą można zlokalizować. Przykłady obejmują klienta i szansę sprzedaży. Te dane wejściowe identyfikują typ rekordu w systemie CRM, dla których wymagane są powiązane rekordy.
recordId String Tak Identyfikator unikatowy rekordu CRM. Te dane wejściowe podają unikatowy identyfikator rekordu CRM, dla których wymagane są powiązane rekordy.
najpopularniejsze Integer Nie. Liczba działań do pobrania. Te dane wejściowe wskazują liczbę powiązanych rekordów, które należy pobrać.
skip Integer Nie. Liczba działań do pominięcia. Te dane wejściowe wskazują liczbę rekordów do pominięcia podczas pobierania powiązanych rekordów.
crmType String Nie. Typ systemu CRM. Prawidłowe wartości to Salesforce i Dynamics 365 Te dane wejściowe wskazują typ systemu CRM, z których są pobierane rekordy pokrewne.
crmOrgUrl String Nie. Nazwa hosta CRM organizacji, na przykład contoso.crm.dynamics.com. Te dane wejściowe wskazują adres URL środowiska CRM, z których są pobierane rekordy pokrewne.

Notatka

Ten punkt rozszerzenia obsługuje renderowanie wglądu w dane z maksymalnie pięciu rozszerzeń łącznika w panelu bocznym Outlook.

Parametry wyjściowe

Copilot dla działów sprzedaży oczekuje, że otrzyma listę szczegółowych informacji (obiektów) z interfejsów API i oczekuje, że każdy wgląd będzie miał określone parametry. Aby zapewnić Copilot dla działów sprzedaży dane wyjściowe poprawnie, kluczowe znaczenie ma zgodność ze wskazówkami podanymi w poniższej tabeli.

Parametr Typ danych Wymagania Details
value Tablica Tak Lista szczegółowych informacji (obiektów) zdefiniowanych zgodnie z opisem w sekcji Schemat szczegółowych informacji.
hasMoreResults Wartość logiczna Nie. Wartość wskazująca, czy jest więcej dostępnych wyników.

Schemat dla szczegółowych informacji

Nazwa/nazwisko Typ danych / format Wymagania Details Opis, który należy dodać w akcji
recordId String Tak Identyfikator unikatowy rekordu. Te dane wyjściowe w sposób unikatowy identyfikują każdy rekord pokrewny zwrócony przez akcję.
recordTypeDisplayName String Tak Nazwa wyświetlana typu rekordu, na przykład Kontrakt. Powinien być zlokalizowany w języku określonym w nagłówku Accept-Language. Te dane wyjściowe wskazują wyświetlaną nazwę typ rekordu z każdego rekordu pokrewnego zwróconego przez akcję.
recordTypePluralDisplayName String Tak Liczba mnoga nazwy wyświetlanej typu rekordu, na przykład Kontrakty. Powinien być zlokalizowany w języku określonym w nagłówku Accept-Language. Te dane wyjściowe wskazują wyświetlaną nazwę typ rekordu w liczbie mnogiej z każdego rekordu pokrewnego zwróconego przez akcję.
recordType String Tak Nazwa systemowa typu rekordu, na przykład contrakt. Te dane wyjściowe wskazują typ każdego rekordu pokrewnego zwróconego przez akcję.
recordTitle String Tak Nazwa rekordu, na przykład Odnowienie umowy z Contoso 2023. Te dane wyjściowe wskazują tytuł każdego rekordu pokrewnego zwróconego przez akcję.
adres URL String Nie. Prawidłowy adres URL w celu otwarcia rekordu aplikacji partnerskiej. Te dane wyjściowe wskazują adres URL każdego rekordu pokrewnego zwróconego przez akcję.
additionalProperties Obiekt, który ma wartości Nazwa właściwości i Wartość właściwości typu Ciąg znaków Nie.

Dodatkowe właściwości, które są wyświetlane w widoku szczegółowym. Nazwy i wartości właściwości są w języku naturalnym w języku określonym w nagłówku Accept-Language. Oto przykład.

{
„Przyczyna stanu”: „Podpisano”,
"Właściciel": "Kenny Smith"
}
Te dane wyjściowe wskazują dodatkowe właściwości jako pary nazwa-wartość każdego rekordu zwracanych przez akcję.

Przykład

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

Przykład na poniższym obrazie przedstawia sposób mapowania danych wyjściowych API na powiązane rekordy.

Zrzut ekranu przedstawiający strukturę powiązanych rekordów z aplikacji partnera.

Legenda:

  1. Karta, na której są wyświetlane powiązane rekordy z aplikacji partnera.
  2. Ikona i tytuł karty. Ikona jest pobierana z metadanych łącznika Microsoft Power Platform. Tytuł jest nazwą łącznika Microsoft Power Platform.
  3. Powiązane tytuły rekordów z odpowiedzi interfejsu API. Dwie dodatkowe właściwości z odpowiedzi interfejsu API są renderowane jako pola kluczowe każdego powiązanego rekordu.
  4. Przycisk "Więcej akcji", którego można użyć do skopiowania linku do rekordu lub do wyświetlenia szczegółów rekordu w aplikacji partnerskiej. Link jest oparty na adresie URL powiązanego rekordu w odpowiedzi interfejsu API.
  5. Dodatkowe właściwości powiązanego rekordu z odpowiedzi interfejsu API.

Wyświetlanie szczegółów rekordu
Dodawanie nowych możliwości pytań i odpowiedzi do czatu sprzedaży
Wzbogać podsumowanie wiadomości e-mail o szczegółowe informacje ze swojej aplikacji
Wzbogać kluczowe informacje o sprzedaży dzięki szczegółowym informacjom z aplikacji (wersja zapoznawcza)
Wzbogacanie podsumowania rekordów CRM dzięki szczegółowym informacjom z aplikacji użytkownika
Rozszerzanie Microsoft 365 Copilot dla działów sprzedaży za pomocą aplikacji partnerskich
Tworzenie rozszerzeń Copilot dla działów sprzedaży (wersja zapoznawcza)