Wzbogacanie podsumowania wiadomości e-mail o sugestie zawartości z aplikacji (wersja zapoznawcza)

Ważna

[Ten artykuł to dokumentacja wstępna, która może ulec zmianie].

Gdy rozwiązanie Copilot w programie Outlook i agencie sprzedaży 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 agent sprzedaży zapewnia, korzystając z danych z Twojej własnej aplikacji.

Note

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 interfejsu API

Do akcji należy dodać następujący opis interfejsu API. Ułatwia to agentowi sprzedaży zidentyfikowanie poprawnego interfejsu 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 for Sales.

Szczegóły interfejsu 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 Typ danych Wymagania Szczegóły Opis, który należy dodać w akcji
resourceData Object Yes 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) Array No 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 String No 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 No Adres URL organizacji CRM. Te dane wejściowe wskazują adres URL środowiska CRM, w którym istnieje rekord powiązany z podsumowaną wiadomością e-mail.
top Liczba całkowita No Liczba elementów do pobrania. Te dane wejściowe wskazują liczbę szczegółowych informacji, które należy pobrać.
pominąć Liczba całkowita No 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

Majątek Typ Szczegóły 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.
od String Adres e-mail nadawcy. Te dane wejściowe zawierają adres e-mail nadawcy.
to String[] Adres e-mail odbiorcy. Te dane wejściowe zawierają adres e-mail odbiorcy.
DW String[] 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 String[] 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 String Identyfikator konwersacji wiadomości e-mail. Te dane wejściowe zawierają identyfikator wiadomości e-mail.
conversationId (identyfikator rozmowy) String Identyfikator konwersacji wiadomości e-mail. Te dane wejściowe zawierają identyfikator wątka e-mail.
Majątek Typ Wymagania Szczegóły Opis, który należy dodać w akcji
entityId String Yes 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 String Yes 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 String No 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

Agent sprzedaży oczekuje, że otrzyma listę informacji (obiektów) z API i oczekuje, że każda z tych informacji będzie miała określone parametry. Aby upewnić się, że agent 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
wartość Array Yes

Lista szczegółowych informacji (obiektów), które są zdefiniowane zgodnie z opisem w sekcji Schemat dla 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 No Wartość wskazująca, czy są dostępne więcej wyników.

Schemat dla szczegółowych informacji

Nazwa Typ/format danych Wymagania Szczegóły Opis, który należy dodać w akcji
analiza String Yes 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.

Example

{
    "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.

Zrzut ekranu przedstawiający szczegółowe informacje z aplikacji partnerskich w podsumowaniu wiadomości e-mail.

Legenda:

  1. Tytuł szczegółowych informacji. Szczegółowe informacje o tym samym tytule są grupowane razem.
  2. 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.

Zrzut ekranu przedstawiający spostrzeżenia z aplikacji partnerskich w treści wiadomości e-mail.

Legenda:

  1. Tytuł szczegółowych informacji. Szczegółowe informacje o tym samym tytule są grupowane razem.
  2. Opis szczegółowych informacji. Każde szczegółowe informacje mają opis.

Podsumuj wątek wiadomości e-mail, używając informacji o sprzedaży za pomocą Copilot w Outlook
Wzbogacanie analizy szans danymi z aplikacji
Wzbogać szczegóły rekordów CRM dzięki szczegółowym informacjom z aplikacji
Wzbogacanie podsumowań rekordów CRM za pomocą szczegółowych informacji z aplikacji
Rozszerzanie agenta sprzedaży przy użyciu aplikacji partnerskich
Wzbogacanie wersji roboczych wiadomości e-mail przy użyciu linków do plików z aplikacji
Kompilowanie rozszerzeń dla agenta sprzedaży

  • Last updated on