Udostępnij przez


Wzbogacanie podsumowania rekordów CRM dzięki szczegółowym informacjom z aplikacji użytkownika (wersja zapoznawcza)

Ważne

[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 Accept-Language. Oto przykład.

{
„Przyczyna stanu”: „Podpisano”,
"Właściciel": "Kenny Smith"
}
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.

Zrzut ekranu przedstawiający strukturę najnowszych działań z aplikacji partnera.

Legenda:

  1. Sekcja pokazująca szczegółowe informacje z aplikacji partnerskiej. Tytuł sekcji jest uzyskiwany z nazwy łącznika Microsoft Power Platform.
  2. Opisy (szczegółowych informacji) w odpowiedzi interfejsu API.
  3. Numery cytowań, które można wybrać, aby wyświetlić szczegóły szczegółowych informacjach.
  4. Karta odwołania przedstawiająca szczegóły szczegółowych informacji.
  5. 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.
  6. Dodatkowe właściwości szczegółowych informacji z odpowiedzi interfejsu API.
  7. Nazwa aplikacji partnera. Wyświetlana nazwa jest nazwą łącznika Microsoft Power Platform.
  8. Łą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.

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