Wzbogać podsumowanie wiadomości e-mail o szczegółowe informacje ze swojej 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.]
Gdy używasz Copilot dla działów sprzedaży do tworzenia wersji roboczej wiadomości e-mail, uwzględnia ona intencje wiadomości e-mail i używa informacji CRM z Salesforce lub Dynamics 365 do utworzenia wersji roboczej. Funkcje podsumowania wiadomości e-mail, które Copilot dla działów sprzedaży dostarcza ze szczegółowymi informacjami z aplikacji użytkownika można rozszerzyć za pomocą posiadanych aplikacji.
Notatka
Ta funkcja jest obsługiwana tylko w przypadku wersji roboczych wiadomości e-mail utworzonych przy użyciu okienka bocznego Copilot dla działów sprzedaży w programie Outlook.
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 plików związanych z konwersacją e-mail, które będą wyświetlane w wersjach roboczych wiadomości e-mail C4S w programie Outlook. Akcja wzmacnia dotychczasowe funkcje Copilot dla działów sprzedaży.
Działanie API
Ten interfejs API używa typu operacji: POST
Ładunek wejściowy
Ten ładunek jest przekazywany jako treść żądania interfejsu API.
| Nazwa/nazwisko | Typ danych | Wymagania | Details | 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. |
| resourceType | String | Tak | Typ zasobu, dla którego mają być pobierane sugestie dotyczące zawartości. Na przykład "e-mail-thread" lub "teams-chat". | To wejście identyfikuje typ zasobu udostępnionego do pobierania sugerowanych linków do plików, którym w tym przypadku jest "wątek poczty e-mail". |
| recordType | String | Nie. | Typ rekordu CRM, taki jak klient lub szansa sprzedaży. | Te dane wejściowe identyfikują typ rekordu w systemie CRM, która jest powiązana z podsumowaną wiadomością e-mail. |
| recordId | String | Nie. | Unikatowy identyfikator rekordu CRM, który ma być używany dla sugerowanej zawartości. | Te dane wejściowe podają unikatowy identyfikator rekordu CRM, który jest powiązany z podsumowaną wiadomością e-mail. |
| crmType | String | 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 | String | 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. |
| inputPrompt | String | Nie. | Aktualnie używany sugerowany monit podany przez użytkownika w celu wygenerowania wersji roboczej wiadomości e-mail. Na przykład "Odpowiedz na problem" lub "Złóż propozycję". | Te dane wejściowe wskazują monit podany przez użytkownika podczas tworzenia wersji roboczej 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ć. |
| skip | 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 | Type | Details | Opis, który należy dodać w akcji |
|---|---|---|---|
| plaintextBody (Treść zwykłego tekstu) | String | 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 | String | 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 | String | Temat wiadomości e-mail. | Te dane wejściowe zawierają temat wiadomości e-mail. |
| from | String | 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 odbiorców 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 odbiorców 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 | 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 | String | Identyfikator konwersacji wiadomości e-mail. | Te dane wejściowe zawierają identyfikator wiadomości e-mail. |
| conversationId | String | Identyfikator konwersacji wiadomości e-mail. | Te dane wejściowe zawierają identyfikator wątka e-mail. |
Parametry wyjściowe
| Właściwości | Typ danych | Wymagania | Details |
|---|---|---|---|
| value | Tablica | Tak | Lista linków do plików (obiektów) zdefiniowanych zgodnie z opisem w odpowiedzi Schemat sugestii zawartości pliku lub linku. |
| hasMoreResults | Wartość logiczna | Nie. | Wartość wskazująca, czy jest więcej dostępnych wyników. |
Schemat odpowiedzi na sugestie zawartości pliku lub linku
| Nazwa/nazwisko | Format typu danych | Wymagania | Details | Opis, który należy dodać w akcji |
|---|---|---|---|---|
| contentType | string | Tak | Typ zawartości komunikatu. Więcej informacji można znaleźć w artykule Wstępnie zdefiniowane wartości dla elementu contentType | Te dane wyjściowe wskazują typ zawartości dołączonej do wersji roboczej wiadomości e-mail. |
| content | string | Tak | Rzeczywista zawartość wliczona w cenę. Może to być strona internetowa lub adres URL pliku. | Te dane wyjściowe wskazują typ zawartości dołączonej do wersji roboczej wiadomości e-mail. Może to być strona internetowa lub adres URL pliku. |
| contentTitle | string | Tak | Tytuł sugerowanej zawartości wyświetlanej użytkownikowi. | Te dane wyjściowe wskazują tytuł zawartości. |
| contentDescription | string | Tak | Opis sugerowanej zawartości wyświetlanej użytkownikowi. | Te dane wyjściowe wskazują tekst, który ma zostać uwzględniony podczas opisywania plików. |
| contentIconUrl (adres URL ikony) | string | Nie. | Ikona sugerowanej zawartości wyświetlanej użytkownikowi. Jeśli nie zostanie podany, zostanie użyta ogólna ikona. | Te dane wyjściowe wskazują ikonę, która ma zostać dołączona do zawartości. |
| additionalProperties | Objekt | Nie. | Zestaw par nazw, które wskazują dodatkowe właściwości pokrewnych szczegółowych informacji zwracanych przez akcję. | Te dane wyjściowe wskazują dodatkowe właściwości jako pary nazwa-wartość każdego rekordu zwracanych przez akcję. |
Wstępnie zdefiniowane wartości parametru contentType
| Wartość ciągu | Typ zawartości |
|---|---|
| content-file | Plik zewnętrzny (ogólny) |
| content-web | Zewnętrzna witryna internetowa |
| content-doc | Dokument Microsoft Word |
| content-pdf | Dokument PDF Microsoft |
| content-pptx | Prezentacja programu Microsoft Powerpoint |
| content-xlsx | Microsoft Excel Arkusz kalkulacyjny |
Przykład
{
"value": [
{
"contentType": 0,
"content": "https://www.bing.com",
"contentTitle": "Purchase Contract",
"contentDescription": "Purchase Contract Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Logan Edwards",
"Sender Name": "Kenny Smith"
}
},
{
"contentType": 3,
"content": "https://www.microsoft.com",
"contentTitle": "Strategy Planning",
"contentDescription": "Strategy Planning Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Gabriela Edwards",
"Sender Name": "Maria Smith"
}
},
{
"contentType": 1,
"content": "https://www.bing.com",
"contentTitle": "Contoso Website",
"contentDescription": "Contoso Website Description",
"contentIconUrl": null,
"additionalProperties": {
"Total Views": "100",
"Domain": "Contoso.com"
}
}
],
"hasMoreResults": false
}
Na poniższym obrazie przedstawiono przykład mapowania danych wyjściowych API na wersji roboczej wiadomości e-mail.
Legenda:
- Linki do plików z aplikacji partnerskich.
Zobacz też
Podsumowanie wątku wiadomości e-mail przy użyciu informacji o sprzedaży w programie Copilot w programie Outlook
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)
Wzbogać szczegóły rekordów CRM dzięki szczegółowym informacjom z aplikacji
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)