Wzbogać szczegóły rekordów CRM sprzedaży dzięki szczegółowym informacjom z aplikacji (wersja zapoznawcza)
Ważne
- Jest to gotowa do produkcji funkcja w wersji zapoznawczej.
- Gotowe do produkcji wersje zapoznawcze podlegają dodatkowym warunkom użytkowania.
[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 { |
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.
Legenda:
- Karta, na której są wyświetlane powiązane rekordy z aplikacji partnera.
- Ikona i tytuł karty. Ikona jest pobierana z metadanych łącznika Microsoft Power Platform. Tytuł jest nazwą łącznika Microsoft Power Platform.
- 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.
- 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.
- Dodatkowe właściwości powiązanego rekordu z odpowiedzi interfejsu API.
Informacje pokrewne
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)