Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.]
Aby lepiej zrozumieć kontekst spotkania, do którego się przygotowują, lub wiadomości e-mail, którą czytają, sprzedawcy potrzebują odpowiednich informacji dotyczących zarządzania relacjami z klientami (CRM), takich jak zapytania, wątpliwości i uwagi klientów. Aplikacja Sales używa sztucznej inteligencji do generowania podsumowania każdego rekordu CRM. To podsumowanie podkreśla kluczowe szczegóły, takie jak etap sprzedaży, budżet i przewidywana data zamknięcia. Możesz rozszerzyć funkcję podsumowania rekordów CRM, którą zapewnia aplikacja Sales, o wnioski z Twojej własnej aplikacji.
Opis modelu API
Do akcji należy dodać następujący opis interfejsu API. W ten sposób aplikacja Sales może zidentyfikować prawidłowy interfejs API, który należy wywołać, aby wzbogacić możliwości.
Ta akcja powoduje pobranie dodatkowych informacji o sprzedaży związanych z rekordem CRM, które będą wyświetlane na karcie podsumowania rekordu C4S. Akcja wzmacnia dotychczasowe funkcje Copilot dla działów sprzedaży.
Działanie API
Ten interfejs API używa typu operacji: GET
Parametry wejściowe
Aplikacja Sales została zaprojektowana w celu zapewnienia następujących parametrów wejściowych interfejsom API.
| Nazwa/nazwisko | Typ danych / format | Wymagania | Szczegóły | Opis, który należy dodać w akcji |
|---|---|---|---|---|
| typ rekordu | Sznurek | Tak | Typ encji lub obiektu w systemie CRM, dla którego są wymagane powiązane dane szczegółowe, takie jak działania. 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 wskazują typ encji lub obiektu w systemie CRM, dla którego są wymagane informacje szczegółowe. |
| recordId (identyfikator rekordu) | Sznurek | Tak | Identyfikator unikatowy rekordu CRM. | Te dane wejściowe wskazują unikatowy identyfikator rekordu CRM, dla których wymagane są szczegółowe informacje. |
| startDateTime | Ciąg w formacie daty i godziny | Nie. | Data i godzina rozpoczęcia wyszukiwania szczegółowych informacji. Format jest zgodny ze specyfikacją OpenAPI. Oto przykład: 2017-07-21T17:32:28Z. | Te dane wejściowe wskazują datę i czas rozpoczęcia wymaganych szczegółowych informacji. |
| endDateTime | Ciąg w formacie daty i godziny | Nie. | Data i godzina zakończenia wyszukiwania szczegółowych informacji. Format jest zgodny ze specyfikacją OpenAPI. Oto przykład: 2017-07-21T17:32:28Z. | Te dane wejściowe wskazują datę i czas zakończenia wymaganych szczegółowych informacji. |
| najpopularniejsze | Integer | Nie. | Liczba szczegółowych informacji do pobrania. | Te dane wejściowe wskazują liczbę szczegółowych informacji, które należy pobrać. |
| pominąć | Integer | Nie. | Liczba szczegółowych informacji do pominięcia. | Te dane wejściowe wskazują liczbę szczegółowych informacji, które należy pominąć. |
| crmType | Sznurek | Nie. | Prawidłowe wartości to Salesforce i Dynamics 365 | Te dane wejściowe wskazują typ systemu CRM, w którym istnieje rekord programu CRM, dla którego wymagane są szczegółowe informacje. |
| crmOrgUrl | Sznurek | Nie. | Nazwa hosta CRM organizacji, na przykład contoso.crm.dynamics.com. | Te dane wejściowe wskazują adres URL środowiska CRM, w którym istnieje rekord programu CRM, dla którego wymagane są szczegółowe informacje. |
Parametry wyjściowe
Aplikacja Sales oczekuje, że otrzyma listę szczegółowych informacji (obiektów) z interfejsów API, a każda szczegółowa informacja będzie miała określone parametry. Aby upewnić się, że aplikacja Sales może poprawnie przeanalizować dane wyjściowe, struktura odpowiedzi musi być zgodna z wytycznymi w poniższej tabeli.
| Parametr | Typ danych | Wymagania | Szczegóły |
|---|---|---|---|
| value | Tablica | Tak | Lista szczegółowych informacji (obiektów) zdefiniowanych zgodnie z opisem w sekcji Schemat szczegółowych informacji. |
| maWięcejWyników | logiczny | Nie. | Wartość wskazująca, czy jest więcej dostępnych wyników. |
Schemat dla szczegółowych informacji
| Nazwa/nazwisko | Typ danych / format | Wymagania | Szczegóły | Opis, który należy dodać w akcji |
|---|---|---|---|---|
| tytuł | Sznurek | Tak | Tytuł szczegółowych informacji na karcie odwołania. Jest to tytuł w języku naturalnym dla szczegółowych informacji w języku określonym w nagłówku żądania Accept-Language. Oto przykład: Umowa podpisana. |
Te dane wyjściowe wskazują tytuł działania na karcie odwołania. |
| description | Sznurek | Tak | Opis szczegółowych informacji. Jest on wyświetlany jako wypunktowanie w podsumowaniu rekordu i jest opisem szczegółowych informacji w języku naturalnym w języku określonym w nagłówku Accept-Language. Oto przykład: Kenny, Logan i dwie inne osoby podpisały odnowienie umowy z Contoso 2023 w dniu 07.09.2023 r. |
Te dane wyjściowe wskazują opis szczegółowych informacji. |
| Data i godzina | Ciąg w formacie daty i godziny | Tak | Data i godzina aktywności w tej lokalizacji w formacie UTC. Jeśli działanie ma zarówno godzinę rozpoczęcia, jak i godzinę zakończenia, aplikacja musi określić, która godzina ma być wyświetlana. Format jest zgodny ze specyfikacją OpenAPI. Oto przykład: 2017-07-21T17:32:28Z. | Te dane wyjściowe oznaczają czas skojarzony ze szczegółowymi informacjami. |
| adres URL | Sznurek | Nie. | Prawidłowy adres URL w celu otwarcia działania w aplikacji partnera. | Te dane wyjściowe wskazują adres URL w celu otwarcia szczegółowych informacji. |
| dodatkowe właściwości | 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 wyświetlane w szczegółowym widoku analizy. |
Notatka
Choć wymagania interfejsu API dotyczące rozszerzania funkcji podsumowania wiadomości e-mail i podsumowania rekordów mogą wyglądać podobnie, muszą zostać dodane jako oddzielne akcje w łączniku.
Przykład
{
"value": [
{
"title": "Contract signed",
"description": "You have 5 connections in Fourth Coffee Inc",
"dateTime": "2024-05-07T03:28:38.0667701Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
},
{
"title": "Contract signed",
"description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
"dateTime": "2024-05-07T03:28:38.0669445Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
}
],
"hasMoreResults": false
}
Na poniższym obrazie przedstawiono przykład mapowania danych wyjściowych API na podsumowanie rekordu.
Legenda:
- Sekcja pokazująca szczegółowe informacje z aplikacji partnerskiej. Tytuł sekcji jest uzyskiwany z nazwy łącznika Microsoft Power Platform.
- Opisy (szczegółowych informacji) w odpowiedzi interfejsu API.
- Numery cytowań, które można wybrać, aby wyświetlić szczegóły szczegółowych informacjach.
- Karta odwołania przedstawiająca szczegóły szczegółowych informacji.
- Ikona i tytuł szczegółowych informacji. Ikona jest pobierana z metadanych łącznika Microsoft Power Platform. Tekst tytułu to tytuł szczegółowych informacji z odpowiedzi interfejsu API.
- Dodatkowe właściwości szczegółowych informacji z odpowiedzi interfejsu API.
- Nazwa aplikacji partnera. Wyświetlana nazwa jest nazwą łącznika Microsoft Power Platform.
- Łącze, które można wybrać, aby wyświetlić szczegóły szczegółowych informacji w aplikacji partnera. Jest ono oparte na adresie URL odpowiedzi interfejsu API.
Informacje pokrewne
Wyświetl podsumowanie rekordu
Wzbogać podsumowanie wiadomości e-mail o szczegółowe informacje ze swojej aplikacji
Wzbogacanie podsumowania wiadomości e-mail o szczegółowe informacje ze swojej aplikacji
Wzbogacanie analizy szans danymi z aplikacji
Wzbogacanie szczegółowych rekordów CRM dzięki szczegółowym informacjom z aplikacji użytkownika
Rozszerzanie sprzedaży na platformie Microsoft 365 Copilot przy użyciu aplikacji partnerskich
Kompilowanie rozszerzeń dla sprzedaży w rozwiązaniu Microsoft 365 Copilot