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

Ważna

[Ten artykuł to dokumentacja wstępna, która 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. Agent sales używa sztucznej inteligencji do wygenerowania 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ć możliwości podsumowania rekordów CRM, które zapewnia agent sprzedaży, wnioskami z własnej aplikacji.

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

Wprowadź parametry

Agent Sales jest przeznaczony do udostępniania następujących parametrów wejściowych interfejsom API.

Nazwa Typ/format danych Wymagania Szczegóły Opis, który należy dodać w akcji
typ rekordu String Yes 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) String Yes 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 No Data i godzina rozpoczęcia wyszukiwania szczegółowych informacji. Format jest zgodny ze specyfikacją interfejsu 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 No Data i godzina zakończenia wyszukiwania szczegółowych informacji. Format jest zgodny ze specyfikacją interfejsu OpenAPI. Oto przykład: 2017-07-21T17:32:28Z. Te dane wejściowe wskazują datę i czas zakończenia wymaganych szczegółowych informacji.
top Liczba całkowita No Liczba szczegółowych informacji do pobrania. Te dane wejściowe wskazują liczbę szczegółowych informacji, które należy pobrać.
pominąć Liczba całkowita No Liczba szczegółowych informacji do pominięcia. Te dane wejściowe wskazują liczbę szczegółowych informacji, które należy pominąć.
crmType String No 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 String No 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

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 .
maWięcejWyników logiczny No Wartość wskazująca, czy są dostępne więcej wyników.

Schemat dla szczegółowych informacji

Nazwa Typ danych / format Wymagania Szczegóły Opis, który należy dodać w akcji
tytuł String Yes 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.
opis String Yes 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 Yes Data i godzina działania w formacie UTC. Jeśli działanie ma zarówno godzinę rozpoczęcia, jak i godzinę zakończenia, aplikacja musi określić czas wyświetlania. Format jest zgodny ze specyfikacją interfejsu OpenAPI. Oto przykład: 2017-07-21T17:32:28Z. Ten wynik wskazuje czas związany ze spostrzeżeniem.
Adres URL String No 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.
additionalProperties Obiekt, który ma wartości Nazwa właściwości i Wartość właściwości typu Ciąg No

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.

Note

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.

Example

{
    "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 przedstawiająca szczegółowe informacje z aplikacji partnera. Tytuł sekcji pochodzi od nazwy łącznika platformy Microsoft Power Platform.
  2. Opisy wniosków z 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ł analizy. 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 partnerskiej. Wyświetlana nazwa to nazwa łącznika platformy Microsoft Power Platform.
  8. Link umożliwiający wyświetlenie szczegółów analizy w aplikacji partnera. Jest ono oparte na adresie URL odpowiedzi interfejsu API.

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