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.]
Gdy rozwiązanie Copilot w programie Outlook i aplikacji Sales są używane razem, podsumowania wiadomości e-mail wyświetlane w programie Outlook obejmują informacje o sprzedaży pochodzące z systemu zarządzania relacjami z klientami (CRM), takie jak Dynamics 365 lub Salesforce CRM. Możesz rozszerzyć możliwości podsumowania wiadomości e-mail, które aplikacja Sales oferuje, o wgląd z własnej aplikacji.
Notatka
Ten interfejs API zastępuje istniejący interfejs API Umiejętność podsumowania wiadomości e-mail (Id operacji: scp-get-email-insights) nową wersją.
Opis modelu API
Do akcji należy dodać następujący opis interfejsu API. Pomaga to aplikacji Sales zidentyfikować prawidłowy interfejs API do wywołania w celu wzbogacania możliwości.
Ta akcja powoduje pobranie dodatkowych informacji o sprzedaży, które będą wyświetlane w środowisku podsumowania wiadomości e-mail C4S w podsumowaniu programu Outlook. Akcja wzmacnia dotychczasowe funkcje Copilot dla działów sprzedaży.
Szczegóły API
- Nazwa interfejsu API: kwalifikacja podsumowania e-mail, wersja 2
- Identyfikator operacji Swagger: scp-get-email-insights-v2
- Metoda operacji Swagger: post
-
Ścieżka:
<PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2
Ładunek wejściowy
Ten ładunek jest przekazywany jako treść żądania interfejsu API.
| Nazwa/nazwisko | Typ danych | Wymagania | Szczegóły | Opis, który należy dodać w akcji |
|---|---|---|---|---|
| resourceData | Objekt | Tak | Dane zasobu, które mają zostać użyte do pobrania sugerowanej zawartości. Aby zapoznać się ze strukturą danych, przejdź do tematu Model danych poczty e-mail rozszerzalności. | Te dane wejściowe identyfikują zawartość wiadomości e-mail, która jest kolekcją wątku wiadomości e-mail, tematu i innych szczegółów. |
| relatedEntities (Jednostki pokrewne) | Tablica | Nie. | Tablica powiązanych encji. Aby zapoznać się ze strukturą danych, przejdź do Model danych powiązanej encji. | Te dane wejściowe identyfikują tablicę rekordów CRM, która jest powiązana z wątkiem wiadomości e-mail. |
| crmType | Sznurek | Nie. | Typ systemu CRM, jeśli jest połączony. Prawidłowe wartości to Salesforce i Dynamics 365 | Te dane wejściowe wskazują typ systemu CRM, w którym istnieje rekord powiązany z podsumowaną wiadomością e-mail. |
| crmOrgUrl | Sznurek | Nie. | Adres URL CRM organizacji. | Te dane wejściowe wskazują adres URL środowiska CRM, w którym istnieje rekord powiązany z podsumowaną wiadomością e-mail. |
| najpopularniejsze | Integer | Nie. | Liczba elementów do pobrania. | Te dane wejściowe wskazują liczbę szczegółowych informacji, które należy pobrać. |
| pominąć | Integer | Nie. | Liczba stron do pominięcia. | Te dane wejściowe wskazują liczbę elementów do pominięcia podczas pobierania najważniejszych informacji o sprzedaży. |
Model danych wiadomości e-mail rozszerzalności
| Właściwości | Typ | Szczegóły | Opis, który należy dodać w akcji |
|---|---|---|---|
| plaintextBody (Treść zwykłego tekstu) | Sznurek | Pełna treść wiadomości e-mail zawiera wszystkie poprzednie wiadomości z wątku wiadomości e-mail. | To wejście zawiera całą zawartość wątku wiadomości e-mail w formacie tekstowym. |
| fullHtmlBody | Sznurek | Pełna treść wiadomości e-mail zawiera wszystkie poprzednie wiadomości z wątku wiadomości e-mail. | To wejście zawiera całą zawartość wątku wiadomości e-mail w formacie tekstowym. |
| subject | Sznurek | Temat wiadomości e-mail. | Te dane wejściowe zawierają temat wiadomości e-mail. |
| from | Sznurek | Adres e-mail nadawcy. | Te dane wejściowe zawierają adres e-mail nadawcy. |
| to | Ciąg[] | Adres e-mail odbiorcy. | Te dane wejściowe zawierają adres e-mail odbiorcy. |
| DW | Ciąg[] | Adresy e-mail odbiorcy dodane w polu DW wiadomości e-mail. | To wejście zawiera wszystkie adresy e-mail odbiorcy, które znajdują się w polu DW wiadomości e-mail. |
| UDW | Ciąg[] | Adresy e-mail odbiorcy dodane w polu UDW wiadomości e-mail. | To wejście zawiera wszystkie adresy e-mail odbiorcy, które znajdują się w polu UDW wiadomości e-mail. |
| sentDateTime (data wysłania) | DateTimeOffset | Data i godzina wysłania wiadomości e-mail w formacie UTC wraz z właściwością Przesunięcie. Aby uzyskać więcej informacji, przejdź do DateTimeOffset Struct (System) | Te dane wejściowe zawierają sygnaturę czasową e-mail. |
| messageId | Sznurek | Identyfikator konwersacji wiadomości e-mail. | Te dane wejściowe zawierają identyfikator wiadomości e-mail. |
| conversationId (identyfikator rozmowy) | Sznurek | Identyfikator konwersacji wiadomości e-mail. | Te dane wejściowe zawierają identyfikator wątka e-mail. |
Model danych encji pokrewnych
| Właściwości | Typ | Wymagania | Szczegóły | Opis, który należy dodać w akcji |
|---|---|---|---|---|
| identyfikator jednostki | Sznurek | Tak | Typ rekordu CRM, taki jak klient lub szansa sprzedaży. | Te dane wejściowe podają unikatowy identyfikator rekordu CRM, który jest powiązany z podsumowaną wiadomością e-mail. |
| entityType | Sznurek | Tak | Unikatowy identyfikator rekordu CRM, który ma być używany dla sugerowanej zawartości. | Te dane wejściowe identyfikują typ rekordu w systemie CRM, która jest powiązana z podsumowaną wiadomością e-mail. |
| entitySource | Sznurek | Nie. | Te dane wejściowe wskazują źródło encji, które obecnie zawiera wartości "połączony" lub puste. | Te dane wejściowe wskazują typ źródła encji. |
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. Uwaga: Mimo że ten parametr zawiera listę środowisk, tylko pierwsze środowisko jest używane w podsumowaniu wzbogaconym e-mail dla środowiska kanwy w programie Outlook. |
| 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 |
|---|---|---|---|---|
| analiza | Sznurek | Tak | Informacje, które są dostarczane użytkownikom, takim jak Twoi koledzy – Mona Kane, Ray Tanaka i Daniela Smith – pracowali z nimi wcześniej. | Te dane wyjściowe wskazują tekst, który ma być dołączony do podsumowania wiadomości e-mail. |
Przykład
{
"value": [
{
"insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
},
{
"insight": "The email was opened three times in the last month."
}
],
"hasMoreResults": false
}
W przykładzie na poniższej ilustracji pokazano, jak dane wyjściowe interfejsu API są mapowane na podsumowanie wiadomości e-mail w okienku bocznym.
Legenda:
- Tytuł szczegółowych informacji. Szczegółowe informacje o tym samym tytule są grupowane razem.
- Opisy spostrzeżeń. Każde szczegółowe informacje mają opis.
W przykładzie na poniższej ilustracji pokazano, jak dane wyjściowe interfejsu API są mapowane na podsumowanie wiadomości e-mail w treści e-mail.
Legenda:
- Tytuł szczegółowych informacji. Szczegółowe informacje o tym samym tytule są grupowane razem.
- Opis szczegółowych informacji. Każde szczegółowe informacje mają opis.
Informacje pokrewne
Podsumowanie wątku wiadomości e-mail przy użyciu informacji o sprzedaży w funkcji Copilot w programie Outlook
Wzbogacanie analizy szans danymi z aplikacji
Wzbogacanie szczegółowych rekordów CRM dzięki szczegółowym informacjom z aplikacji użytkownika
Wzbogacanie podsumowania 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
Wzbogacanie podsumowania wiadomości e-mail o szczegółowe informacje ze swojej aplikacji
Kompilowanie rozszerzeń dla sprzedaży w rozwiązaniu Microsoft 365 Copilot