Wzbogać podsumowanie wiadomości e-mail o szczegółowe informacje ze swojej aplikacji (wersja zapoznawcza)

Ważna

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

Gdy używasz agenta sprzedaży do tworzenia wersji roboczej wiadomości e-mail, uwzględnia intencję wiadomości e-mail i używa informacji CRM z usługi Salesforce lub Dynamics 365 do utworzenia wersji roboczej. Możesz rozszerzyć funkcję tworzenia wiadomości e-mail, którą oferuje agent sprzedaży, o zalecane pliki z własnej aplikacji.

Note

Ta funkcja jest obsługiwana tylko w przypadku wersji roboczych wiadomości e-mail utworzonych przy użyciu agenta sprzedaży w programie Outlook.

Opis interfejsu API

Do akcji należy dodać następujący opis interfejsu API. W ten sposób agent sprzedaży może zidentyfikować prawidłowy interfejs API, który należy wywołać, aby wzbogacić możliwości.

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 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.
resourceType String Yes 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".
typ rekordu String No 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 (identyfikator rekordu) String No 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 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.
inputPrompt String No 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.
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 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 String[] 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 (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.

Parametry wyjściowe

Majątek Typ danych Wymagania Szczegóły
wartość Array Yes Lista linków do plików (obiektów) zdefiniowanych zgodnie z opisem w odpowiedzi Schemat sugestii zawartości pliku lub linku.
maWięcejWyników logiczny No Wartość wskazująca, czy są dostępne więcej wyników.

Schemat odpowiedzi na sugestie zawartości pliku lub linku

Nazwa Format typu danych Wymagania Szczegóły Opis, który należy dodać w akcji
typ treści ciąg Yes 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.
zawartość ciąg Yes 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 ciąg Yes Tytuł sugerowanej zawartości wyświetlanej użytkownikowi. Te dane wyjściowe wskazują tytuł zawartości.
contentDescription ciąg Yes 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) ciąg No 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 Object No 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 programu Microsoft Word
content-pdf Dokument PDF Microsoft
content-pptx Prezentacja programu Microsoft PowerPoint
content-xlsx Arkusz kalkulacyjny programu Microsoft Excel

Example

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

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

Legenda:

  1. Linki do plików z aplikacji partnerskich.

Zobacz także

Podsumuj wątek wiadomości e-mail, używając informacji o sprzedaży za pomocą Copilot w Outlook
Wzbogacanie podsumowań wiadomości e-mail za pomocą szczegółowych informacji z aplikacji
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
Kompilowanie rozszerzeń dla agenta sprzedaży

  • Last updated on